Query Explain 报告参考

使用 Firestore 查询说明执行的操作会返回以下值。

方案记录

键	类型	字段是否会发生变化？	说明
indexes_used	通用结构体列表	是，结构体响应中的内容可能会发生变化。	为此查询选择的索引列表。请参阅下文。

使用的索引

随着 Firestore 的不断发展，所用索引的内容可能会发生变化。

键	类型	说明
query_scope	字符串	查询的运行范围。例如：Collection、Collection Group 和 Includes Ancestors。
属性	字符串	采用某种格式的索引字段。例如：(age ASC, __name__ ASC)。

执行统计信息

查询的汇总执行统计信息。

键	类型	字段是否会发生变化？	说明
results_returned	long	否	返回的结果总数，包括文档、投影、汇总结果、键。
execution_duration	时长	否	在后端执行查询的总时间。
read_operations	long	否	应计费读取操作总数。
debug_stats	泛型结构体	是，结构体响应中的内容可能会发生变化。	查询执行的调试统计信息。 请参阅下文。

调试统计信息

以下结果有助于调试用例和分析可选的原始统计数据。

调试统计信息的内容可能会随着 Firestore 的演变而发生变化。

键	类型	说明
index_entries_scanned	字符串	查询期间检查的索引条目总数。
documents_scanned	字符串	查询期间扫描的文档总数。
billing_details	泛型结构体	结算详情，包括“documents_billable”“index_entries_billable”“knn_vector_index_entries_billable”“min_query_cost”等指标。