Errore INVALID_QUERY_LOCATOR

Panoramica dei querylocator

Quando i risultati di una query grande o complessa non possono essere restituiti in un'unica risposta, vengono creati uno o più cursori sul lato server. I cursori puntano alla posizione dei risultati aggiuntivi della query nel database. I risultati aggiuntivi vengono recuperati utilizzando un querylocator all'interno di un'altra chiamata, ad esempio la chiamata queryMore() nell'API SOAP o il campo nextRecordUrl nell'API REST. 

Consideriamo ad esempio una chiamata di query in cui le dimensioni batch sono impostate su 2.000 e l'organizzazione ha più di 2.000 account. In questo scenario, SELECT id FROM account restituisce 2.000 record e un querylocator, che indica dove la chiamata aggiuntiva può trovare e recuperare i record rimanenti. 

Un querylocator contiene 18 caratteri e inizia con il prefisso 0r8. Ogni locator, con i risultati associati, è disponibile per due giorni dopo l'esecuzione iniziale della query. L'uso di un querylocator non valido o scaduto in una chiamata genera un errore.

Uso dei dettagli errore esteso per risolvere i problemi

Il messaggio di errore INVALID_QUERY_LOCATOR e i seguenti codici di errore esteso forniscono informazioni sul motivo per cui si è verificato l'errore e sulle modalità di risoluzione: 

• INVALID_QUERY_LOCATOR_FORMAT
• LOCATOR_LOCATION_EXCEEDS_SIZE
• QUERY_LOCATOR_EXPIRED
• TEMPORARY_QUERY_MORE_FAILURE
• UNAUTHORIZED_USER_FOR_CURSOR

Riferimento 

• Salesforce SOAP API Developer Guide (Guida per lo sviluppatore Salesforce di API SOAP): query()
• Salesforce REST API Developer Guide (Guida per lo sviluppatore Salesforce di API SOAP): Query
• SOQL and SOSL Limits for Search Queries (Limiti SOQL e SOSL per le query di ricerca)
• Core Data Types Used in API Calls (Tipi di dati principali utilizzati nelle chiamate API)
• Apex Developer Guide (Guida per lo sviluppatore Apex)i: Using Apex Variables in SOQL and SOSL Queries (Uso delle variabili Apex nelle query SOQL e SOSL)