Erreur « INVALID_QUERY_LOCATOR »

Présentation des localisateurs de requête

Lorsque les résultats d’une requête volumineuse ou complexe ne peuvent pas être renvoyés dans une seule réponse, un ou plusieurs curseurs côté serveur sont créés. Les curseurs renvoient à l’emplacement des résultats de requête complémentaires dans la base de données. Ces résultats complémentaires sont récupérés à l’aide d’un localisateur de requête via un autre appel, tel que l’appel queryMore() dans l’API SOAP ou le champ nextRecordUrl dans l’API REST. 

Prenons l’exemple d’un appel de requête avec une taille de lot définie sur 2 000 et une organisation de 2 000 comptes. Dans ce scénario, le compte SELECT id FROM renvoie 2 000 enregistrements et un localisateur de requête qui indique où l’appel suivant pourra trouver et récupérer les enregistrements restants. 

Un localisateur de requête comporte 18 caractères et commence par le préfixe 0r8. Le localisateur et les résultats associés sont disponibles pendant les 2 jours suivant l’exécution de la requête initiale. Si un localisateur de requête non valide ou expiré est utilisé dans un appel, une erreur s’affiche.

Utilisation des détails de l’erreur pour résoudre le problème

Le message d’erreur INVALID_QUERY_LOCATOR et les codes d’erreur étendus associés fournissent des informations sur l’origine de l’erreur et les étapes à suivre pour la résoudre : 

• INVALID_QUERY_LOCATOR_FORMAT
• LOCATOR_LOCATION_EXCEEDS_SIZE
• QUERY_LOCATOR_EXPIRED
• TEMPORARY_QUERY_MORE_FAILURE
• UNAUTHORIZED_USER_FOR_CURSOR

Référence 

• Guide du développeur d’API SOAP Salesforce : query()
• Guide du développeur d’API REST Salesforce : requête
• Limites SOQL et SOSL associées aux requêtes de recherche
• Types de données de base utilisés dans les appels d’API
• Guide du développeur Apex : utilisation des variables Apex dans les requêtes SOQL et SOSL