Referencia del informe "Explicación de la consulta"

Referencia del informe "Explicación de la consulta"

Los siguientes valores se devuelven como resultados de las operaciones realizadas con Explicación de consulta de Firestore.

Nota: Query Explain se ha diseñado para realizar análisis ad hoc útiles. El formato de sus informes evolucionará para maximizar la facilidad de lectura y comprensión, no para adaptarse al procesamiento automático. Es de esperar que algunas métricas cambien a medida que evolucione Firestore en modo nativo (es decir, que se añadan, eliminen o actualicen métricas) y no estén cubiertas por la misma política de discontinuación que otras APIs de Firestore en modo nativo. En las siguientes tablas se indica qué partes de los datos están sujetas a cambios.

Registros de planes

Clave	Tipo	¿El campo está sujeto a cambios?	Descripción
indexes_used	Lista de estructuras genéricas	Sí, el contenido de la respuesta Struct está sujeto a cambios.	Lista de índices seleccionados para esta consulta. Consulta la información que aparece más abajo.

Índices usados

El contenido de los índices utilizados está sujeto a cambios a medida que evoluciona Firestore en modo nativo.

Clave	Tipo	Descripción
query_scope	Cadena	El ámbito en el que se ejecuta una consulta. Por ejemplo: Collection, Collection Group y Includes Ancestors.
properties	Cadena	Los campos de índice en un formato. Por ejemplo: (age ASC, __name__ ASC).

Estadísticas de ejecución

Estadísticas de ejecución agregadas de la consulta.

Clave	Tipo	¿El campo está sujeto a cambios?	Descripción
results_returned	long	No	Número total de resultados devueltos, incluidos documentos, proyecciones, resultados de agregación y claves.
execution_duration	Duración	No	Tiempo total para ejecutar la consulta en el backend.
read_operations	long	No	Total de operaciones de lectura facturables.
debug_stats	Estructura genérica	Sí, el contenido de la respuesta Struct está sujeto a cambios.	Estadísticas de depuración de la ejecución de la consulta. Consulta la información que aparece más abajo.

Estadísticas de depuración

Los siguientes resultados son útiles para depurar casos prácticos y analizar estadísticas sin procesar opcionales.

El contenido de las estadísticas de depuración puede cambiar a medida que evoluciona Firestore en modo nativo.

Clave	Tipo	Descripción
index_entries_scanned	Cadena	Número total de entradas de índice inspeccionadas durante la consulta.
documents_scanned	Cadena	Número total de documentos analizados durante la consulta.
billing_details	Estructura genérica	Detalles de facturación, incluidas métricas como "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable" y "min_query_cost".