JayDeBeApi を使って Python からMicrosoft Dataverse のデータにアクセス

Python と Java がインストールされている環境であれば、Python スクリプトと標準 SQL を使ってMicrosoft Dataverse のデータにアクセスできます。CData JDBC Driver for Microsoft Dataverse と JayDeBeApi モジュールを組み合わせることで、Python からリモートのMicrosoft Dataverse のデータを操作できます。CData ドライバーを使用することで、業界標準に準拠した実績のあるドライバーを Python という人気の高い言語で活用できます。この記事では、ドライバーを使って Microsoft Dataverse に SQL クエリを実行し、標準的な Python でMicrosoft Dataverse のデータを可視化する方法を説明します。

はじめに

---

JayDeBeApi モジュールを使用

JayDeBeApi は、JDBC（Java Database Connectivity）のブリッジとして機能する Python ライブラリで、Python プログラムから CData JDBC ドライバーを含む Java データベースとやり取りできるようになります。pip install コマンドでモジュールをインストールします。

pip install JayDeBeApi

JDBC URL を作成

JayDeBeApi をインストールしたら、SQL を使って Python からMicrosoft Dataverse のデータを操作する準備が整います。

ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、以下のとおりです。

• InitiateOAuth: GETANDREFRESH に設定します。
• OrganizationUrl: 接続先の組織のURL、例えばhttps://organization.crm.dynamics.com などに設定。
• Tenant (optional): デフォルトと異なるテナントに認証したい場合は、これを設定します。これは、デフォルトのテナントに所属していない組織と連携するために必要です。

接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。

ビルトイン接続文字列デザイナー

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

java -jar cdata.jdbc.cds.jar

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

以下は、一般的な JDBC 接続文字列を含む変数の例です。

jdbc_url = "jdbc:cds:OrganizationUrl=https://myaccount.crm.dynamics.com/"

Python からMicrosoft Dataverse のデータにアクセス

JDBC URL を設定したら、あとは JDBC ドライバーの JAR ファイルへの絶対パスだけが必要です。これはインストールディレクトリの "lib" フォルダにあります（Windows では "C:\Program Files\CData[product_name] 20XX\lib\cdata.jdbc.cds.jar"）。

注意: まだ設定していない場合は、JAVA_HOME 環境変数を Java のインストールディレクトリに設定してください。

以下のようなコードで Microsoft Dataverse からデータを読み取り、表示できます。

import jaydebeapi

#The JDBC connection string
jdbc_url = "jdbc:cds:OrganizationUrl=https://myaccount.crm.dynamics.com/"

username = "****"
password = "****"

#The absolute Path to the JDBC driver JAR file, typically:
jdbc_driver_jar = "C:\Program Files\CData[product_name] 20XX\lib\cdata.jdbc.cds.jar"

conn = jaydebeapi.connect(
   "cdata.jdbc.cds.CDSDriver",
   jdbc_url,
   [username, password],
   jdbc_driver_jar,
)

cursor = conn.cursor()
cursor.execute("SELECT * FROM Accounts;")


results = cursor.fetchall()
for row in results:
    print(row)

cursor.close()
conn.close()

無料トライアルと詳細情報

CData JDBC Driver for Microsoft Dataverse の 30 日間無料トライアルをダウンロードして、Python でリアルタイムのMicrosoft Dataverse のデータを操作してみてください。ご不明な点がございましたら、サポートチームまでお問い合わせください。