Dataverse で CreateMultiple を使っても速くならないとき、受け手のプラグインを確認する
CreateMultiple(バルク作成 API)を使ったのにジョブが大量に積まれる。あるいは処理速度が単発と変わらない。原因の多くは受け手にある。 送る側がバルクになっても、受け取るプラグインが「1件ずつ処理」のままなら、Dataverse は内部でバルク要求を件数分の単発イベントに分解し、既存プラグインを N 回個別に発火させる。この挙動が「縮小発火」(公式呼称:message pipelines merged の逆方向動作)だ。 結論を先に言う。受け手のプラグインを CreateMultiple イベントに登録し直し、EntityCollection をまとめて処理するロジックに書き替えて初めて、バルク化の効果が出る。 天井は消えない——ただし、正直に言えば「移る」だけだ。それも含めて説明する。 なぜ受け手が「1件ずつ」だと遅いのかMicrosoft Learn 公式ドキュメント(2026年時点)には次の一文がある: “When you use a bulk operation message, the respective Create and Update event occurs for each Entity instance in the Targets parameter.” N 件を CreateMultiple で送ると、Create に登録されたプラグインは N 回個別に呼び出される。バルク API を叩いた送り側からは 1 リクエストに見えていても、受け手の世界では N 回のプラグイン実行サイクルが回る。 これが「縮小発火」(message pipelines merged の逆方向)と呼ぶ挙動の正体だ。公式ドキュメントで明示されており、仕様通りの動作——つまり、バグではない。 この構造で問題になるのは、同期プラグインの実行時間だ。公式は「同期プラグインが 2 秒を超えると深刻なパフォーマンス低下につながる」と明記している。100 件のバルク要求で縮小発火が起きていれば、同期プラグインは合計で最大 200 秒分のサイクルを費やすことになる。送る側だけをバルクにしても、ここが律速だ。 受け手の直し方——CreateMultiple への移行手順プラグインを CreateMultiple イベントに対応させる方向は任意だが、公式ドキュメントは「パフォーマンス向上はバルク版に書き換えたプラグインのみが享受できる」と明示している。実質、書き替えが必要になる。 移行の手順は次の流れで踏む。 ステップ 1:既存の単発プラグインを無効化(または削除)してから移行する これを省くと二重実行のリスクがある。公式は次のように明記している: ...