provider がINSERT、UPDATE、UPSERT、およびDELETE ステートメントを、Microsoft Dataverse の一括操作メッセージを介して実行するか、OData バッチリクエストを介して実行するかを指定します。

Possible Values

データ型

string

デフォルト値

"Batch"

解説

Microsoft Dataverse の一括操作メッセージ（CreateMultiple、UpdateMultiple、UpsertMultiple、およびDeleteMultiple）は、1回のリクエストで多数の行を受け付けます。OData $batch リクエストと比較して、大規模なINSERT、UPDATE、UPSERT、およびDELETE のワークロードにおけるスループットが大幅に向上します。ただし、すべてのテーブルがこれらのメッセージをサポートしているわけではありません。

この接続プロパティには、以下の値を設定できます。

• Auto：INSERT、UPDATE、UPSERT、およびDELETE ステートメントについて、本製品 は対象テーブルが一括操作メッセージをサポートしているかどうかを検出します。テーブルがサポートしている場合、行のバッチは一括操作メッセージを介して並列リクエストで送信されます。サポートしていない場合、バッチステートメントおよび複数行ステートメントはOData $batch リクエストにフォールバックし、単一行ステートメントは標準のOData リクエストとして実行されます。
• Bulk：本製品 は、行を一括リクエストで送信できるステートメント（INSERT ステートメント、UPSERT ステートメント、およびバッチ処理されたUPDATE およびDELETE ステートメント）に一括操作メッセージを使用します。対象テーブルが対応する一括操作メッセージをサポートしていない場合、これらのステートメントはエラーで失敗します。バッチの一部ではない単一のUPDATE またはDELETE ステートメントは、このプロパティの値に関係なく、常に標準のOData リクエストとして実行されます。
• Batch：本製品 は一括操作メッセージを使用しません。バッチステートメントおよび複数行ステートメントはOData $batch リクエストを介して実行され、単一行ステートメントは標準のOData リクエストとして実行されます。これがデフォルト値です。

バッチ処理されたDELETE ステートメントおよび一括DELETE ステートメントは、対象テーブルがサポートしている場合、DeleteMultiple 一括操作メッセージを介して実行されます。実際には、DeleteMultiple メッセージをサポートしているのはエラスティックテーブルのみです。このプロパティがAuto に設定されている場合、標準テーブルに対するバッチ処理されたDELETE ステートメントは自動的にOData $batch リクエストにフォールバックします。Bulk に設定されている場合は、エラーで失敗します。バッチの一部ではない単一のDELETE ステートメントは、このプロパティの値に関係なく、常に標準のOData 削除リクエストを使用します。