この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

一括クエリ

一括クエリジョブでは、SOQL クエリを非同期で処理できます。このジョブは、大量のデータ (10,000 レコード以上) を返すクエリを処理するように設計されています。

可用性

Bulk API 2.0 のクエリジョブは、API バージョン 47.0 以降で使用できます。

一括クエリは、Bulk API でも使用できます。(「一括クエリ」を参照してください)。ただし、Bulk API 2.0 の実装にはいくつかの利点があります。

バッチを処理する必要はありません。すべての結果は 1 つのエンドポイントから返されます。
制限が簡略化されており、クライアントが REST API /limits エンドポイントを介して使用できます。
Bulk API 2.0 クエリと他の Salesforce REST API との統合性が改善されています。
- 特別な X-SFDC-Session ヘッダーが不要。
- すべての通常の OAuth ワークフローをサポート。
- 設計上、他の API との一貫性が向上している。

次の表は、Bulk API 2.0 のクエリでサポートされる URI およびメソッドを示しています。

URI	HTTP メソッド	説明
`/services/data/vXX.X/jobs/query`	POST	クエリジョブを作成します。
`/services/data/vXX.X/jobs/query`	GET	組織内のすべてのクエリジョブに関する情報を取得します。
`/services/data/vXX.X/jobs/query/queryJobId`	GET	1 つのクエリジョブに関する情報を取得します。
`/services/data/vXX.X/jobs/query/queryJobId/results`	GET	クエリジョブの結果を取得します。
`/services/data/vXX.X/jobs/query/queryJobId`	PATCH	クエリジョブを中止します。
`/services/data/vXX.X/jobs/query/queryJobId`	DELETE	クエリジョブを削除します。

次の表は、Bulk API 2.0 のクエリジョブの制限を示しています。

項目	制限
24 時間のローリングウィンドウあたりのクエリジョブの最大数。現在の数は、`/vXX.X/limits/` REST API メソッドに対する応答の DailyBulkV2QueryJobs 値で確認できます。	10,000
24 時間のローリングウィンドウで保存できるクエリ結果の最大サイズ。現在のサイズは、`/vXX.X/limits/` REST API メソッドに対する応答の DailyBulkV2QueryFileStorageMB 値で確認できます。	1 TB