使用 Query Insights 提高查询性能

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页面介绍了如何使用查询数据分析信息中心检测和分析性能问题。

简介

Query Insights 可帮助您检测、诊断和阻止 Cloud SQL 数据库的查询性能问题。它支持直观监控并提供诊断信息，帮助您在检测范围之外确定性能问题的根本原因。

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

• 查看热门查询的数据库负载
• 确定可能存在问题的查询

适用于 Cloud SQL 企业 Plus 版的 Query Insights

如果您使用的是 Cloud SQL 企业 Plus 版，则可以在 Query Insights 中访问其他功能，以执行高级查询性能诊断。除了 Query Insights 信息中心的标准功能之外，适用于 Cloud SQL 企业 Plus 版的 Query Insights 还可让您执行以下操作：

• 捕获更长的查询文本（最多 20 KB）
• 维持更长的 30 天指标保留期限
• 从索引顾问处获取索引建议
• 终止活跃查询中的会话

下表比较了适用于 Cloud SQL 企业版的 Query Insights 与适用于 Cloud SQL 企业 Plus 版的 Query Insights 的功能要求和功能。

如需在预览版期间为 Cloud SQL 企业 Plus 版实例启用适用于 Cloud SQL 企业 Plus 版的 Query Insights，请按照启用适用于 Cloud SQL 企业 Plus 版的 Query Insights 中的步骤操作。

价格

Query Insights 不会产生额外费用。此外，可免费启用适用于 Cloud SQL 企业 Plus 版的 Query Insights，该功能目前处于预览版阶段。

存储空间要求

Query Insights 会在实例上存储指标数据，并且需要您使存储空间自动扩容设置保持启用状态。需支付适用的存储空间费用。

准备工作

在使用 Query Insights 之前，请执行以下操作。

1. 添加所需的角色和权限。
2. 确保为实例启用启用存储空间自动扩容功能这一设置。

所需的角色和权限

如需使用 Query Insights，您需要授予具有所需 Identity and Access Management 权限的角色，或者为用户账号提供所需权限。

如需详细了解如何授予角色，请参阅管理访问权限。

如需获得访问 Query Insights 信息中心内的历史查询执行数据所需的权限，请让您的管理员向您授予托管 Cloud SQL 实例的项目的以下 IAM 角色：

• Database Insights Monitoring Viewer (roles/databaseinsights.monitoringViewer)
• Cloud SQL Viewer (roles/cloudsql.viewer)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色包含访问 Query Insights 信息中心内的历史查询执行数据所需的权限。如需查看所需的确切权限，请展开所需权限部分：

您也可以使用自定义角色或其他预定义角色来获取这些权限。

• Cloud SQL Editor (roles/cloudsql.editor)
• Cloud SQL Admin (roles/cloudsql.admin)

启用存储空间自动扩容功能

如果您之前停用了此实例设置，请先重新启用存储空间自动扩容功能，然后再启用 Query Insights。

启用 Query Insights

有权访问 Cloud SQL 信息中心的用户可以访问 Query Insights 指标。如果您有权更新实例，则可以启用 Query Insights。如需查看 Cloud SQL 实例所需的权限列表，请参阅 Cloud SQL 项目访问权限控制。如果您没有这些权限，并且想要在实例上启用 Query Insights，请与您的管理员联系。

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled
  

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--tier=API_TIER_STRING \
--region=REGION
  

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : true } }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Query Insights 在查询完成后的几分钟内就可以提供指标。

启用适用于 Cloud SQL 企业 Plus 版的 Query Insights

您只能使用 Google Cloud 控制台为 Cloud SQL 实例启用适用于 Cloud SQL 企业 Plus 版的 Query Insights。

1. 在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

   转到“Cloud SQL 实例”

2. 如需打开实例的概览页面，请点击实例名称。
3. 点击修改。
4. 在存储空间部分，确认已选中启用存储空间自动扩容功能复选框。
5. 在自定义实例部分中，展开 Query Insights。
6. 选中启用企业 Plus 版功能复选框。

7. 启用适用于 Cloud SQL 企业 Plus 版的 Query Insights 后，您可以更新以下字段：

   • 自定义查询长度：指定查询长度的限制（以字节为单位）。您可以指定 256 到 20480 之间的数字。任何超出指定限制的查询字符串在显示时都会被截断。查询长度限制越高，需要的内存就越多。默认值为 10240 字节 (10 KB)。

8. 点击保存。

查看查询数据分析信息中心

查询数据分析信息中心会基于您选择的因素显示查询负载。查询负载是衡量选定时间范围内实例中所有查询的总工作量。 该信息中心提供了一系列过滤条件，可帮助您查看查询负载。

如需打开查询数据分析信息中心，请按照以下步骤操作：

1. 如需打开实例的概览页面，请点击实例名称。
2. 选择左侧导航面板中的 Query Insights 标签页，或点击前往“查询数据分析”，详细了解查询和性能链接。

查询数据分析信息中心将会打开。它会显示有关实例的以下信息：

• 数据库：过滤特定数据库或所有数据库上的查询负载。
• 时间范围：按时间范围（如 1 小时、6 小时、1 天、7 天、30 天或自定义范围）过滤查询。
• 数据库负载图表：根据过滤的数据显示查询负载图表。
• 查询和数据库：按所选查询或所选数据库过滤查询负载。请参阅过滤数据库负载。

查看所有查询的数据库负载

数据库查询负载用于衡量所选数据库中执行的查询在一段时间内所执行的工作（以 CPU 秒为单位）。每个正在运行的查询都使用或等待 CPU 资源、IO 资源或锁定资源。数据库查询负载是在给定时间范围内完成的所有查询所花费的时间与挂钟时间之比。

顶级 Query Insights 信息中心显示数据库负载（按执行时间）图表。通过该信息中心上的下拉菜单，您可以针对所有数据库或特定数据库过滤该图表。

图表中的彩色线条表示每个数据库负载（按执行时间）。查看图表并使用过滤选项来探索以下问题：

• 查询负载较高吗？图表是否随着时间推移出现峰值或上升？如果未看到高负载，则问题与您的查询无关。
• 负载高的时间有多长？是现在才高还是长时间都高？使用范围选择器选择不同的时间段，以了解问题持续了多长时间。放大可查看观察到查询负载峰值的时间窗口。缩小可查看长达一周的时间轴。
• 哪个数据库遇到了负载？从“数据库”下拉菜单中选择不同的数据库，找出负载最高的数据库。

过滤数据库负载

• 所有查询

• 数据库

如需自定义数据库负载图表，请从数据库负载（按执行时间）下拉菜单中选择一个维度。

查看数据库负载的主要影响因素

如需查看数据库负载的主要影响因素，您可以使用主要维度（按数据库负载）表格。主要维度（按数据库负载）表格会针对您在数据库负载（按执行时间）图表下拉菜单中选择的时间段和维度，显示相应的主要影响因素。您可以修改时间段或维度，以查看不同维度或时间段的相应主要影响因素。

在主要维度（按数据负载）表格中，您可以选择以下标签页。

按查询过滤

查询表概述了导致查询加载次数最多的查询。下表显示了查询数据分析信息中心内所选时间范围和选项的所有标准化查询。它会按您选择的时间段内总执行时间对查询排序。

如需对表格进行排序，请选择列标题。表格会显示以下属性：

• 查询：标准化查询字符串。默认情况下，Query Insights 仅显示查询字符串中的 1024 个字符。
• 数据库：对其运行查询的数据库。
• 平均执行时间（毫秒）：查询执行的平均时间。
• 总执行时间（毫秒）：查询执行的总时间。
• 调用次数：应用调用查询的次数。
• 返回的平均行数：为查询返回的平均行数。

Query Insights 仅存储和显示标准化查询。

停用 Query Insights

gcloud sql instances patch INSTANCE_ID 

--no-insights-config-query-insights-enabled
    

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

停用适用于 Cloud SQL 企业 Plus 版的 Query Insights

如需停用适用于 Cloud SQL 企业 Plus 版的 Query Insights，请执行以下操作：

1. 在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

   转到“Cloud SQL 实例”

2. 如需打开实例的概览页面，请点击实例名称。
3. 点击修改。
4. 在自定义实例部分中，展开 Query Insights。
5. 清除启用企业 Plus 版功能复选框。
6. 点击保存。

后续步骤

• 发布博客：为开发者提供数据库可观测性：隆重推出 Cloud SQL Insights
• 博客：使用 Cloud SQL Insights 提升您的查询性能问题排查技能
• 视频：介绍 Cloud SQL Insights
• 播客：Cloud SQL Insights
• Insights Codelab
• 优化高 CPU 用量
• 优化高内存用量