Referensi laporan Query Explain

Referensi laporan Query Explain

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

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

Data rencana

Kunci	Jenis	Kolom dapat berubah?	Deskripsi
indexes_used	Daftar Struktur Umum	Ya, konten 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. Misalnya: Collection, Collection Group, dan Includes Ancestors.
properties	String	Kolom indeks dalam format. Misalnya: (age ASC, __name__ ASC).

Statistik eksekusi

Statistik eksekusi gabungan untuk kueri.

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

Statistik debug

Hasil berikut berguna untuk men-debug kasus penggunaan dan analisis statistik mentah dan 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	Struct Generik	Detail penagihan termasuk metrik seperti: "documents_billable", "index_entries_billable", "knn_vector_index_entries_billable", "min_query_cost".