IntelliJ で Microsoft Dataverse のデータに接続

Jerod Johnson
Senior Technology Evangelist

IntelliJ のウィザードを使用して Microsoft Dataverse のデータへの接続を設定します。

CData JDBC Driver for Microsoft Dataverse を使用すると、Microsoft Dataverse を JDBC データソースとしてアクセスでき、IDE の迅速な開発ツールとの連携が可能になります。この記事では、データソース設定ウィザードを使用して IntelliJ で Microsoft Dataverse のデータに接続する方法を説明します。

Microsoft Dataverse データ連携について

CData は、Microsoft Dataverse（旧 Common Data Service）のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

Dataverse エンティティと Dataverse システムテーブルの両方にアクセスし、必要なデータを正確に扱うことができます。
Azure Active Directory、Azure マネージドサービス ID 認証情報、クライアントシークレットまたは証明書を使用した Azure サービスプリンシパルなど、さまざまな方法で Microsoft Dataverse に安全に認証できます。
SQL ストアドプロシージャを使用して、Microsoft Dataverse エンティティを管理できます。エンティティ間の関連付けの一覧表示、作成、削除などが可能です。

CData のお客様は、データをデータウェアハウスにレプリケートしたい場合（他のデータソースと併せて）や、Microsoft エコシステム内のお気に入りのデータツール（Power BI、Excel など）または外部ツール（Tableau、Looker など）からライブ Dataverse データを分析したい場合など、さまざまな理由で当社の Dataverse 接続ソリューションを使用しています。

はじめに

Microsoft Dataverse 用の JDBC データソースを作成

以下の手順で、ドライバー JAR を追加し、Microsoft Dataverse のデータへの接続に必要な接続プロパティを定義します。

Data Sources ウィンドウで右クリックし、Add Data Source -> DB Data Source をクリックします。
表示される Data Source Properties ダイアログで、以下のプロパティを設定します。
- JDBC Driver Files: このメニューの横にあるボタンをクリックし、インストールディレクトリにある JDBC Driver ファイル cdata.jdbc.cds.jar を追加します。
- JDBC Driver Class: このメニューで、リストから cdata.jdbc.cds.CDSDriver を選択します。
- Database URL: JDBC URL プロパティに接続 URL を入力します。URL は jdbc:cds: で始まり、セミコロンで区切られた接続プロパティを含みます。
  
  ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、以下のとおりです。
  - InitiateOAuth: GETANDREFRESH に設定します。
  - OrganizationUrl: 接続先の組織のURL、例えばhttps://organization.crm.dynamics.com などに設定。
  - Tenant (optional): デフォルトと異なるテナントに認証したい場合は、これを設定します。これは、デフォルトのテナントに所属していない組織と連携するために必要です。
  接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の作成には、Microsoft Dataverse JDBC Driver に組み込まれている接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
java -jar cdata.jdbc.cds.jar
```
  接続プロパティに値を入力して、接続文字列をクリップボードにコピーします。
  
  一般的な JDBC URL は以下のとおりです。
```
jdbc:cds:OrganizationUrl=https://myaccount.crm.dynamics.com/
```