client モジュール

クラス

DataverseClient

Microsoft Dataverse 操作用のクライアントの概要。

このクライアントは、Web API を介して Dataverse 環境と対話するためのシンプルで安定したインターフェイスを提供します。 Azure ID を介して認証を処理し、内部 OData クライアントに HTTP 操作を委任します。

主な機能:

  • OData CRUD 操作: レコードの作成、読み取り、更新、削除

  • SQL クエリ: Web API ?sql パラメーターを使用して読み取り専用 SQL を実行する

  • テーブル メタデータ: カスタム テーブルの作成、検査、および削除。列の作成と削除

  • ファイルのアップロード: チャンクがサポートされているファイル列にファイルをアップロードする

注

クライアントは、最初の使用時に内部 OData クライアントを遅延的に初期化し、ネットワーク呼び出しを即時に行わずに軽量な構築を可能にします。

注

Dataverse Web API と通信するすべてのメソッドは、

HttpError 成功していない場合

HTTP 応答 (例: 401、403、404、429、500)。 個別対応方式

docstrings はドメイン固有の例外のみを文書化します。

操作は名前空間に編成されます。

  • client.records – レコードの作成、更新、削除、および取得 (単一またはページ分割されたクエリ)

  • client.query – クエリ操作と検索操作

  • client.tables – テーブルと列のメタデータ管理

  • client.files – ファイルのアップロード操作

  • client.dataframe レコード CRUD の pandas DataFrame ラッパー

  • client.batch – 複数の操作を 1 つの HTTP 要求にバッチ処理する

v0 ベータメソッド (client.create、 client.query_sqlなど) は 1.0 GA で削除されました。 1 つを呼び出すと、GA 置換と codemod コマンドという名前のメッセージで AttributeError が発生するようになりました。以前は、これらの呼び出しで移行ヒントなしでベア AttributeError が発生していたため、半分に移行されたコードのデバッグは手間がかかっていました。 _REMOVED_BETA_METHODSを参照してください。

クライアントは、リソースの自動クリーンアップと HTTP 接続プールのために、Pythonのコンテキスト マネージャー プロトコルをサポートしています。