GaussDB数据库SQL诊断--查看全量SQL

查看全量SQL

GaussDB全量SQL功能支持采集并解析SQL语句，便于用户查看SQL语句的执行情况。

支持使用OBS和NAS进行文件存储全量SQL文件，通过系统参数NAS_SUPPORT控制。参数值为false时，表示使用OBS存储。参数值为true，表示使用NAS存储。

前提条件

登录账号需要具备授权项“gaussdb:instance:listFullSql”和“gaussdb:instance:operateFullSql”。

约束限制

• GaussDB实例的数据库引擎版本大于等于V2.0-8.0.1，内核版本大于等于505.0.0，支持开启全量SQL功能。
• 如果使用NAS存储存放全量SQL文件，涉及NAS盘更换的场景，需要手动移动全量SQL文件到新的NAS盘，否则原来的全量SQL文件将不可用。
• 如果使用云外NAS设备存放全量SQL文件，需要配置云专线。云专线可选用基础型云专线或增强型云专线。
  • 基础型云专线：详细内容请参考《华为云Stack 8.5.0 网络配置最佳实践》中的“华为云Stack 8.5.0 网络配置基线（三层组网）> 基础型云专线网络配置”。
  • 增强型云专线：

    详细内容请参考《华为云Stack 8.5.0 网络配置最佳实践》中的“华为云Stack 8.5.0 网络配置基线（三层组网）> 增强型云专线网络配置”和“华为云Stack 8.5.0 网络配置基线（三层组网）> 增强型云专线云外配置”。

• 全量SQL解析仅支持分析三小时以内的数据，并且所分析的所有时间区间必须开启全量SQL功能。
• 全量SQL日志文件采集存在延迟（最大10分钟）。
• 请确认管理面和实例各节点的时间是同步的（UTC-0时间戳是一致的），最多不超过10秒，否则影响整体功能，请务必重视。
• 关闭数据库实例全量SQL功能时，如果已开启SQL执行性能监控特性，请先关闭SQL执行性能监控功能，详情请参见SQL执行性能监控。

开启全量SQL

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

    

   • 使用OBS存储
     图1 开启全量SQL
     

      

   • 使用NAS存储
     图2 使用NAS存储开启全量SQL
     

      

   • 全量SQL文件默认保留时间：全量SQL日志文件的保留时间，文件过期后会被自动清理。
   • NAS设备：全量SQL使用的NAS设备，下拉列表时，展示当前实例已绑定的设备列表。

    

7. 单击“开启”。

关闭全量SQL

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

全量SQL解析

全量SQL解析支持分析一段时间的历史SQL数据。并支持跳转全链路分析界面。

1. 登录管理控制台。
2. 单击管理控制台左上角的，选择区域和项目。
3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
4. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。
5. 选择“诊断优化 > SQL诊断”，单击“全量SQL”。
6. 单击“全量SQL解析”。
7. 选择采集信息，单击“开始解析”。

    

   图3 采集信息
   

    

   表1 全量SQL解析参数解释

   参数名称	参数解释
   可选择的时序区间	全量SQL开启的时间范围。
   时序区间	进行分析的SQL所在的时序区间。 存在以下约束： 所选时间区间需要在全量SQL开启的时间范围之内，且最大支持3小时。 所选择的时序区间不能与“任务状态”为“成功”的解析任务时间范围存在重合；如果有必要，请删除原任务，下发新的解析任务。
   数据库名	数据库名称，填写后只筛选数据库名称为写入内容的SQL。
   数据库模式	数据库模式名称，填写后只筛选数据库模式为写入内容的SQL。
   用户名	用户名，填写后，只筛选用户名为写入内容的SQL。
   数据自动删除天数	系统每日凌晨02:00会自动删除超过设置的数据自动删除天数的数据，如果不填写该字段，将不会自动删除。 取值范围：0~30之间的整数。 示例： 周一上午08:00设置数据自动删除天数为“2”，则周四凌晨02:00会删除周一、周二的数据。

    

8. 采集完成后，在全量SQL解析任务列表单击“查看详情”查询已采集的全量SQL数据。

    

   图4 查看详情
   

    

   

   全量SQL查询支持使用归一化SQL进行检索，支持使用单个单词前缀或者一段SQL语句前缀匹配，不支持使用特殊符号模糊匹配，如\ | ? ()等。

    

9. 单击参数详情，可以查看SQL在组件上执行的详细信息。

    

   图5 查看其它参数详情
   

    

   图6 其它参数详情
   

    

10. 单击列表中的唯一SQL ID、事务ID或链路ID可跳转至全链路分析，详细内容请参考SQL全链路信息。

     

    • 单击唯一SQL ID（唯一SQL ID不为0）跳转至全链路页面，展示该条SQL的执行链路信息。
    • 单击事务ID（事务ID不为0）跳转至全链路页面，展示该事务的执行链路信息。
    • 单击链路ID（链路ID不为空）跳转至全链路页面，展示数据库驱动使用该链路ID执行的所有SQL的执行链路信息。
    图7 全链路分析
    

     

FAQ

• 移动全量文件到新的NAS盘

  涉及NAS盘（即NAS设备）更换的场景，参考如下步骤手动移动全量SQL文件到新的NAS盘，否则原来的全量SQL文件将不可用。

  NOTICE:

  在切换NAS设备之前，请务必记录好之前使用的NAS设备的挂载路径，以确保后续操作能正常执行。

  1. 登录管理控制台。
  2. 在“实例管理”页面，选择指定的实例，单击实例的名称，进入实例详情页面。并记录下实例ID信息。
  3. 单击“查看挂载路径”，获取切换前的NAS设备的挂载路径。
     图8 查看挂载路径
     

      

  4. 单击“切换设备”，选择目标NAS设备，并记录下对应的新设备的挂载路径。
     图9 切换存储设备
     

      

  5. 选择“诊断优化 > SQL诊断”，单击“全量SQL”
  6. 单击“修改默认配置”。
  7. 选择当前未在使用的NAS盘，单击“修改”。
     图10 开启存储设备
     
  8. 切换成功后，以root用户登录实例节点。
  9. 执行以下命令，进入原NAS设备路径。

     cd {切换前的NAS设备挂载路径}/full_sql/{实例ID}

     

  10. 执行以下命令，将当前路径下的所有文件移动到新的NAS设备。

      mv ./* {切换后的NAS设备挂载路径}/full_sql/{实例ID}

      

• 全量SQL解析任务执行失败

  开启全量SQL功能后，如果等待较长时间（超过15min）均未能成功下发全量SQL解析任务，页面提示“所选区间内未采集到有效的全量SQL文件数据”，可从如下几个方面进行排查分析：

  • 等待时间不够：开启全量SQL功能后，采集上报周期默认是10min，因此至少需要等待至少10min，才能进行全量SQL解析，请耐心等待。
  • 所选时间区间存在卡点：所选时间区间内正处于采集周期边界点，导致区间内没有包含采集上报时间点，可以尝试扩大时间区间，重新下发全量SQL解析任务。
  • 管理面和实例节点时间不同步：如果管理面和实例各节点地时间对应的UTC-0时间戳差异较大（如超过10以上），会造成时间区间错误，无法匹配对应的采集文件。

 

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html