Metabase で Acumatica のデータを連携利用する方法
Metabase は、インタラクティブなダッシュボードを作成できるオープンソースのデータ可視化ツールです。CData Connect AI と組み合わせることで、リアルタイムのAcumatica のデータにリンクされたビジュアライゼーションやダッシュボードを簡単に作成できます。この記事では、Acumatica に接続し、Acumatica のデータ を使用してシンプルなビジュアライゼーションを構築する方法を説明します。
CData Connect は Acumatica 専用のクラウド間インターフェースを提供し、データをレプリケートすることなく、Metabase でリアルタイムのAcumatica のデータを簡単に連携できます。Connect はMetabase からSQL Server データベースと同じように見え、最適化されたデータ処理を標準で使用して、サポートされているすべてのSQL 操作（フィルター、JOIN など）を Acumatica に直接プッシュし、サーバーサイド処理を活用してAcumatica のデータを迅速に返します。
Metabase 用に Acumatica への接続を設定
Metabase から Acumatica への接続は、CData Connect AI によって実現されます。Metabase からAcumatica のデータを操作するには、まず Acumatica 接続を作成し設定します。
- Connect AI にログインして「Sources」をクリックし、 Add Connection をクリックします
- Add Connection パネルから「Acumatica」を選択します
-
Acumatica への接続に必要な認証プロパティを入力します。
Acumatica 接続プロパティの取得・設定方法
Acumatica への接続
Acumatica データソースに接続するには、次の接続プロパティを指定する必要があります。
- URL：（必須）Acumatica ERP インスタンスのベースURL。例：https://domain.acumatica.com/。
- Schema：（オプション）異なるデータを含む2つのスキーマがあります。デフォルトはREST で、Acumatica REST コントラクトベースのAPI を使用し、OData スキーマはAcumatica OData API を使用します。OData スキーマはAcumatica Generic Inquiries へのクエリに使用されます。
- Company：（一部必須）会社名またはテナント名に設定。Schema がOData に設定されている場合は必須です。
- EndpointVersion：（オプション）Web Services エンドポイントのバージョン。例：24.200.001。これはREST スキーマにのみ適用されます。
- EndpointName：（オプション）Web Services エンドポイントの名前。例：Default。これはREST スキーマにのみ適用されます。
Acumatica への認証
Acumatica データソースへの接続に使用できる認証方法は2つあります。Basic およびOAuth です。 Basic 認証では、AuthScheme をBasic に設定し、User とPassword をログイン資格情報に設定します。 OAuth 認証については、ヘルプドキュメントの「接続の確立」セクションにある「OAuth」を参照してください。
- Save & Test をクリックします
-
Add Acumatica Connection ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。
Personal Access Token の追加
REST API、OData API、またはVirtual SQL Server 経由でConnect AI に接続する場合、Personal Access Token（PAT）を使用してConnect AI への接続を認証します。アクセス管理の粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
- Settings ページで「Access Tokens」セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付けて「Create」をクリックします。
- Personal Access Token は作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。
接続の設定とPAT の生成が完了したら、Metabase からAcumatica のデータに接続する準備が整いました。
Metabase からCData Connect AI に接続
Connect AI で接続を作成したら、Metabase インスタンスに移動します。SQL Server インターフェースを使用してConnect AI に接続します。
- 管理画面（Settings -> Admin）に移動し、「Databases」タブから「Add Database」をクリックします
- Connect AI への接続を設定し、「Save」をクリックします
- Database type: 「SQL Server」を選択します
- Name: 接続に名前を付けます（例：「Acumatica (Connect AI)」）
- Host: tds.cdata.com
- Port: 14333
- Database name: 先ほど作成した接続の名前（例：Acumatica1）
- Username: Connect AI のユーザー名（例：user@mydomain.com）
- Password: 先ほど作成したPAT
- Use a secure connection (SSL) にチェックを入れます
Metabase で Acumatica のデータを実行
Connect AI への接続を設定したら、Acumatica にクエリを実行してビジュアライゼーションを構築できます。
- 「Write SQL」ツールを使用してAcumatica のデータを取得します
- CData Connect AI の Acumatica 接続に基づいてSQL クエリを記述します。例：
SELECT Id, location_displayname FROM Events
- 「Visualization」画面に移動し、ビジュアライゼーションを選択して設定します
詳細情報と無償トライアル
これで、Metabase でAcumatica のデータからシンプルなビジュアライゼーションを構築できました。Metabase では、SQL Server データベースと同じようにリアルタイムのAcumatica のデータを引き続き操作できます。Acumatica（およびその他100以上のデータソース）へのリアルタイム接続の詳細については、Connect AI ページをご覧ください。無償トライアルに登録して、今すぐMetabase でリアルタイムのAcumatica のデータを活用してみてください。