Fehler "INVALID_QUERY_LOCATOR"

Übersicht über Abfrage-Locators

Wenn Ergebnisse für eine große oder komplexe Abfrage nicht in einer einzigen Antwort zurückgegeben werden können, werden ein oder mehrere serverseitige Cursor erstellt. Cursor verweisen auf die Position weiterer Abfrageergebnisse in der Datenbank. Diese weiteren Ergebnisse werden mit einem Abfrage-Locator in einem anderen Aufruf abgerufen, beispielsweise mit dem Aufruf queryMore() in der SOAP-API oder dem Feld nextRecordUrl in der REST-API. 

Angenommen bei einem Abfrageaufruf ist die Batch-Größe auf 2.000 festgelegt und die Organisation verfügt über mehr als 2.000 Accounts. In diesem Szenario gibt SELECT id FROM account die maximale Anzahl von 2.000 Datensätzen und einen Abfrage-Locator zurück, der angibt, wo der zusätzliche Aufruf die restlichen Datensätze finden und abrufen kann. 

Ein Abfrage-Locator ist 18 Zeichen lang und beginnt mit dem Präfix 0r8. Jeder Locator und die zugehörigen Ergebnisse sind nach Ausführung der anfänglichen Abfrage noch 2 Tage lang verfügbar. Die Verwendung eines ungültigen oder abgelaufenen Abfrage-Locators in einem Aufruf führt zu einem Fehler.

Verwenden der erweiterten Fehlerdetails zur Fehlerbehebung

Die Fehlermeldung INVALID_QUERY_LOCATOR und die zugehörigen erweiterten Fehlercodes geben an, warum der Fehler aufgetreten ist und wie er behoben werden kann: 

• INVALID_QUERY_LOCATOR_FORMAT
• LOCATOR_LOCATION_EXCEEDS_SIZE
• QUERY_LOCATOR_EXPIRED
• TEMPORARY_QUERY_MORE_FAILURE
• UNAUTHORIZED_USER_FOR_CURSOR

Referenz 

• Salesforce SOAP API Developer Guide: query()
• Salesforce REST API Developer Guide: Query
• SOQL and SOSL Limits for Search Queries
• Core Data Types Used in API Calls
• Apex Developer Guide: Using Apex Variables in SOQL and SOSL Queries