Référence du rapport "Explication des requêtes"

Référence du rapport "Explication des requêtes"

Les valeurs suivantes sont renvoyées en tant que résultats des opérations effectuées avec Firestore Query Explain.

Remarque : L'outil "Expliquer la requête" est conçu pour effectuer des analyses ponctuelles utiles. Le format de son rapport évoluera pour maximiser la facilité de lecture et de compréhension, et non pour s'adapter au traitement par machine. Certaines métriques devraient changer à mesure que Firestore en mode natif évolue (c'est-à-dire qu'elles peuvent être ajoutées, supprimées ou mises à jour). Elles ne sont pas couvertes par la même règle d'obsolescence que les autres API Firestore en mode natif. Les tableaux suivants indiquent les parties des données susceptibles d'être modifiées.

Enregistrements du plan

Clé	Type	Le champ est-il susceptible d'être modifié ?	Description
indexes_used	Liste des structs génériques	Oui, le contenu de la réponse Struct est susceptible d'être modifié.	Liste des index sélectionnés pour cette requête. Voir ci-dessous.

Index utilisés

Le contenu des index utilisés est susceptible de changer à mesure que Firestore en mode natif évolue.

Clé	Type	Description
query_scope	Chaîne	Champ d'application dans lequel une requête est exécutée. Par exemple :Collection, Collection Group et Includes Ancestors.
du bucket	Chaîne	Champs d'index dans un format. Par exemple, (age ASC, __name__ ASC).

Statistiques d'exécution

Statistiques d'exécution agrégées pour la requête.

Clé	Type	Le champ est-il susceptible d'être modifié ?	Description
results_returned	long	Non	Nombre total de résultats renvoyés, y compris les documents, les projections, les résultats d'agrégation et les clés.
execution_duration	Durée	Non	Temps total d'exécution de la requête dans le backend.
read_operations	long	Non	Nombre total d'opérations de lecture facturables.
debug_stats	Structure générique	Oui, le contenu de la réponse Struct est susceptible d'être modifié.	Statistiques de débogage issues de l'exécution de la requête. Voir ci-dessous.

Statistiques de débogage

Les résultats suivants sont utiles pour le débogage des cas d'utilisation et l'analyse des statistiques brutes et facultatives.

Le contenu des statistiques de débogage est susceptible de changer à mesure que Firestore en mode natif évolue.

Clé	Type	Description
index_entries_scanned	Chaîne	Nombre total d'entrées d'index inspectées lors de la requête.
documents_scanned	Chaîne	Nombre total de documents analysés lors de la requête.
billing_details	Structure générique	Informations de facturation, y compris des métriques telles que "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable", "min_query_cost".