Loading

Error "INVALID_QUERY_LOCATOR"

Fecha de publicación: Apr 24, 2026
Descripción

El error INVALID_QUERY_LOCATOR y los códigos de error ampliados relacionados indican que el ubicador de consultas incluido en una llamada para resultados de consulta adicionales no es válido o no existe. 

Solución

 

Descripción general de ubicadores de consultas

Cuando no se pueden devolver resultados de una consulta grande o compleja en una única respuesta, se crea uno o más cursores del lado del servidor. Los cursores apuntan a la ubicación de los resultados de consulta adicionales en la base de datos. Estos resultados adicionales se recuperan utilizando un ubicador de consultas dentro de otra llamada, como la llamada queryMore() en la API de SOAP o el campo nextRecordUrl en la API de REST. 

Por ejemplo, considere una llamada de consulta donde el tamaño de lotes esté establecido en 2.000 y la organización tiene más de 2.000 cuentas. En este escenario, SELECT id FROM account devuelve 2.000 registros y un ubicador de consulta, que indica dónde puede encontrar y recuperar la llamada adicional los registros restantes. 

Un ubicador de consulta tiene 18 caracteres de longitud y comienza con el prefijo 0r8. Cada ubicador y sus resultados asociados está disponible durante 2 días después de la ejecución inicial de la consulta. El uso de un ubicador de consulta no válido o caducado en una llamada lanza un error.

Utilizar detalles de errores ampliados para solucionar problemas

El mensaje de error INVALID_QUERY_LOCATOR y estos códigos de error ampliados asociados ofrecen información sobre la causa del error y el modo de resolverlo: 

 
  • INVALID_QUERY_LOCATOR_FORMAT
  • LOCATOR_LOCATION_EXCEEDS_SIZE
  • QUERY_LOCATOR_EXPIRED
  • TEMPORARY_QUERY_MORE_FAILURE
  • UNAUTHORIZED_USER_FOR_CURSOR

 

Referencia 

Número del artículo de conocimiento

000384958

 
Cargando
Salesforce Help | Article