可获得性

本特性自openGauss 1.1.0 版本开始引入。

openGauss 重构前慢SQL相关视图已废弃，包括dbe_perf. gs_slow_query_info、dbe_perf.gs_slow_query_history、dbe_perf.global_slow_query_hisotry、dbe_perf.global_slow_query_info。

本特性自openGauss 3.1.0 版本支持备机。

特性简介

openGauss 慢SQL诊断提供诊断慢SQL所需要的必要信息，帮助开发者回溯执行时间超过阈值的SQL，诊断SQL性能瓶颈。

客户价值

openGauss 慢SQL诊断提供给用户对于慢SQL所需的详细信息，用户无需通过复现就能离线诊断特定慢SQL的性能问题。表和函数接口方便用户统计慢SQL指标，对接第三方平台。

特性描述

openGauss 慢SQL能根据用户提供的执行时间阈值（log_min_duration_statement），记录所有超过阈值的执行完毕的作业信息。

在openGauss 主机中，慢SQL提供表和函数两种维度的查询接口。用户从接口中能查询到作业的执行计划，开始、结束执行时间，执行查询的语句，行活动，内核时间，CPU时间，执行时间，解析时间，编译时间，查询重写时间，计划生成时间，网络时间，IO时间，网络开销，锁开销，等待事件等。以上所有信息都是脱敏的。

在备机中，慢SQL提供一个专用的函数作为查询接口。由于备机无法往表（statement_history）中写入性能诊断数据，因此备机使用了新的方式来记录数据，并通过函数接口查询，用户在接口中查询到的各类信息，与主机的表（statement_history）完全一致。

特性增强

增加对慢SQL指标信息、安全性（脱敏）、执行计划、查询接口的增强。

特性约束

• 目前的SQL跟踪信息，基于正常的执行逻辑。执行失败的SQL，其跟踪信息不具有准确的参考价值。
• 节点重启，可能导致该节点的数据丢失。
• SQL语句执行完立即退出会话，可能会丢失该会话未刷新到系统表中的数据。
• 通过GUC参数设置收集SQL语句的数量，如果超过阈值，新的SQL语句执行信息不会被收集。
• 通过GUC参数设置单条SQL语句收集的锁事件详细信息的最大字节数，如果超过阈值，新的锁事件详细信息不会被收集。
• 通过异步刷新方式刷新用户执行中的SQL信息，所以用户Query执行结束后，存在查询相关视图函数结果短暂时延。
• 当track_stmt_parameter为off时，query字段最大长度受track_activity_query_size控制。
• 部分指标信息（行活动、Cache/IO、时间分布等）依赖于dbe_perf.statement视图收集，如果该视图对应记录数超过预定大小（依赖GUC：instr_unique_sql_count），则本特性可能不收集相关指标。
• statement_history表相关函数以及视图、备机dbe_perf.standby_statement_history中的details字段为二进制格式，如果需要解析详细内容，请使用对应函数pg_catalog.statement_detail_decode(details, 'plaintext', true)。
• statement_history表查询需要切换至postgres库，其他库中数据为空。
• 备机dbe_perf.standby_statement_history函数查询需要切换至postgres库，其他库中查询会提示不可用。
• 备机通过参数track_stmt_standby_chain_size进行记录数据所占用内存、磁盘空间的大小限制。
• statement_history表以及备机dbe_perf.standby_statement_history函数的内容受track_stmt_stat_level控制，默认为'OFF,L0'，参数第一部分代表Full SQL，第二部分是慢SQL；对于慢SQL，只有SQL运行时间超过log_min_duration_statement时才会被记录。

依赖关系

无。

https://docs.opengauss.org/zh/docs/latest/docs/CharacteristicDescription/%E6%85%A2SQL%E8%AF%8A%E6%96%AD.html