QueryLocator

大きすぎるまたは複雑なクエリの結果を 1 つのバッチで返せない場合、1 つ以上のサーバ側カーソルと対応するクエリロケータが自動的に作成されます。カーソルは、データベース内の追加のクエリ結果のロケーションを示し、クエリロケータはカーソルを検出します。

レコードの数が、1 回の query() または queryMore() コールで返すことができる数より多い場合は、新しい queryLocator が QueryResult オブジェクトで返されます。次の結果セットを取得するには、最後に返されたクエリロケータ値を使用して、後続の queryMore() コールをフォローアップします。queryLocator 値はそれぞれ、一度だけ使用します。

queryLocator は、カスタムメタデータ型にアクセスするクエリでは使用できません。

クエリロケータが無効な場合、API は障害要素の InvalidQueryLocatorFault と例外の INVALID_QUERY_LOCATOR を返し、さらに起こりうる拡張エラーコードと追加情報を返します。