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 特定の結果セットを取得します。 これを省略した場合は、表示可能な行数と同じ行数が返されます。実際の結果数が、表示可能な数より多い場合は、次の結果セットを取得するためのロケータ値が結果ヘッダーに表示されます。
「ルールとガイドライン」を参照してください。
省略可能 maxRecords セットあたりの最大レコード取得数。要求は、依然としてサイズの制限を受けます。 操作するクエリセットが非常に大きい場合は、Salesforce からすべてのデータを受信する前にタイムアウトが発生する場合があります。タイムアウトを防止するには、maxRecords を使用して、結果を複数のセットに分割します。
省略可能 - レスポンスボディ
- 要求が成功した場合、状況コードは 200 (OK) となり、リクエストボディには、ジョブのクエリ結果が表示されます。次に例を示します。
1"Id","Name" 2"005R0000000UyrWIAS","Jane Dunn" 3"005R0000000GiwjIAC","George Wright" 4"005R0000000GiwoIAC","Pat Wilson" 5... - レスポンスボディ - 要求が失敗した場合
- 要求が失敗した場合は、サーバにより 200 以外の状況が返され、リクエストボディにはエラーの詳細が表示されます。次に例を示します。
1HTTP/1.1 412 Precondition Failed 2[{ 3 "errorCode": "JOB_NOT_COMPLETE", 4 "message": "can only download query results of successfully completed bulk job with status: JOB_COMPLETE. Current status: IN_PROGRESS" 5}] - 応答ヘッダー
-
ヘッダー 説明 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...