索引键的热图模式

本页介绍了您可能会在 Key Visualizer 热图中看到的模式示例。这些模式可帮助您排查特定的性能问题。

均匀分布使用量

如果热图显示深色与亮色交织的粒状混合，则表示索引键的写入/删除操作均匀分布在整个数据库中。此热图可能表示 Firestore 的有效使用模式。

顺序键的索引

具有一条亮对角线的热图可以指示索引位于严格递增或递减的键（例如时间戳）上。不建议对顺序键建立索引，因为这可能会创建热点。出现热点问题时，您可能会观察到相应的延迟时间增加。

以下是一些常见的指数热点：

因时间戳递增而导致的热点

在此示例中，具有一条亮对角线的热图可以指示使用时间戳字段名称上严格递增或递减的索引写入/删除操作的数据库。

因字段名称数量增加而导致的热点

在此示例中，具有一条亮对角线的热图可以指示使用严格递增或递减的索引写入/删除操作的数据库，这些操作针对的是增量字段，例如自动生成的账单编号。

如需找出热点问题，请使用 Key Visualizer 工具并了解索引键结构，以确定哪个索引导致了问题，并按照最佳实践豁免这些索引。

了解索引键结构

在了解 Key Visualizer 工具中显示的索引键的结构之前，请先了解 Firestore 中的索引。

以下代码显示了一个示例索引键格式，当您将鼠标悬停在热图上受影响的键范围上时，系统会显示此格式。

COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
  PROPERTIES: (Timestamp: DESC) 
  VALUES: (16500000000000001)
  DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001

其中：

• COLLECTION：数据库中集合的位置。根据范围，它可以是集合范围的集合路径，也可以是集合组范围的集合名称。
• 属性：用于创建索引的字段。__name__ 排序属性仅针对修改默认排序的索引定义显示。
• VALUES：每个属性的值。
• DOCUMENT：相应操作中更新的文档的 ID。

在前面的示例中，从 PROPERTIES 值中确定字段，以找到受影响的索引。

如需查找索引，请完成以下步骤：

1. 在 Google Cloud 控制台中，前往数据库页面。

   前往“数据库”

2. 从数据库列表中选择所需的数据库。

3. 在导航菜单中，点击索引。

4. 前往复合或单字段标签页。

   您可以通过分析 PROPERTIES 字段来确定索引的类型。如需了解详情，请参阅索引键示例。

5. 点击过滤条件，选择字段，然后输入字段名称。

   对于复合索引，请使用 OR 运算符添加更多字段。

确定导致问题的索引后，您可以尝试以下解决方案：

• 复合索引：修改索引，确保不选择值单调递增或递减的字段作为索引的第一个字段，或者删除索引。

• 单字段索引：为要排除的字段和排序顺序添加例外项。如需了解详情，请参阅添加单字段豁免。

热图上的索引键条目示例

后续步骤

• 了解如何开始使用 Key Visualizer。
• 了解如何详细探索热图。
• 了解可以在热图中查看的指标。