Aqua Data Studio で Microsoft Dataverse のデータに接続

Jerod Johnson
Senior Technology Evangelist

Visual Query Builder やテーブルデータエディターなど、Aqua Data Studio のツールから Microsoft Dataverse のデータにアクセスできます。

CData JDBC Driver for Microsoft Dataverse は、Aqua Data Studio などの IDE のウィザードや分析機能と Microsoft Dataverse のデータを連携できます。本記事では、接続マネージャーを使って 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 接続ソリューションを使用しています。

はじめに

JDBC データソースの作成

接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した Microsoft Dataverse データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。

Aqua Data Studio で、Servers メニューから Register Server を選択します。
Register Server フォームで、「Generic - JDBC」接続を選択します。
以下の JDBC 接続プロパティを入力します：
- Name: データソースの名前を入力します（例：Microsoft Dataverse）。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.cds.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.cds.CDSDriver を入力します。
- URL: JDBC 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/
```