分析查询性能

本页介绍了如何使用 Query Insights 信息中心检测和分析 Spanner 性能问题。

查询数据分析概览

Query Insights 可帮助您检测和诊断 Spanner 数据库的查询和 DML（INSERT、UPDATE 和 DELETE）语句性能问题。它支持直观监控并提供诊断信息，帮助您不仅仅在检测范围内确定性能问题的根本原因。

查询数据分析可以指导您完成以下步骤，帮助您提高 Spanner 查询性能：

  1. 确认是否是低效查询导致了高 CPU 利用率。
  2. 确定可能存在问题的查询或标记。
  3. 分析查询或请求标记以确定问题。

查询分析适用于单区域配置和多区域配置。

价格

查询数据分析不会产生额外费用。

数据保留

查询数据分析的最长数据保留期为 30 天。对于总 CPU 利用率（按每个查询或请求标记）图表，系统会从 SPANNER_SYS.QUERY_STATS_TOP_* 表中提取数据，这些数据的保留期限最长为 30 天。如需了解详情，请参阅数据保留。

所需的角色

根据您是 IAM 用户还是精细访问权限控制用户，您需要不同的 IAM 角色和权限。

Identity and Access Management (IAM) 用户

如需获得查看“查询数据分析”页面所需的权限，请让您的管理员向您授予实例的以下 IAM 角色：

若要查看“查询分析”页面，您需要拥有 Cloud Spanner Database Reader(roles/spanner.databaseReader) 角色中的以下权限：

  • spanner.databases.beginReadOnlyTransaction
  • spanner.databases.select
  • spanner.sessions.create

精细访问权限控制用户

如果您是精细访问权限控制用户，请确保：

  • 拥有 Cloud Spanner Viewer(roles/spanner.viewer)
  • 拥有精细访问权限控制权限，并被授予 spanner_sys_reader 系统角色或其成员角色之一。
  • 在数据库概览页面上，选择 spanner_sys_reader 或成员角色作为您的当前系统角色。

如需了解详情，请参阅精细访问权限控制简介和精细访问权限控制系统角色。

查询数据分析信息中心

Query Insights 信息中心会根据您选择的数据库和时间范围显示查询负载。查询负载是衡量选定时间范围内实例中所有查询的总 CPU 利用率。该信息中心提供了一系列过滤条件，可帮助您查看查询负载。

如需查看数据库的“查询数据分析”信息中心，请执行以下操作：

  1. 在左侧导航面板中选择查询数据分析。查询数据分析信息中心随即打开。
  2. 从数据库列表中选择一个数据库。该信息中心会显示数据库的查询负载信息。

信息中心包含以下部分：

  1. 数据库列表：过滤特定数据库或所有数据库上的查询负载。
  2. 时间范围过滤条件：按时间范围（如小时、天或自定义范围）过滤查询。
  3. “总 CPU 利用率（所有查询）”图表：显示所有查询的汇总负载。
  4. 总 CPU 利用率（按每个查询或请求标记）图表：显示每个查询或请求标记的 CPU 利用率。
  5. “排名前 N 的查询和标记”表：显示按 CPU 使用率排序的热门查询和请求标记列表。请参阅确定可能存在问题的查询或标记。

查询数据分析信息中心

信息中心性能

使用查询参数或为查询添加标记可优化查询数据分析的性能。如果您未对查询进行参数化或添加标记，则可能会返回过多结果，这可能会导致“前 N 个查询和标记”表无法正常加载。

确认低效查询是否导致 CPU 利用率高

总 CPU 利用率用于衡量所选数据库中的已执行查询在一段时间内所执行的工作（以 CPU 秒为单位）。

所有查询的总 CPU 利用率

查看图表，探索以下问题：

  • 哪个数据库遇到了负载？从“数据库”列表中选择不同的数据库，找出负载最高的数据库。如需了解哪个数据库的负载最高，您还可以在 Google Cloud 控制台中查看数据库的 CPU 利用率 - 总计图表。

    数据库负载

  • CPU 利用率是否较高？图表是否随着时间推移或上升？如果未看到高 CPU 利用率，则问题与您的查询无关。

  • CPU 利用率高的时间有多长？是最近才出现峰值，还是一段时间以来一直很高？使用范围选择器选择不同的时间段，以了解问题持续了多长时间。放大以查看观察到查询负载峰值的时间范围。缩小以查看长达一周的时间轴。

如果您在图表中看到与实例总 CPU 用量相对应的峰值或上升幅度，则很可能是由于一个或多个耗费较高的查询所致。接下来，您可以通过找出可能存在问题的查询或请求标记，深入了解调试过程。

确定可能存在问题的查询或请求标记

如需确定可能存在问题的查询或请求标记，请查看“热门 N 个查询”部分：

排名前 N 的查询

在这里，我们可以看到，具有 FPRINT 6815864236081503267 的查询具有较高的 CPU 利用率，可能存在问题。

前 N 个查询表概述了所选时间段内 CPU 使用率最高的查询，并按从高到低的顺序排序。TopN 查询的数量上限为 100 个。

对于图表，我们会从“排名前 N 的查询”统计信息表中提取数据，该表具有 3 种不同的粒度：1 分钟、10 分钟和 1 小时。图表中每个数据点的值代表一分钟间隔内的平均值。

建议的最佳实践是向 SQL 查询添加标记。查询标记可帮助您在更高级别的构造中发现问题，例如业务逻辑或微服务。

排名前 N 的查询表

下表显示了以下属性：

  • FPRINT：请求代码的哈希值（如果存在）；否则，为查询的哈希值。

  • 查询或请求标记：如果查询有相关联的标记，系统会显示请求标记。具有相同标记字符串的多个查询的统计信息归为一行，其中 REQUEST_TAG 值与该标记字符串匹配。如需详细了解如何使用请求标记，请参阅使用请求标记和事务标记进行问题排查。

    如果查询没有关联的标记，系统会显示被截断至 64KB 左右的 SQL 查询。对于批处理 DML，SQL 语句会展平为一行，并使用英文分号分隔符串联。连续相同的 SQL 文本会在截断之前删除重复。

  • 查询类型：指示查询是 PARTITIONED_QUERY 还是 QUERY。PARTITIONED_QUERY 是一种查询，其中包含从 PartitionQuery API 获取的 partitionToken。所有其他查询和 DML 语句均采用 QUERY 查询类型表示。

  • CPU 利用率：查询的 CPU 资源消耗，以相应时间间隔内在数据库上运行的所有查询使用的总 CPU 资源的百分比表示，以介于 0 到 100 之间的水平条形显示。

  • CPU (%)：查询的 CPU 资源消耗，以相应时间间隔内在数据库上运行的所有查询使用的总 CPU 资源的百分比表示。

  • 执行次数：Spanner 在时间段内查看查询的次数。

  • 平均延迟时间（毫秒）：数据库中每个查询执行操作的平均时间长度（以微秒为单位）。该平均值不包括结果集编码和传输时间以及开销。

  • 平均扫描行数：查询扫描的平均行数，不包括已删除的值。

  • 平均返回行数：查询返回的平均行数。

  • 返回的字节数：查询返回的数据字节数，不包括传输编码开销。

图表之间可能存在的差异

您可能会注意到总 CPU 利用率（所有查询）图表和总 CPU 利用率（按每个查询或请求标记）图表之间存在一些差异。导致这种情况的原因有以下两种：

  • 不同数据源：用于填充“总 CPU 使用率（所有查询）”图表的 Cloud Monitoring 数据通常更准确，因为这些数据每分钟推送一次，保留期限为 45 天。另一方面，系统表数据（用于填充“总 CPU 利用率（按每个查询或请求标记）”图表）可能会基于 10 分钟（或 1 小时）内的平均值，在这种情况下，我们可能会丢失“总 CPU 利用率（所有查询）”图表中显示的高精细数据。

  • 不同的汇总时间范围：这两张图表采用不同的汇总时间范围。例如，在检查超过 6 小时的事件时，我们会查询 SPANNER_SYS.QUERY_STATS_TOTAL_10MINUTE 表。在这种情况下，发生于 10:01 的事件会在 10 分钟内汇总，并显示在与 10:10 时间戳对应的系统表中。

以下屏幕截图显示了此类方差的示例。

图表之间的差异

分析特定查询或请求标记

如需确定查询或请求标记是否为问题的根本原因，请点击看似负载最高或用时比其他查询或标记更久的查询或请求标记。您可以一次选择多个查询和请求标记。

您可以将鼠标指针悬停在时间轴上的查询图表上，了解其 CPU 使用率（以秒为单位）。

通过查看以下内容来缩小问题范围：

  • 负载高的时间有多长？只是现在高吗？还是长时间位于高负载？更改时间范围以查找查询开始效果不佳的日期和时间。
  • CPU 利用率是否存在急剧增加？您可以更改时间范围，以研究查询的历史 CPU 使用率。
  • 资源消耗量是多少？它与其他查询有何关系？ 查看表格，并将其他查询的数据与所选查询的数据进行比较。 有没有什么重大区别？

如需确认所选查询是否导致 CPU 占用率过高，您可以深入了解特定查询形状（或请求标记）的详细信息，并在“查询详情”页面上对其进行进一步分析。

查看“查询详情”页面

如需以图形形式查看特定查询形状或请求标记的详细信息，请点击与查询形状或请求标记关联的 FPRINT。“查询详情”页面随即打开。

“查询详情”页面

“查询详情”页面会显示以下信息：

  1. Query details text：SQL 查询文本，被截断至 64KB 左右。 具有相同标记字符串的多个查询的统计信息归为一行，其中 REQUEST_TAG 与该标记字符串匹配。此字段中仅显示其中一个查询的文本。对于批处理 DML，这组 SQL 语句会展平为一行，并使用英文分号分隔符串联。连续相同的 SQL 文本会在截断之前删除重复。
  2. 以下字段的值：
    • 执行次数：Spanner 在时间段内查看查询的次数。
    • 平均 CPU（毫秒）：在指定时间间隔内，实例 CPU 资源查询的平均 CPU 资源消耗（以毫秒为单位）。
    • 平均延迟时间（毫秒）：数据库中每个查询执行的平均时间长度（以毫秒为单位）。该平均值不包括结果集的编码和传输时间以及开销。
    • 平均返回行数：查询返回的平均行数。
    • 平均扫描行数：查询扫描的平均行数，不包括已删除的值。
    • 平均字节数：查询返回的数据字节数，不包括传输编码开销。
  3. “查询计划示例”图表：图表上的每个点都代表特定时间的抽样查询计划及其特定查询延迟时间。点击图表中的某个点可查看查询计划，并直观呈现查询执行期间采取的步骤。注意：对于从 PartitionQuery API 和分区 DML 查询中获取 partitionToken 的查询，不支持查询计划。
  4. 查询计划可视化工具：显示所选的采样查询计划。图表上的每个节点（或卡片）表示一个迭代器，该迭代器使用其输入的行，并将行生成到其父行。您可以点击每个迭代器，查看展开式信息。
  5. 查询延迟时间图表：显示所选查询在一段时间内的查询延迟时间值。它还会显示平均延迟时间。
  6. CPU 利用率图表：显示一段时间内查询的 CPU 利用率（以百分比表示）。它还会显示平均 CPU 利用率。
  7. “执行次数/失败次数”图表：显示一段时间内查询的执行次数以及查询执行失败的次数。
  8. “扫描的行数”图表：显示查询在一段时间内扫描的行数。
  9. “返回的行数”图表：显示查询在一段时间内返回的行数。
  10. 时间范围过滤条件：按时间范围（如小时、天或自定义范围）过滤查询详情。

对于图表，我们会从“排名前 N 的查询”统计信息表中提取数据，该表具有 3 种不同的粒度：1 分钟、10 分钟和 1 小时。图表中每个数据点的值代表一分钟间隔内的平均值。

在审核日志中搜索查询的所有执行

如需在 Cloud Audit Logs 中搜索特定查询指纹的所有执行，请查询审核日志，然后在 TopN 查询统计信息表中搜索与 FPRINT 字段匹配的任何 query_fingerprint。如需了解详情，请参阅查询和查看日志概览。使用此方法可识别发起查询的用户。