Referensi laporan Penjelasan Kueri

Referensi laporan Penjelasan Kueri

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Nilai berikut ditampilkan sebagai hasil untuk operasi yang dilakukan dengan Firestore Query Explain.

Catatan: Query Explain dirancang untuk analisis ad hoc yang berguna; format laporannya akan berkembang untuk memaksimalkan kemudahan membaca dan pemahaman, bukan kesesuaian untuk pemrosesan mesin. Beberapa metrik diperkirakan akan berubah seiring perkembangan Firestore (yaitu, metrik dapat ditambahkan, dihapus, atau diperbarui) dan tidak tercakup dalam kebijakan penghentian penggunaan yang sama dengan Firestore API lainnya. Tabel berikut menunjukkan bagian data mana yang dapat berubah.

Data rencana

Kunci	Jenis	Kolom dapat berubah sewaktu-waktu?	Deskripsi
indexes_used	Daftar Struct Generik	Ya, isi dalam respons Struct dapat berubah sewaktu-waktu.	Daftar indeks yang dipilih untuk kueri ini. Lihat di bawah.

Indeks yang digunakan

Konten indeks yang digunakan dapat berubah seiring perkembangan Firestore.

Kunci	Jenis	Deskripsi
query_scope	String	Cakupan tempat kueri dijalankan. Contoh: Collection, Collection Group dan Includes Ancestors.
properties	String	Kolom indeks dalam format. Contoh: (age ASC, __name__ ASC).

Statistik eksekusi

Statistik eksekusi gabungan untuk kueri.

Kunci	Jenis	Kolom dapat berubah sewaktu-waktu?	Deskripsi
results_returned	long	Tidak	Jumlah total hasil yang ditampilkan, termasuk dokumen, proyeksi, hasil agregasi, dan kunci.
execution_duration	Durasi	Tidak	Total waktu untuk menjalankan kueri di backend.
read_operations	long	Tidak	Total operasi baca yang dapat ditagih.
debug_stats	Struktur Generik	Ya, isi dalam respons Struct dapat berubah sewaktu-waktu.	Statistik proses debug dari eksekusi kueri. Lihat di bawah.

Statistik debug

Hasil berikut berguna untuk proses debug kasus penggunaan dan analisis statistik mentah opsional.

Konten statistik debug dapat berubah seiring perkembangan Firestore.

Kunci	Jenis	Deskripsi
index_entries_scanned	String	Jumlah total entri indeks yang diperiksa selama kueri.
documents_scanned	String	Jumlah total dokumen yang dipindai selama kueri.
billing_details	Struktur Generik	Detail penagihan termasuk metrik seperti: "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable", "min_query_cost".