索引键的热图模式

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

均匀分布使用量

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

基于顺序键的索引

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

索引上常见热点的一些示例如下：

由于时间戳递增而导致的热点问题

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

由于媒体资源名称越来越多，导致热点过多

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

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

了解索引键结构

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

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

NAMESPACE: NS KIND: Users 
PROPERTIES: (Timestamp: DESC, Name: DESC)
ANCESTOR: KEY(PROJECT('PROJECT_ID'),NAMESPACE('NS'),`UserList`,1)
VALUES: (16500000000000001,'Alice')
ENTITY:KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`UserList`,1,`User`,5000000000000001)

其中：

• NAMESPACE：实体的命名空间。
• KIND：实体的种类，用于对实体进行分类。
• 属性：与实体相关的属性。__key__ 排序属性仅针对修改默认排序的索引定义显示。
• ANCESTOR：可选的祖先路径，用于在数据库层次结构中确定实体的位置。
• VALUES：每个媒体资源的值。
• ENTITY：在操作中更新的实体的 ID。

在前面的示例中，从 PROPERTIES 值中确定属性，以查找受影响的索引。

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

1. 前往 Google Cloud 控制台中的 Datastore 模式“索引”页面。

   前往 Datastore 模式的索引

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

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

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

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

• 内置索引：排除该属性，以便索引不为该属性保留索引条目。如需了解详情，请参阅排除的媒体资源。
• 复合索引：修改 index.yaml 文件中的索引，确保不会选择值单调递增或递减的字段作为编入索引的第一个字段，或者删除该索引。如需了解详情，请参阅 index.yaml 简介。

热图上索引键条目示例

后续步骤

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