数据库工作台 DBW 提供全量 SQL 洞察功能，该功能可以捕获、审查和分析所有的 SQL 语句，以此来帮助您提升数据库的性能和稳定性。本文介绍全量 SQL 洞察的注意事项、优势和开启、关闭、查看的操作步骤。

背景信息

全量 SQL 洞察功能支持自动记录和分析数据库内核生成的 SQL 语句，包括执行账号、IP 地址和执行详情等信息。其中 SQL语句类型包括 SELECT、INSERT、UPDATE、DELETE、ALTER、CREATE、DROP、RENAME、TRUNCATE 和 OTHER（其他全部 SQL 类型）。

优势

• CPU 消耗低：SQL 语句是数据库内核生成的，对系统的 CPU 资源消耗非常低。

• 提供全面视角：全量 SQL 洞察可以捕获和分析所有在数据库实例中运行的所有 SQL 语句，为您提供全面的视角，可以用于发现数据库实例的性能瓶颈。

• 问题定位和诊断：通过对实时监控和历史趋势的分析，全量 SQL 洞察可以帮助您定位和诊断数据库实例的问题，例如慢查询、并发死锁等。

• 优化数据库结构：全量 SQL 洞察功能可提供查看哪些表被经常使用，哪些 SQL 语句最耗费资源等信息，从而帮助您改进数据库的结构。

• 提升数据库的可用性和稳定性：全量 SQL 洞察可以帮助您更好地了解数据库实例的整体运行状况，从而提升数据库的可用性和稳定性。

注意事项

• 在使用全量 SQL 洞察过程中，由于 DBW 所统计的操作信息都是数据库内核分析所得，因此可能会被导致数据出现不准确的情况。同时，若查询数据较大时，也会导致数据不准确的情况。

• SQL 数据的存储空间是由 DBW 侧提供，不占用数据库实例的存储空间。

• 由于全量 SQL 洞察中的 SQL 明细所记录的均为 V2 版本的数据库审计信息，因此在开启全量 SQL 洞察时，默认同步开启 V2 版本的数据库审计，反之全量 SQL 洞察时，也会同步关闭关闭 V2 版本的数据库审计。

• 仅 20240415 及后续内核版本支持开启全量 SQL 洞察，您可以执行以下命令查看实例的内核版本，如需升级请参考手动升级实例内核小版本。关于内核小版本的更多信息，请参见内核小版本发布记录。

  select @@byte_rds_version;
  

• 推广期内支持免费存储 1 天。推广期后的存储费用由存储时长决定。具体收费信息，请参见日志服务的计费规则。

• 关闭全量 SQL 洞察时，所有的存储数据都将被清空，请在删除前请将所有数据都下载至本地，否则可能会导致数据丢失。

• 当实例被删除时，该实例的全量 SQL 洞察功能将被自动关闭。

• 全量 SQL 洞察中记录的 SQL 语句最大长度为 4096 字节，超过部分不再记录。其中云数据库 MySQL 版实例记录的 SQL 语句最大长度受参数控制：

  • 当参数取值小于等于 4096 字节时，SQL 语句最大长度为参数设定值，超过部分不再记录。由于信息采集处理时会增加前缀标注，实际记录的 SQL 语句最大长度略小于参数设定值。

  • 当参数取值大于 4096 字节时，SQL 语句最大长度为 4096 字节，超过部分不再记录。由于信息采集处理时会增加前缀标注，实际记录的 SQL 语句最大长度略小于 4096 字节。

费用

关于全量 SQL 洞察的计费信息，请参见计费项与价格。

前提条件

• 已创建云数据库 MySQL 版实例。详细操作，请参见创建实例。
• 若目标实例已开启安全管控，那么您需为当前账号申请目标实例的运维只读或运维读写权限。详细信息，请参见开启云数据库 MySQL 版实例安全管控和申请云数据库 MySQL 版相关操作权限。

开启全量 SQL 洞察

1. 登录 DBW 控制台。

2. 在顶部菜单栏，选择项目和地域。

3. 在左侧导航栏，选择运维管理 > 观测诊断。

4. 在运维观测页面左上角，单击下拉图标，选择目标实例。

   说明

   支持通过实例 ID 搜索切换目标实例。

5. 在目标实例页面，单击全量 SQL 洞察。

6. 在全量 SQL 洞察页签，设置以下参数信息：

   参数	说明
   需开通的功能	由于全量 SQL 洞察中的 SQL 明细所记录的均为 V2 版本的数据库审计信息，因此在开启全量 SQL 洞察之时，默认同步开启了 V2 版本的数据库审计。 更多关于 V2 版本的数据库审计信息，请参见数据库审计管理。
   SQL 存储时长	按需选择 SQL 数据存储时长，当前支持选择 1 天（默认值）、7 天、30 天、180 天、1 年或 3 年。数据库工作台 DBW 会将超出 SQL 存储时长的 SQL 日志清空。建议您将 SQL 日志下载保存至本地，方便后续查询。 说明 SQL 数据的存储空间是由 DBW 侧提供，不占用数据库实例的存储空间。
   存储 SQL 类型	默认支持勾选全部 SQL 类型，即存储所有 SQL 类型。您也可以按需勾选 SELECT、INSERT、UPDATE、DELETE、ALTER、CREATE、DROP、RENAME、TRUNCATE 和 OTHER（其他全部 SQL 类型）。
   配置费用	关于全量 SQL 洞察的收费标准，请参见计费项与价格。
   标签	标签用于标记资源，便于搜索和资源聚合。单击添加一行，设置标签键和标签值，为实例添加标签。标签键和标签值的配置规则如下： 不支持设置以任何形式的 volc: 为开头的 Key，例如 Volc:、VOLC: 等。 可以包含语言字符、数字、空格和英文符号，英文符号包括 _、.、:、/、=、+、- 和 @。 长度需在 1~128 个字符内。 使用 UTF-8 编码的 Unicode 格式。 说明 单次最多支持绑定 20 个标签，单个实例最多绑定 50 个标签。如需对标签进行统一管理，请参考标签管理。 同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个 Value。
   协议	阅读并勾选我已阅读并同意《数据库工作台 DBW 服务条款》。

7. 单击开启全量 SQL 洞察。

设置全量 SQL 洞察

1. 登录 DBW 控制台。

2. 在顶部菜单栏，选择项目和地域。

3. 在左侧导航栏，选择运维管理 > 观测诊断。

   1. 在页面右上角的下拉列表中，选择目标数据库类型即云数据库 MySQL 版。

   2. 在页面左上角下拉列表中，选择目标实例。

4. 在运维观测页面，单击全量 SQL 洞察。

5. 在全量 SQL 洞察页签，单击服务设置。

6. 在服务设置对话框，您可以进行以下操作：

   参数	说明
   关闭全量 SQL 洞察	关闭全量 SQL 洞察时，所有的存储数据都将被清空，请在删除前请将所有数据都下载至本地，否则可能会导致数据丢失。 说明 在关闭全量 SQL 洞察时，V2 版本的数据库审计亦会随之关闭。
   修改 SQL 存储时长	按需选择 SQL 数据存储时长，当前支持选择 1 天、7 天、30 天、180 天、1 年或 3 年。如果减少了 SQL 洞察和审计数据存储时长，那么 DBW 会立刻清空超过存储时长的 SQL 审计日志。建议您将 SQL 审计日志导出并保存至本地后，再降低 SQL 存储时长。
   设置标签	标签用于标记资源，便于搜索和资源聚合。单击标签后的编辑图标，设置标签键和标签值，为实例添加标签。标签键和标签值的配置规则如下： 不支持设置以任何形式的 volc: 为开头的 Key，例如 Volc:、VOLC: 等。 可以包含语言字符、数字、空格和英文符号，英文符号包括 _、.、:、/、=、+、- 和 @。 长度需在 1~128 个字符内。 使用 UTF-8 编码的 Unicode 格式。 说明 单次最多支持绑定 20 个标签，单个实例最多绑定 50 个标签。如需对标签进行统一管理，请参考标签管理。 同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个 Value。

7. 单击确定。

查看全量 SQL 信息

• 在全量 SQL 洞察功能中不仅支持查看全量 SQL 的趋势、SQL 模板还包括 SQL 明细。

• 当 SQL 语句执行成功时，仅表示该 SQL 语句在执行过程中未出现异常且已顺利完成执行。例如，在发生事务回滚的情况下，若事务中的单条 SQL 执行成功且无异常，则该条 SQL 会被判定为执行成功。

• 查询全量 SQL 洞察信息时，仅支持在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。如需查询更大时间范围的 SQL 记录，建议您导出后进行查询。导出功能会异步导出日志，适合大时间范围内的查询。

1. 登录 DBW 控制台。

2. 在顶部菜单栏，选择项目和地域。

3. 在左侧导航栏，选择运维管理 > 观测诊断。

4. 在运维观测页面左上角，单击下拉图标，选择目标实例。

   说明

   支持通过实例 ID 搜索切换目标实例。

5. 在目标实例页面，单击全量 SQL 洞察。

6. 在全量 SQL 洞察页签，查看全量 SQL 洞察信息、SQL 明细和 SQL 写分析，具体如下所示：

   类型	说明
   全量 SQL 洞察	在全量 SQL 洞察页签的全量 SQL 洞察子页签，查看实例内 SQL 的发展趋势和 SQL 模板列表。同时，也可以按需选择实例节点查看指定节点的全量 SQL 洞察信息。具体如下所示： 区间查看全量 SQL 洞察信息 在全量 SQL 洞察页签的全量 SQL 洞察子页签，按需选择需要查看全量 SQL 洞察的时间范围，您可以在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。由于 SQL 洞察记录所有数据库行为，会记录大量 SQL 语句，在线查询选择时间范围过大，会导致长时间没有返回查询结果，甚至查询超时。 查看选定时间段内实例的 SQL 发展趋势和 SQL 模板列表，具体如下所示： 全量 SQL 趋势：在指定时间段内，可查看 SQL 在执行耗时的性能分析和统计，在全量 SQL 趋势区域，您可以查看以下信息： 执行耗时阶段：支持按需勾选查看包括 CPU Time、ThreadScheduleTime、ThreadWaitTime、RowLockWaitTime、MDLWaitTime、LatchWaitTime、SocketSendTime、CCLWaitTime 和 TRXCommitTime 指标项在各时间点的发展趋势。 执行耗时分布：展示选定时间段内，所有 SQL 的执行耗时分布，将执行耗时分为 7 个区间，每分钟计算一次，具体如下所示： (0,1]ms：表示满足 0ms ＜ 执行耗时 ≤ 1ms SQL 执行次数占比。 (1,2]ms：表示满足 1ms ＜ 执行耗时 ≤ 2ms SQL 执行次数占比。 (2,3]ms：表示满足 2ms ＜ 执行耗时 ≤ 3ms SQL 执行次数占比。 (3,10]ms：表示满足 3ms ＜ 执行耗时 ≤ 10ms SQL 执行次数占比。 (10,100]ms：表示满足 10ms ＜ 执行耗时 ≤ 100ms SQL 执行次数占比。 (0.1,1]s：表示满足 0.1s ＜ 执行耗时 ≤ 1s SQL 执行次数占比。 >1 s：表示满足 1s ＜ 执行耗时 SQL 执行次数占比。 执行次数：执行时间段内 SQL 执行次数的统计。支持查看各时间点的执行总次数的发展趋势。 SQL 模板列表：在 SQL 模板列表区域，您可以查看每个 SQL 模板的平均 SQL 执行耗时、SQL 耗时、数据库名称、TotalExecTime、Count、TRXCommitTime、平均 CPUTime、平均 RowLockWaitTime、平均 MDLWaitTime、平均 LatchWaitTime、平均 TRXCommitTime、平均 CCLWaitTime、平均 SocketSendTime、平均 ThreadScheduleTime、平均 ThreadWaitTime、平均影响行数、平均扫描行数、平均返回行数、平均发送字节数、平均逻辑页读取次数、平均 IO 读取字节数、平均 IO 读页面数、平均磁盘临时表数量。 单击 SQL 模板，在 SQL 详情控制面板，查看该 SQL 模板的执行次数、执行耗时、影响行数、返回行数、SQL 模板、SQL 文本和 SQL 优化，您也可以单击收藏图标，便于后续查看目标 SQL 模板。 说明 CPUTime、SocketSendTime、RowLockWaitTime、ThreadScheduleTime、ThreadWaitTime、MDLWaitTime、LatchWaitTime、CCLWaitTime、影响行数、扫描行数、返回行数、发送字节数、逻辑页读取次数、IO 读取字节数、IO 读页面数、磁盘临时表数量均为指定时间内的平均值。 在 SQL 优化建议对话框，查看 SQL 优化建议包括执行的 SQL 语句、执行计划、优化建议包括索引优化和 SQL 改写 收藏 SQL 模板：在 SQL 模板列表区域，单击目标 SQL 模板操作列的收藏图标，收藏 SQL 模板。 查看收藏的 SQL 模板：在 SQL 模板列表区域，单击我收藏的，可以查看您在所有 SQL 模板列表中收藏的 SQL 模板，您也可以单击目标 SQL 模板的操作列，取消您收藏的 SQL 模板。 对比查看全量 SQL 洞察信息 在全量 SQL 洞察子页签，勾选时间对比，按需选择需要对比查看全量 SQL 洞察的时间段，查看执行耗时阶段、执行耗时分布、执行次数和对比时间段内的 SQL 模版列表等信息。 说明 ThreadScheduleTime：内核维度的运行时（RT）时间。 您也可以单击目标 SQL 文本操作列的查看执行计划，在执行计划对话框查看更多信息。
   SQL 明细	在 SQL 明细子页签，您可以查看 SQL 语句明细，按需选择需要查看全量 SQL 明细的时间范围，您可以在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。由于 SQL 洞察记录所有数据库行为，会记录大量 SQL 语句，在线查询选择时间范围过大，会导致长时间没有返回查询结果，甚至查询超时。 SQL 语句的明细包括执行耗时、SQL 耗时（ms）、数据库名称、SQL 语句、SQL 类型、会话 ID、用户名、客户端 IP、表名、开始时间、CPUTime、RowLockWaitTime、MDLWaitTime、LatchWaitTime、TRXCommitTime、CCLWaitTime、SocketSendTime、ThreadScheduleTime、ThreadWaitTime、影响行数、扫描行数、返回行数、发送字节数、逻辑页读取次数、IO 读取字节数、IO 读页面数、磁盘临时表数量。您也可以单击高级筛选，筛选符合条件的 SQL 语句。 说明 您也可以单击目标 SQL 语句操作列的查看执行计划，在执行计划对话框查看更多信息。 在 SQL 明细的高级筛选的关键词中，支持通过模糊搜索查询目标 SQL 信息，模糊搜索不区分大小写，关键词格式为SQL 关键词 + *，例如 select *。
   写分析	通过写分析，您可以全面监控和分析数据库的写入操作。 在写分析子页签，您可以按需查看指定时间（按需选择需要查看全量 SQL 写分析的时间范围，您可以在数据库实例 SQL 存储时长范围内设置任意的查询开始时间，查看最多 24 小时的数据。由于 SQL 洞察记录所有数据库行为，会记录大量 SQL 语句，在线查询选择时间范围过大，会导致长时间没有返回查询结果，甚至查询超时。）、指定数据库和表内数据库的写入操作，包括表名、数据库名称、执行次数、SQL 平均耗时、DML 总执行时间、DML 执行次数、DML 平均执行耗时、DML 平均扫描行、DML 平均影响行数、DML 平均 InnoDB 行锁等待时间、DML 平均 MDL 锁等待时间、DML 最大执行耗时、DDL 总执行时间、DDL 执行次数、DDL 平均执行耗时、DDL 平均扫描行、DDL 平均影响行数、DDL 平均 InnoDB 行锁等待时间、DDL 平均 MDL 锁等待时间和 DDL 最大执行耗时。 同时，您也可以单击目标表的表名，查看关于表的更多信息，具体如下所示： DML：在目标表控制面板的 DML 子页签，您可以查看在指定时间内表内执行的 DML 明细，包括 DML 的执行次数、总耗时和影响行数。 DDL：在目标表控制面板的 DDL 子页签，您可以查看在指定时间内表内执行的 DDL 明细，包括 DDL 的执行次数、总耗时和影响行数。 SQL 模版列表：在目标表控制面板的 SQL 模版区域，您可以查看在指定时间内表内每个 SQL 模版的平均 SQL 执行耗时、SQL 耗时(ms)、SQL 模版、SQL 类型、数据库名称、表名、TotalExecTime、Count、平均 CPUTime、平均 RowLockWaitTime、平均 MDLWaitTime、平均 LatchWaitTime、平均 TRXCommitTime、平均 CCLWaitTime、平均 SocketSendTime、平均 ThreadScheduleTime、平均 ThreadWaitTime、平均影响行数、平均扫描行数、平均返回行数、平均发送字节数、平均逻辑页读取次数、平均 IO 读取字节数、平均 IO 读页面数、平均磁盘临时表数量。 单击 SQL 模板，在 SQL 详情控制面板，查看表级别 SQL 模板的执行次数、执行耗时、影响行数、返回行数、SQL 模板和 SQL 文本。

下载全量 SQL

1. 登录 DBW 控制台。

2. 在顶部菜单栏，选择项目和地域。

3. 在左侧导航栏，选择运维管理 > 观测诊断。

4. 在运维观测页面左上角，单击下拉图标，选择目标实例。

   说明

   支持通过实例 ID 搜索切换目标实例。

5. 在目标实例的全量 SQL 洞察页签，按需下载 SQL 数据：

   • 下载所有 TOP SQL

     1. 在全量 SQL 洞察子页签的 SQL 模板区域，单击下载图标。

     2. 在导出所有 TOP SQL 对话框，按需勾选需要导出的数据库实例字段。

     3. 单击确定。

   • 下载所有全量 SQL 明细
     在 SQL 明细子页签，单击下载图标，选择下载类型。

     • 导出当前页

       1. 单击导出当前页。

       2. 在导出数据对话框，按需勾选需要下载审计日志的字段。

       3. 单击确定。

     • 导出全部日志

       1. 导出日志

          1. 单击导出全部日志。

          2. 在导出审计日志对话框，配置相关参数信息，具体如下表所示。

             参数	描述
             文件格式	选择下载的日志格式，当前支持 CSV 和 JSON 两种格式。
             导出范围	按需选择导出的日志范围，当前支持自定义、近 2 小时、近 12 小时和近 24 小时。
             自定义时间段	选择日志导出的时间范围。说明当导出范围选择自定义时支持设置该参数。

          3. 单击确定。

       2. 下载日志

          1. 在数据库审计页签，单击下载图标，然后选择导出历史。

          2. 在导出历史对话框，选择状态为已生成的目标任务，单击操作列下的下载文件。

   • 下载表内全量 SQL 写分析

     1. 在写分析子页签，按需设置时间、数据库名称和表名。

     2. 单击目标表的名称。

     3. 在目标表详情控制面板，单击下载图标。

     4. 在导出所有 TOP SQL 对话框，按需勾选需要导出的列表字段。

     5. 单击确定。