この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Async Query

非同期 SOQL クエリジョブの結果。

JSON の例

1{ 
2   "jobId": "08PD000000003kiT", 
3   
4   "message": "",
5         
6   "query": "SELECT firstField__c, secondField__c FROM SourceObject__c",  
7             
8   "status": "New",
9         
10   "targetObject": "TargetObject__c", 
11         
12   "targetFieldMap": {"firstField__c":"firstFieldTarget__c", 
13                      "secondField__c":"secondFieldTarget__c"
14                     },
15   "targetValueMap": {"$JOB_ID":"BackgroundOperationLookup__c",
16                      "Copy fields from source to target":"BackgroundOperationDescription__c"
17                     } 
18}

プロパティ

プロパティ名	型	説明	検索条件グループとバージョン	使用可能なバージョン
`jobId`	String	非同期 SOQL クエリの ID。この ID は、バックグラウンド操作標準オブジェクトのエントリに対応します。$JOB_ID が使用されている場合、`targetValueMap` で使用される ID と一致します。非同期クエリジョブの状況を取得するには、Async Query の Status 要求でこの ID を使用します (`/async-queries/jobId`)。	Big、35.0	35.0
`message`	String	クエリに関する情報 (クエリが失敗した場合のエラーメッセージなど) を提供するテキストメッセージ。	Big、37.0	37.0
`operation`	String	クエリが挿入か更新/挿入かを指定します。レコードが存在しない場合、更新/挿入は挿入のように動作します。 Big Object では更新/挿入はサポートされていません。メモ	Big、39.0	.39.0
`query`	String	実行する SOQL クエリのパラメータを指定します。`FROM` オブジェクトは Big Object にする必要があります。	Big、35.0	35.0
`status`	String	非同期クエリジョブの状況。 `Canceled` — ジョブが実行される前にキャンセルされました。 `Complete` — ジョブが正常に完了しました。 `Failed` — ジョブが送信された後に失敗したか、要求が非同期 SOQL 制限を超えているため失敗しました。メッセージ項目に失敗の理由の詳細が表示されます。 `Running` — ジョブが正常に実行中で、組織は制限を超えていません。 `Scheduled` — 新しいジョブが作成およびスケジュールされ、まだ実行されていません。 `New` — ジョブが作成され、まだスケジュールされていません。	Big、35.0	35.0
`targetExternalIdField`	String	対象 sObject の ID。更新/挿入操作で必須。	Big、39.0	39.0
`targetFieldMap`	Map<String, String>	クエリ結果の項目を対象オブジェクトの項目に対応付ける方法を定義します。 `targetFieldMap` パラメータを定義する場合、データ型の対応付けが一貫していることを確認してください。参照元項目と対象項目が一致しない場合、次の考慮事項が適用されます。任意の参照元項目を対象テキスト項目に対応付けることができます。参照元項目と対象項目が両方とも数値の場合、対象項目の小数点以下の桁数は参照元項目の桁数以上である必要があります。それ以外の場合、要求が失敗します。この動作は、変換でデータが失われないようにするためです。クエリ結果の項目が複数回対応付けられる場合、対象オブジェクトの異なる項目に対応付けられる場合でも、最後の対応付けのみが使用されます。メモ	Big、35.0	35.0
`targetValueMap`	Map<String, String>	対象オブジェクトの項目に静的文字列を対応付ける方法を定義します。クエリの SELECT 句で、任意の項目または別名を `TargetValueMap` 値として使用できます。特別な値、$JOB_ID を対象オブジェクトの項目に対応付けることができます。対象項目は、バックグラウンド操作標準オブジェクトへのルックアップである必要があります。この場合、非同期 SOQL クエリを表すバックグラウンド操作オブジェクトの ID が挿入されます。対象項目がテキスト項目の場合、15 ～ 18 文字以上である必要があります。 `TargetValueMap` の SELECT 句に任意の項目または別名を含めることもできます。それらを組み合わせて、使用する値を連結できます。	Big、37.0	37.0
`targetObject`	String	クエリの結果を挿入する標準オブジェクト、カスタムオブジェクト、外部オブジェクト、または Big Object。	Big、35.0	35.0

Chatter REST API 開発者ガイド

Async Query

関連項目: