[この記事はプレリリース ドキュメントであり、変更されることがあります。]
この記事では、Dataverse SDK for Python を使用して Dataverse にアクセスするように Python 環境を設定する方法について説明します。 次に、作業を開始するための簡単なコーディング例をいくつか示します。
[前提条件]
- Dataverse 環境への読み取り/書き込みアクセス。 試用版環境を使用できます。
- アクティブ化された Python 3.10 以降の環境。
- SDK パッケージを取得するための pypi.org へのネットワーク アクセス。
SDK と依存関係をインストールする
ターミナル ウィンドウから、次のコマンドを実行します。 これにより、pypi.org から SDK がインストールされます。
pip install PowerPlatform-Dataverse-Client
Dataverse への接続
このコード例では、SDK パッケージからクライアントと構成の種類をインポートし、Dataverse 環境への接続を確立します。 URL の 'myorg' を実際の環境の正しい名前に変更してください。
from azure.identity import InteractiveBrowserCredential
from PowerPlatform.Dataverse.client import DataverseClient
from PowerPlatform.Dataverse.core.config import DataverseConfig
cfg = DataverseConfig() # defaults to language_code=1033
client = DataverseClient(base_url="https://<myorg>.crm.dynamics.com",
InteractiveBrowserCredential(), config=cfg)
オプションの HTTP 調整可能な設定を使用して接続をカスタマイズし、接続のタイムアウトや再試行などを処理できます。 cfg.http_retries、 cfg.http_backoff、 cfg.http_timeoutを使用してこれらの設定にアクセスします。
Dataverse 環境へのクライアント接続が確立されたので、SDK を使用してビジネス データ、テーブル メタデータなどを操作できます。 次の記事では、これらの操作の例をいくつか取り上げます。
このページを終了する前に、Dataverse に関する知識がない限り、Dataverse を効果的に操作できないことに注意してください。 基本について説明するクイック ガイド記事を提供します。