Bulk API 2.0
jクエリジョブの結果の取得
構文
- URI
- /services/data/vXX.X/jobs/query/queryJobId/results
-
1/services/data/vXX.X/jobs/query/queryJobId/results 2 ?locator=locator 3 &maxRecords=maxRecords - 適用開始バージョン
-
このリソースは API バージョン 47.0 以降で使用できます。
- 形式
- CSV
- HTTP メソッド
- GET
- 認証
- 認証: OAuth sessionId
- 要求パラメータ
-
パラメータ 説明 必須か省略可能 queryJobId クエリジョブの ID。 必須 locator 特定の結果セットを取得します。 これを省略した場合は、表示可能な行数と同じ行数が返されます。表示可能な行数より結果が多い場合、Sforce-Locator ヘッダーに次の結果セットを取得するためのロケータ値が含まれます。
「ルールとガイドライン」を参照してください。
省略可能 maxRecords セットあたりの最大レコード取得数。要求は、依然としてサイズの制限を受けます。 操作するクエリセットが非常に大きい場合は、Salesforce からすべてのデータを受信する前にタイムアウトが発生する場合があります。タイムアウトを回避するには、maxRecords パラメータでクライアントが想定する最大受信レコード数を指定します。これにより、結果がより小さいセットに分割されます。
省略可能 - レスポンスボディ
- 要求が成功した場合、状況コードは 200 (OK) となり、リクエストボディには、ジョブのクエリ結果が表示されます。次に例を示します。
1"Id","Name" 2"005R0000000UyrWIAS","Jane Dunn" 3"005R0000000GiwjIAC","George Wright" 4"005R0000000GiwoIAC","Pat Wilson" 5... - 要求が失敗した場合の応答
- 要求が失敗した場合、状況コードは 204 (No Content) です。
- 応答ヘッダー
-
ヘッダー 説明 Sforce-NumberOfRecords このセット内のレコード数。 Sforce-Locator 次の結果セットを取得するための URI。「ルールとガイドライン」を参照してください。
これ以上結果がない場合、このヘッダーは null になります。
例
次では、ID が 750R0000000zxr8IAA のジョブの結果が取得されます。
1curl --include --request GET \
2--header "Authorization: OAuth 00DR00000000nd2aAQ8AQORpU.gf72HWKXAOkAcjOhYvBfvXiqgkMcERVkxSauharjcilr8BxJRjou
3E5mopL2TvHflPMtRd4.FFl63Yuq5pmhPaa1" \
4--header "Accept: test/csv " \
5--header "Content-Type: application/json" \
6"https://instance.salesforce.com/services/data/v46.0/jobs/query/750R0000000zxr8IAA/results"レスポンスボディは次のようになります。
1HTTP/1.1 200 OK
2Sforce-NumberOfRecords: 500
3Sforce-Locator: 1000
4
5
6"Id","Name"
7"005R0000000UyrWIAS","Jane Dunn"
8"005R0000000GiwjIAC","George Wright"
9"005R0000000GiwoIAC","Pat Wilson"
10...