DataGrip で Dynamics 365 Business Central のデータ をクエリ

DataGrip は、SQL 開発者がデータベースへのクエリ、作成、管理を行えるデータベース IDE です。CData JDBC Driver for Dynamics 365 Business Central と組み合わせることで、DataGrip からリアルタイムDynamics 365 Business Central のデータを操作できます。この記事では、DataGrip で Dynamics 365 Business Central のデータ への接続を確立し、テーブルエディタを使用して Dynamics 365 Business Central のデータ を読み込む方法を説明します。

Dynamics 365 Business Central 用の新しいドライバー定義を作成

以下のステップでは、DataGrip で Dynamics 365 Business Central 用の新しいデータソースを作成する方法を説明します。

1. DataGrip で、File -> New -> Project をクリックしてプロジェクト名を入力します。
2. Database Explorer で、プラスアイコン（）をクリックして Driver を選択します。
3. Driver タブで以下を設定します。
   • Name をわかりやすい名前に設定します（例："CData Dynamics 365 Business Central Driver"）。
   • Driver Files を適切な JAR ファイルに設定します。ファイルを追加するには、プラス（）をクリックし、「Add Files」を選択して、ドライバーのインストールディレクトリ内の「lib」フォルダに移動し、JAR ファイル（例：cdata.jdbc.d365businesscentral.jar）を選択します。
   • Class を cdata.jdbc.d365businesscentral.D365BusinessCentral.jar に設定します。
   また、詳細タブでは、ドライバーのプロパティや、VM Options、VM environment、VM home path、DBMS などの設定を変更できます。
   • ほとんどの場合、Expert options で DBMS type を「Unknown」に変更して、ネイティブの SQL Server クエリ（Transact-SQL）を回避してください。これを行わないと、無効な関数エラーが発生する可能性があります。
4. 「Apply」をクリックし、「OK」をクリックして接続を保存します。

Dynamics 365 Business Central への接続を設定

1. 接続を保存したら、プラス（）をクリックし、「Data Source」→「CData Dynamics 365 Business Central Driver」を選択して、新しい Dynamics 365 Business Central データソースを作成します。
2. 新しいウィンドウで、JDBC URL を使用して Dynamics 365 Business Central への接続を設定します。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、Dynamics 365 Business Central JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

         java -jar cdata.jdbc.d365businesscentral.jar
       

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   Dynamics 365 Business Central 接続プロパティの取得・設定方法

   Dynamics 365 Business Central への認証には、User およびAccessKey プロパティが必要です。

   データに接続するには、OrganizationUrl を指定します。OrganizationUrl は、 http：//businesscentral.dynamics.com/abc123/ などのBusiness Central アカウントへのエンドポインであるか、Web サービスのルートを参照する必要があります。OrganizationUrl を指定する方法 および利用可能なエンドポイントについての詳細は、Business Central エンドポイント を参照してください。組織内に複数の会社がある場合は、どの会社に接続するかを特定するためにCompany を指定する必要があります。 会社が1つだけの場合は、Company を指定する必要はありません。

   Dynamics 365 Business Central に認証するには、User およびAccessKey 接続プロパティを指定します。Microsoft では、これらをテストおよび開発目的で推奨します。ただし、運用環境での使用は推奨していません。User およびAccessKey の値を取得するには、Dynamics 365 Business Central の「ユーザー」ページに移動して「編集」をクリックします。User Name および Web Service Access Key の値は、User およびPassword 接続文字列プロパティとして入力する値です。User Name はE メールアドレス ではありません。短縮されたユーザー名です。

   Microsoft では、OAuth 認証を使用する本番ユースケースを推奨します。詳細については、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

   
3. URL を接続文字列に設定します。例：

   jdbc:d365businesscentral:OrganizationUrl=https://myaccount.financials.dynamics.com/;

4. 「Apply」と「OK」をクリックして接続文字列を保存します。

これで、Data Explorer にデータソースが表示されます。

Dynamics 365 Business Central に対して SQL クエリを実行

JDBC Driver を介してアクセス可能な Dynamics 365 Business Central のエンティティ（テーブルとして利用可能）を参照するには、データソースを展開します。

クエリを実行するには、任意のテーブルを右クリックして「New」→「Query Console」を選択します。

Console で、実行したい SQL クエリを記述します。例：

SELECT accountid, Name FROM Accounts

CData JDBC Driver for Dynamics 365 Business Central の30日間の無料トライアルをダウンロードして、DataGrip でリアルタイムDynamics 365 Business Central のデータを操作してみてください。ご不明な点があれば、サポートチームにお問い合わせください。