QueryAll More Results
QueryAll 要求でクエリロケータを使用することにより、後続の結果セットを返します。この API リソースは、指定された QueryAll 要求を実行します。QueryAll More Results のクエリは、API バージョン 29.0 以降で利用できます。
最初の QueryAll 要求からの結果数が 2,000 レコードの制��を超える場合、応答には、最初の 2,000 件の結果セットとクエリロケータが含まれ、done は false 値になります。後続の 2,000 レコードを取得するには、QueryAll More Results の要求でこのクエリロケータを使用します。まだ返されていないレコードがある場合は、応答に新しいクエリロケータが含まれ、done は false となります。結果の取得は、最初の QueryAll の要求から done が true になるまで、つまり全結果が返されたことを示すまで、続けることができます。
- URI
- /services/data/vXX.X/queryAll/query_locator
- 形式
- JSON、XML
- HTTP のメソッド
- GET
- 認証
- Authorization: Bearer token
- パラメータ
-
パラメータ 説明 query_locator 後続のクエリ結果を取得するために使用する文字列。まだ未取得の結果がある場合、前の QueryAll の結果の nextRecordsUrl 項目にクエリロケータが含まれます。 - レスポンスボディ
- 応答には、QueryAll 要求で返されたレコードの総数 (totalSize)、これ以上結果がないことを示す Boolean 値 (done)、後続のレコードの URI (nextRecordsUrl)、クエリ結果レコードの配列 (records) が含まれます。
- レスポンスボディの例
-
1{ 2 "totalSize": 3222, 3 "done": false, 4 "nextRecordsUrl": "/services/data/v57.0/query/01gRO0000016PIAYA2-500", 5 "records": [ 6 { 7 "attributes": { 8 "type": "Contact", 9 "url": "/services/data/v57.0/sobjects/Contact/003RO0000035WQgYAM" 10 }, 11 "Id": "003RO0000035WQgYAM", 12 "Name": "John Smith" 13 }, 14 ... 15 ] 16}
SOQL クエリ実行のリソース
- 削除された項目を含む QueryAll 要求を送信するには、「削除された項目を含む SOQL クエリを実行する」を参照してください。
- 最初に返された結果数を超えるクエリ結果を追加で取得するには、「削除された項目を含む SOQL クエリを実行する」の「SOQL クエリの残りの結果の取得」を参照してください。
- クエリ結果のバッチサイズを大きくするには、Query Options ヘッダーを使用します。
- SOQL 全般についての詳細は、『SOQL および SOSL リファレンス』を参照してください。