Referencia del informe de explicación de consultas

Referencia del informe de explicación de consultas

Los siguientes valores se muestran como resultados de las operaciones realizadas con Firestore Query Explain.

Nota: Query Explain está diseñado para realizar análisis ad hoc útiles. El formato de sus informes evolucionará para facilitar la lectura y la comprensión, no la idoneidad para el procesamiento automático. Se espera que cambien algunas métricas a medida que evoluciona Firestore en modo nativo (es decir, se pueden agregar, quitar o actualizar métricas). No están cubiertas por la misma política de baja que otras APIs de Firestore en modo nativo. En las siguientes tablas, se indican 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 Structs genéricos	Sí, el contenido de la respuesta de Struct está sujeto a cambios.	Es la lista de índices seleccionados para esta búsqueda. Consulta a continuación.

Índices utilizados

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

Clave	Tipo	Descripción
query_scope	String	Es el alcance en el que se ejecuta una búsqueda. Por ejemplo: Collection, Collection Group y Includes Ancestors.
del bucket	String	Son los campos de índice en un formato. Por ejemplo: (age ASC, __name__ ASC).

Estadísticas de ejecución

Son las estadísticas de ejecución agregadas de la consulta.

Clave	Tipo	¿El campo está sujeto a cambios?	Descripción
results_returned	long	No	Es la cantidad total de resultados que se devolvieron, incluidos documentos, proyecciones, resultados de agregación y claves.
execution_duration	Duración	No	Es el tiempo total para ejecutar la consulta en el backend.
read_operations	long	No	Operaciones de lectura facturables totales.
debug_stats	Struct genérico	Sí, el contenido de la respuesta de Struct está sujeto a cambios.	Son las estadísticas de depuración de la ejecución de la consulta. Consulta a continuación.

Estadísticas de depuración

Los siguientes resultados son útiles para depurar casos de uso y analizar estadísticas sin procesar y opcionales.

El contenido de las estadísticas de depuración está sujeto a cambios a medida que evoluciona Firestore en modo nativo.

Clave	Tipo	Descripción
index_entries_scanned	String	Es la cantidad total de entradas de índice que se inspeccionaron durante la búsqueda.
documents_scanned	String	Es la cantidad total de documentos analizados durante la búsqueda.
billing_details	Struct genérico	Detalles de facturación, incluidas métricas como "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable" y "min_query_cost".