メインコンテンツまでスキップ

複数アイテムの一括更新

同一データベースでデータを一括更新するには、ExecuteBulkAction API が利用できます。

このAPIは、条件を指定して、アクションを一括実行します。ターゲットとするデータストアに対して一つのActionを複数Itemに対して連続実行できます。

ExecuteBulkAction API​

  • ExecuteBulkAction：条件を指定して、アクションを一括実行する
  • Method：POST
  • Request URL Format：/api/v0/applications/:app-id/datastores/:datastore-id/items/bulkaction/:action-id

利用条件​

同時処理実行件数は デフォルトで100件です。max_itemsパラメータで最大300件まで指定が可能です。

continue_procオプションをtrueにすると、対象が最大件数を超えた場合に最大件数まで更新をおこないます。結果JSONに含まれる matched = processed となるまでこの API を複数回実行することで、全件の更新が可能です。

この API で更新されたデータは常に最新の rev_no を判定して更新します（force_update オプション＝ true として実行し、排他制御はされません）。

トランザクションについて​

このAPIは、トランザクション処理のようなロールバック（rollback）機能は持っておりません。定期的に不整合なデータをチェックしたり、失敗した場合のリトライしたりするプログラムを自前で用意する必要があります。

トランザクション機能を利用するには、ExecuteAction API をご利用ください。