Bulk API 2.0 および Bulk API 開発者ガイド
j一括クエリの使用
一括クエリジョブにバッチを追加するときに、要求のヘッダーの Content-Type には、ジョブの作成時に指定されたコンテンツタイプに応じて、text/csv、application/xml、または application/json のいずれかを指定する必要があります。バッチに使用される実際の SOQL ステートメントは、平文テキスト形式で表されます。
- URI
- /services/async/APIversion/job/jobid/batch
- 一括クエリの要求
-
Bulk API クエリでは、クエリ操作と queryAll 操作がサポートされます。queryAll 操作では、merge または delete によって削除されたレコードが返されます。また、queryAll 操作では、アーカイブ済みの ToDo と行動のレコードについての情報が返されます。詳細は、『SOAP API 開発者ガイド』の「queryAll()」を参照してください。
リレーションクエリは、結果を絞り込んで返すために、オブジェクト間の親-子のリレーションおよび子-親のリレーションを辿ります。一括クエリで SOQL リレーションを使用できます。SOQL リレーションについての詳細は、『SOQL および SOSL リファレンス』の「リレーションクエリの使用」を参照してください。
要求および応答
一括クエリの要求と応答の例を次に示します。
- 一括クエリバッチ作成の HTTP 要求
-
- 一括クエリバッチ作成の HTTP レスポンスボディ
-
- ジョブの HTTP 要求内のすべてのバッチに関する情報の取得 (PK Chunking が有効な場合に使用)
-
- ジョブの HTTP レスポンスボディ内のすべてのバッチに関する情報の取得
-
- バッチ結果取得の HTTP 要求
-
- バッチ結果取得の HTTP レスポンスボディ
-
- 一括クエリ結果取得の HTTP 要求
-
- 一括クエリ結果取得の HTTP レスポンスボディ
-
- ID を含むクエリの XML 応答
- クエリジョブの ContentType に XML を使用する場合、ID を含むクエリでは XML 応答データに ID 項目が 2 回返されます。同様に、ID を含まないクエリでは、XML 応答データに単一の null ID 項目が返されます。たとえば、SELECT ID, FirstName, LastName FROM Contact に対するクエリによって、次のようなレコードとともに XML 応答が返される場合があります。これは予期される動作であり、すべての XML 応答データにアクセスし、WSC を使用して Web サービス応答にアクセスしていない場合に把握しておく必要があります。詳細は、『SOAP API 開発者ガイド』の「クエリと Partner WSDL」を参照してください。
WSC を使用した Java の例
次の例では、Partner API を使用して組織にログインし、Partner API ログインからサービスエンドポイントを使用して BulkConnection オブジェクトをインスタンス化します。