クエリジョブの作成

構文

URI

/services/data/vXX.X/jobs/query

適用開始バージョン

このリソースは API バージョン 47.0 以降で使用できます。

表示形式

application/json

HTTP メソッド

POST

認証

認証: OAuth sessionId

リクエストボディ

リクエストボディでは、実行するクエリを指定します。

1{
2  "operation": "query",
3  "query": "SELECT Id FROM Account"
4}

SOQL クエリの場合、次はサポートされません。

• COUNT
• ROLLUPSUM
• GROUP BY CUBE
• OFFSET
• ネストされた SOQL クエリ

メモ

いくつかの省略可能なパラメータを指定することもできます。次に例を示します。

1{
2  "operation" : "query",
3  "query" : "SELECT Id FROM Account",
4  "contentType" : "CSV",
5  "columnDelimiter" : "CARET",
6  "lineEnding" : "CRLF"
7}

要求パラメータ

パラメータ	説明	必須か省略可能
operation	クエリの種別。値は次のとおりです。 query — 削除やアーカイブされていないデータを返します。詳細は、『SOAP API 開発者ガイド』の「query()」を参照してください。 queryAll — マージや削除が原因で削除されたレコードと、アーカイブされたタスクおよびイベントレコードに関する情報を返します。詳細は、『SOAP API 開発者ガイド』の「queryAll()」を参照してください。	必須
query	実行されるクエリ。	必須
object	照会されるオブジェクトの種別。たとえば、Account です。これを指定しない場合は、API が query からオブジェクトを判別します。	省略可能
contentType	結果で使用される形式。現在サポートされている値は、CSV のみです (コンマ区切り変数)。デフォルトは CSV です。 メモ 実際の区切り文字は、コンマでない場合があります。columnDelimiter パラメータでは、使用する文字を指定します。	省略可能
columnDelimiter	CSV ジョブデータに使用される列区切り文字。デフォルト値は COMMA です。値は次のとおりです。 BACKQUOTE — バッククォート文字 (`) CARET — キャレット文字 (^) COMMA — コンマ文字 (,) PIPE — パイプ文字 (|) SEMICOLON — セミコロン文字 (;) TAB — タブ文字	省略可能
lineEnding	CSV ジョブデータに使用される行末で、データ行の終わりを示します。デフォルトは LF です。値は次のとおりです。 LF — 改行文字 CRLF — 行頭復帰および改行文字	省略可能

レスポンスボディ

1{
2   "id" : "750R0000000zlh9IAA",
3   "operation" : "query",
4   "object" : "Account",
5   "createdById" : "005R0000000GiwjIAC",
6   "createdDate" : "2018-12-10T17:50:19.000+0000",
7   "systemModstamp" : "2018-12-10T17:50:19.000+0000",
8   "state" : "UploadComplete",
9   "concurrencyMode" : "Parallel",
10   "contentType" : "CSV",
11   "apiVersion" : 46.0,
12   "lineEnding" : "LF",
13   "columnDelimiter" : "COMMA"
14}

応答パラメータ

パラメータ	説明
id	このジョブの一意の ID。
operation	クエリの種別。
object	照会されるオブジェクトの種別。
createdById	ジョブを作成したユーザの ID。
createdDate	ジョブが作成された UTC 日時。
systemModstamp	API がジョブ情報を最後に更新した UTC 日時。
state	ジョブの現在の処理状況。値は次のとおりです。 UploadComplete — すべてのジョブデータがアップロードされ、ジョブは処理できる状態です。Salesforce がそのジョブをキューに追加します。 InProgress — Salesforce がジョブを処理しています。 Aborted — ジョブが中止されました。「クエリジョブの中止」を参照してください。 JobComplete — Salesforce がジョブの処理を完了しました。 Failed — ジョブが失敗しました。
concurrencyMode	将来の使用のために予約されています。要求がどのように処理されるか。現在、サポートされているのは並列モードのみです。(他のモードが追加された場合、API によってモードが自動的に��択されます。ユーザがモードを設定することはできません)。
contentType	結果で使用される形式。現在サポートされている値は、CSV のみです。
apiVersion	ジョブが作成された API バージョン。
lineEnding	CSV ジョブデータに使用される行末で、データ行の終わりを示します。
columnDelimiter	CSV ジョブデータに使用される列区切り文字。

例

1curl --include --request POST \
2--header "Authorization: OAuth 00DR00000000nd2aAQ8AQORpU.gf72HWKXAOkAcjOhYvBfvXiqgkMcERVkxSauharjcilr8BxJRjouE5mopL2TvHflPMtRd4.FFl63Yuq5pmhPaa8 " \
3--header "Accept: application/json " \
4--header "Content-Type: application/json" \
5--data '{
6  "operation": "query",
7  "query": "SELECT Id, Name FROM Account"
8}' \
9"https://instance.salesforce.com/services/data/v46.0/jobs/query"

1HTTP/1.1 200 OK
2{
3   "id" : "750R0000000zw4yIAA",
4   "operation" : "query",
5   "object" : "Account",
6   "createdById" : "005R0000000GiwjIAC",
7   "createdDate" : "2018-12-17T21:00:17.000+0000",
8   "systemModstamp" : "2018-12-17T21:00:17.000+0000",
9   "state" : "UploadComplete",
10   "concurrencyMode" : "Parallel",
11   "contentType" : "CSV",
12   "apiVersion" : 46.0,
13   "lineEnding" : "LF",
14   "columnDelimiter" : "COMMA"
15}