Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

INVALID_QUERY_LOCATOR エラー

公開日: Apr 24, 2026
説明
INVALID_QUERY_LOCATOR エラーおよび関連する拡張エラーコードは、追加のクエリ結果の呼び出しに含まれるクエリロケータが無効であるか存在しないことを示しています。
解決策

クエリロケータの概要
大きく複雑なクエリの結果を 1 回の応答で返すことができない場合、サーバ側カーソルが作成されます。カーソルはデータベース内の追加のクエリ結果の位置を指します。追加の結果は、SOAP API の queryMore() 呼び出しや REST API の nextRecordUrl 項目など、別の呼び出しでクエリロケータを使用して取得することができます。 

たとえば、バッチサイズが 2,000 に設定されたクエリ呼び出しがあり、組織に 2,000 以上の取引先があるとします。このシナリオでは SELECT id FROM account が、2,000 件のレコードと、追加の呼び出しで残りのレコードを見つけて取得できる位置を示すクエリロケータを返します。 

クエリロケータの長さは 18 文字で、接頭辞 0r8 から始まります。各ロケータと紐付けられた結果は、最初のクエリの実行から 2 日間使用できます。無効あるいは期限の切れたクエリロケータを使用すると、エラーがスローされます。

拡張エラーの詳細をトラブルシューティングに使用する
INVALID_QUERY_LOCATOR エラーおよび関連する拡張エラーコードは、エラーの原因と解決方法に関する情報を提供します。 
 

  • INVALID_QUERY_LOCATOR_FORMAT (クエリロケータの形式が無効)
  • LOCATOR_LOCATION_EXCEEDS_SIZE (ロケータの位置がサイズを超過)
  • QUERY_LOCATOR_EXPIRED (クエリロケータの期限切れ)
  • TEMPORARY_QUERY_MORE_FAILURE (QUERY MORE の一時的な失敗)
  • UNAUTHORIZED_USER_FOR_CURSOR (カーソルに対して未承認のユーザ)

 
関連情報 
Salesforce SOAP API 開発者ガイド: query()
Salesforce REST API 開発者ガイド: Query
SOQL および SOSL の検索クエリの制限
API コールで使用されるコアデータ型
Apex 開発者ガイド: SOQL クエリおよび SOSL クエリでの Apex 変数の使用

ナレッジ記事番号

000384958

 
読み込み中
Salesforce Help | Article