索引键的热图模式

本页介绍了您可能会在 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。
• 了解如何详细探索热图。
• 了解可以在热图中查看的指标。