RazorSQL で Microsoft Dataverse のデータ に接続
CData JDBC Driver for Microsoft Dataverse は、IDE のウィザードからデータ管理・分析ツールまで、サードパーティツールからの標準ベースのアクセスを可能にします。この記事では、RazorSQL のウィザードを使用して 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 データソースを作成
- RazorSQL アプリケーションを開き、「Connections」メニューから「Add Connection Profile」->「Other」->「JDBC」を選択します。
- 表示される「Connection Wizard」で、以下のプロパティを設定します。
- Driver Location:インストールディレクトリ内の lib サブフォルダへのパスを設定します。
- Driver Class:ドライバークラスを cdata.jdbc.cds.CDSDriver に設定します。
- Username:ユーザー名を入力します(このプロパティは JDBC URL 内でも設定できます)。
- Password:パスワードを入力します(このプロパティは JDBC URL 内でも設定できます)。
JDBC URL:接続パラメータを入力します。JDBC 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/
Microsoft Dataverse のデータ のクエリとテーブルの選択
接続が確立されると、ウィザードが閉じ、接続パネルで接続が利用可能になります。その後、テーブルをクエリできます。