Bulk API 2.0
j一括クエリ
一括クエリジョブでは、SOQL クエリを非同期で処理できます。このジョブは、大量のデータ (10,000 レコード以上) を返すクエリを処理するように設計されています。
可用性
Bulk API 2.0 のクエリジョブは、API バージョン 47.0 以降で使用できます。
Bulk API のクエリジョブとの比較
一括クエリは、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 では、次のクエリはサポートされていません。
- GROUP BY、OFFSET、TYPEOF 句。
- COUNT() などの集計関数。
- GROUP BY 句の日付関数。(WHERE 句の日付関数はサポートされます。)
- 複合の住所項目または地理位置情報項目。
- 親 - 子リレーションクエリ。(子 - 親リレーションクエリはサポートされます。)
次の表は、Bulk API 2.0 のクエリジョブの制限を示しています。
| 項目 | 制限 |
|---|---|
| 24 時間のローリングウィンドウあたりのクエリジョブの最大数。 現在の数は、/vXX.X/limits/ REST API メソッドに対する応答の DailyBulkV2QueryJobs 値で確認できます。 |
10,000 |
| 24 時間のローリングウィンドウで保存できるクエリ結果の最大サイズ。 現在のサイズは、/vXX.X/limits/ REST API メソッドに対する応答の DailyBulkV2QueryFileStorageMB 値で確認できます。 |
1 TB |