Riferimento report QueryExplain

Riferimento report QueryExplain

I seguenti valori vengono restituiti come risultati delle operazioni eseguite con Firestore Query Explain.

Nota: Query Explain è progettato per un'utile analisi ad hoc; il formato dei report si evolverà per massimizzare la facilità di lettura e la comprensione, ma non per l'elaborazione automatica. Alcune metriche dovrebbero cambiare con l'evoluzione di Firestore (ovvero, le metriche possono essere aggiunte, rimosse o aggiornate) e non sono coperte dagli stessi criteri di ritiro delle altre API Firestore. Le seguenti tabelle indicano quali parti dei dati sono soggette a modifiche.

Record del piano

Chiave	Tipo	Il campo è soggetto a modifiche?	Descrizione
indexes_used	Elenco di strutture generiche	Sì, i contenuti della risposta di struct sono soggetti a modifica.	Elenco degli indici selezionati per questa query. Consulta di seguito.

Indici utilizzati

I contenuti degli indici utilizzati sono soggetti a modifiche man mano che Firestore si evolve.

Chiave	Tipo	Descrizione
query_scope	String	L'ambito in cui viene eseguita una query. Ad esempio: Collection, Collection Group e Includes Ancestors.
proprietà	String	I campi dell'indice in un formato. Ad esempio: (age ASC, __name__ ASC).

Statistiche di esecuzione

Statistiche di esecuzione aggregate per la query.

Chiave	Tipo	Il campo è soggetto a modifiche?	Descrizione
results_returned	lunghi	No	Numero totale di risultati restituiti, inclusi documenti, proiezioni, risultati dell'aggregazione e chiavi.
execution_duration	Durata	No	Tempo totale per l'esecuzione della query nel backend.
read_operations	lunghi	No	Operazioni di lettura fatturabili totali.
debug_stats	Struct generico	Sì, i contenuti della risposta di struct sono soggetti a modifica.	Statistiche di debug dall'esecuzione della query. Consulta di seguito.

Statistiche di debug

I seguenti risultati sono utili per il debug dei casi d'uso e l'analisi di statistiche facoltative non elaborate.

I contenuti delle statistiche di debug sono soggetti a modifiche man mano che Firestore si evolve.

Chiave	Tipo	Descrizione
index_entries_scanned	String	Numero totale di voci di indice controllate durante la query.
documents_scanned	String	Numero totale di documenti scansionati durante la query.
billing_details	Struct generico	Dettagli di fatturazione che includono metriche come: "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable", "min_query_cost".