Bulk API 2.0 および Bulk API 開発者ガイド
jBulk API 2.0 クエリについて
Bulk API 2.0 の可用性、サポートされるメソッド、および制限について説明します。
可用性
Bulk API 2.0 のクエリジョブは、API バージョン 47.0 以降で使用できます。
サポートされる URI およびメソッド
次の表は、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 では、次のいずれかの項目を含む SOQL クエリはサポートされません。
- 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 |