Référence de rapport Query Explain

Référence de rapport Query Explain

Preview

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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

Remarque :Query Explain est conçu pour une analyse ad hoc utile. Son format de rapport évoluera pour optimiser sa facilité de lecture et de compréhension, et non pour faciliter le traitement en machine. Certaines métriques sont susceptibles de changer à mesure que Firestore évolue (c'est-à-dire que des métriques peuvent être ajoutées, supprimées ou mises à jour). De plus, elles ne sont pas couvertes par le même règlement d'obsolescence que les autres API Firestore. Les tableaux suivants indiquent les parties des données susceptibles d'être modifiées.

Enregistrements du forfait

Clé	Type	Ce champ est susceptible d'être modifié ?	Description
indexes_used	Liste des Structures 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 d'être modifié à mesure que Firestore évolue.

Clé	Type	Description
query_scope	Chaîne	Champ d'application auquel une requête est exécutée. Exemples : 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	Ce champ est 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	Durée totale d'exécution de la requête dans le backend.
read_operations	long	Non	Nombre total d'opérations de lecture facturables.
debug_stats	Struct générique	Oui, le contenu de la réponse Struct est susceptible d'être modifié.	Déboguer les statistiques de l'exécution de la requête Voir ci-dessous.

Statistiques de débogage

Les résultats suivants sont utiles pour déboguer les cas d'utilisation et analyser les statistiques brutes facultatives.

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

Clé	Type	Description
index_entries_scanned	Chaîne	Nombre total d'entrées d'index inspectées pendant la requête.
documents_scanned	Chaîne	Nombre total de documents scannés au cours de la requête.
billing_details	Struct générique	Informations de facturation comprenant des métriques telles que "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable", "min_query_cost".