文档首页/ 云数据库 GaussDB/ 用户指南/ 诊断优化/ 查看全量SQL
更新时间：2025-09-05 GMT+08:00
查看PDF
分享

查看全量SQL

操作场景

全量SQL功能支持采集并持久化GaussDB数据库实例上的执行SQL语句，便于用户查看SQL语句的指标统计、执行详情等信息。

支持实例级配置，可设置是否过滤系统用户和默认数据保留天数，并能按需选择要采集的SQL语句类型，以满足用户差异性采集需求。

您还可以通过查询表定义功能识别出SQL文本中的表名信息，并根据表名、Schema名以及库名进行表定义的查询。

前提条件

  • 登录账号需要具备授权项“gaussdb:instance:listFullSql”和“gaussdb:instance:operateFullSql”。
  • 登录账号需要具备LTS云日志服务的API授权项：“lts:groups:*”、“lts:topics:*”和“lts:logs:list”。
  • “全量SQL”和“表定义”为白名单开放。
  • 云日志服务LTS状态正常。
  • 对接CCMS服务，托管LTS云日志服务对应内置账号。

约束限制

  • GaussDB实例的数据库引擎版本大于等于V2.0-8.0.1，内核版本大于等于505.0.0，支持开启全量SQL功能。
  • GaussDB实例及各采集节点的状态都必须是正常的。
  • 全量SQL批量采集上报至云日志服务LTS会存在延迟（最大2分钟） ，并非实时采集。注意，在业务并发高峰期，可能会存在少量数据丢失。
  • 最大支持最近30天内的全量SQL数据查询。
  • 采集的全量SQL数据超期会自动删除，请根据业务要求，合理设置保留天数，最大不超过30天，最小支持1天。超期数据将不支持查询。
  • 全量SQL开启后可能对数据库性能产生短暂影响。
  • 开启操作会自动对接云日志服务LTS，采集到的全量SQL记录会不断持久化到LTS中（索引字段占比：100%），会持续产生费用，具体计费可参考LTS的定价详情。
  • 请确认管理面和实例各节点的时间是同步的（UTC-0时间戳是一致的），最多不超过10秒，否则影响整体功能。
  • GaussDB实例删除时，需要先手动关闭全量SQL；如果不再需要使用已采集的全量SQL数据，可登录云日志服务LTS，手动删除对应的日志组或日志流。
  • 数据库引擎版本大于等于V2.0-3.208.0，内核版本大于等于503.1.0.SPC1200的实例支持查询表定义。版本号查询方法请参见查看云数据库GaussDB数据库和内核引擎版本。

开启全量SQL

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 在“全量SQL”页面，单击“开启全量SQL”右侧的，在弹框中填写全量SQL配置参数。

    图1 开启全量SQL

    • 全量SQL数据默认保留时间：设置采集的全量SQL在云日志服务LTS中的保留天数，过期才会自动清理。默认为7天，可选1~30。
    • 过滤系统用户：开启后，全量SQL采集将会跳过系统用户所执行的SQL记录。默认开启。
    • LTS日志组：智能运维特性专用的日志组配置，每个实例均会按需独立设置。开启全量SQL时自动创建，删除实例后，如果不再需要，可登录云日志服务LTS进行删除，详见删除日志组。
    • LTS日志流：全量SQL功能专用日志流配置，每个实例均会按需独立设置。开启全量SQL时自动创建，并进行相关配置。
    • 采集SQL类型：用于配置需要采集的SQL语句类型。提供了常见的几类SQL类别选择，如果目标SQL类型不在快捷类别选择中，可以通过自定义选项，按需进行添加。

  7. 单击“开启”，下发全量SQL开启任务。

    请耐心等待全量SQL开启完成，直至界面页面提示开启成功。

查看全量SQL统计信息

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 在“全量SQL统计”页签，单击按钮，即可查询归一化SQL的统计数据。默认展示近1小时的数据。

    可按需调整搜索条件，以缩小结果范围，便于精确获取目标记录。如调整时间区间，组合过滤SQL文本（不超过5个）、归一化SQL ID以及其他扩展字段。
    图2 搜索条件

  7. 展开对应行，查看指定的归一化SQL下SQL执行记录的汇总列表。

    图3 查询某个归一化SQL下全量SQL记录列表

    • 支持二级列表的过滤查询，以提高搜索精度。
    • 界面最多展示前1000条记录数据，如果实际条目数超过1000条，建议缩小搜索范围，以查找目标记录。
    • 目前的排序功能是基于界面展示的最多1000条记录进行的缓存排序。

  8. 单击操作列中的“查看SQL”按钮，可查看采集的SQL和解析后的原始SQL。

    开启track_stmt_parameter参数后，会把SQL文本中的变量替换成真实值，展示原始的SQL。对于track_stmt_parameter参数关闭时采集的SQL文本，无法获取到SQL参数变量的值，展示的内容为空。如何修改参数请参考修改实例参数。

  9. 单击操作列中的“更多 > 详情”按钮，即可查看全量SQL记录的其他参数字段信息，包含SQL在组件上执行的详细信息。

    图4 查询SQL执行详情信息

  10. 单击操作列中的“更多 > 链路”或“更多 > 全链路”按钮，即可查看该SQL对应的链路信息，更多链路信息可参见SQL全链路分析。

查看全量单条SQL列表

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 进入“全量单条SQL”页签，单击按钮，即可查询指定区间内的全量SQL记录。默认展示近1小时的数据。

    图5 查询全量单条SQL数据列表

    可按需调整搜索条件，以缩小结果范围，便于精确获取目标记录。如调整时间区间，组合过滤SQL文本、有效DB时间等。

    • SQL文本，支持多次合并查询，可以连续多次输入，不超过5个。
    • 有效DB时间、CPU执行时间、IO执行时间、执行器内执行时间支持区间范围过滤。
    图6 搜索条件

  7. 单击操作列中的“查看SQL”按钮，可查看采集的SQL和解析后的原始SQL。

    开启track_stmt_parameter参数后，会把SQL文本中的变量替换成真实值，展示原始的SQL。对于track_stmt_parameter参数关闭时采集的SQL文本，无法获取到SQL参数变量的值，展示的内容为空。如何修改参数请参考修改实例参数。

  8. 单击操作列中的“更多>详情”按钮，即可查看全量SQL记录的其他参数字段信息，包含SQL在组件上执行的详细信息。

    图7 查询SQL执行详情信息

  9. 单击操作列中的“更多 > 链路”或“更多 > 全链路”按钮，即可查看该SQL对应的链路信息，具体操作可参见SQL全链路分析。

修改默认配置

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 在“全量SQL”页面，单击“修改默认配置”文本按钮，在弹框中修改全量SQL配置参数。

    图8 修改全量SQL默认配置

  7. 单击“修改”，下发全量SQL配置修改任务。
  8. 请耐心等待全量SQL配置修改完成，直至页面提示修改成功。

关闭全量SQL

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 在“全量SQL”页面，单击，然后在弹框中单击“确定”，关闭全量SQL。
  7. 请耐心等待全量SQL关闭完成，直至页面提示关闭成功。

创建SQL PATCH

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 在“全量SQL统计”页签，单击展开目标行数据，或进入“全量单条SQL”页签。
  7. 对于需要操作的SQL，单击操作列的 “SQL PATCH”，显示“SQL PATCH详情”页面。

    • 如果没创建SQL PATCH，输入PATCH名称、PATCH内容，单击“创建”，则可创建SQL PATCH。
      图9 SQL PATCH
    • 如果已创建SQL PATCH，则显示SQL PATCH信息。
      图10 SQL PATCH详情
      • 状态：单击，可开启或关闭SQL PATCH。关闭SQL PATCH，状态显示未生效，开启SQL PATCH，状态显示生效中。
      • 单击“删除”，则可删除SQL PATCH。

查询表定义

  1. 登录管理控制台。
  2. 单击管理控制台左上角的，选择区域和项目。
  3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
  4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
  5. 单击“诊断优化 > SQL诊断”。
  6. 在“全量SQL统计”页签，单击展开目标行数据，或进入“全量单条SQL”页签。
  7. 单击“操作”列的“更多 > 表定义”。在“表定义”页面，查看“识别到的表”。

    如未识别到表，请单击“添加识别到的表”填写表名后进行表定义查询。如识别结果有误，请单击“编辑”进行修改并保存后再进行表定义查询。

  8. 单击指定表名前的进行表定义的查询。

    图11 表定义

  9. 单击表定义中的SQL语句查看具体的表定义信息。

    图12 表定义具体信息

父主题： 诊断优化