BatchRequest クラス

Dataverse OData $batch 要求を構築して実行するためのビルダー。

new (client.batch.new()) を使用して取得します。 records、tables、query、dataframeを使用して操作を追加し、必要に応じて書き込みをchangesetにグループ化してから、executeを呼び出します。

操作は、追加された順序で順番に実行されます。結果の BatchResult には、ディスパッチされた HTTP 要求ごとに 1 つの BatchItemResponse が含まれます (一部の操作は複数の要求に拡張されます)。

Note

バッチあたり最大 1,000 の HTTP 操作。

例:


   batch = client.batch.new()
   batch.records.create("account", {"name": "Contoso"})
   batch.tables.get("account")
   with batch.changeset() as cs:
       ref = cs.records.create("contact", {"firstname": "Alice"})
       cs.records.update("account", account_id, {
           "primarycontactid@odata.bind": ref
       })
   result = batch.execute()

コンストラクター

BatchRequest(client: DataverseClient)

パラメーター

名前	説明
client 必須

メソッド

changeset

このバッチにアタッチされた新しい ChangeSet を作成します。

変更セットはすぐにバッチに追加されます。 cs.records.*を介して返されたChangeSetに追加された操作はアトミックに実行されます。

例:


   with batch.changeset() as cs:
       cs.records.create("account", {"name": "ACME"})
       cs.records.create("contact", {"firstname": "Bob"})

execute

バッチを Dataverse に送信し、すべての応答を返します。