STATEMENT_HISTORY

获得当前节点的执行语句的信息。查询视图必须具有sysadmin权限或者monitor admin权限。只可在系统库中查询到结果，用户库中无法查询。

表 1 STATEMENT_HISTORY字段

名称 类型 描述
dbname name 数据库名称。
schemaname name schema名称。
origin_node integer 节点名称。
user_name name 用户名。
application_name text 用户发起的请求的应用程序名称。
client_addr text 用户发起的请求的客户端地址。
client_port integer 用户发起的请求的客户端端口。
unique_query_id bigint 归一化SQL ID。
debug_query_id bigint 唯一SQL ID。
query text 归一化SQL。
start_time timestamp with time zone 语句启动的时间。
finish_time timestamp with time zone 语句结束的时间。
slow_sql_threshold bigint 语句执行时慢SQL的标准。
transaction_id bigint 事务ID。
thread_id bigint 执行线程ID。
session_id bigint 用户session id。
n_soft_parse bigint 软解析次数，n_soft_parse + n_hard_parse可能大于n_calls，因为子查询未计入n_calls。
n_hard_parse bigint 硬解析次数，n_soft_parse + n_hard_parse可能大于n_calls，因为子查询未计入n_calls。
query_plan text 语句执行计划。
n_returned_rows bigint SELECT返回的结果集行数。
n_tuples_fetched bigint 随机扫描行。
n_tuples_returned bigint 顺序扫描行。
n_tuples_inserted bigint 插入行。
n_tuples_updated bigint 更新行。
n_tuples_deleted bigint 删除行。
n_blocks_fetched bigint buffer的块访问次数。
n_blocks_hit bigint buffer的块命中次数。
db_time bigint 有效的DB时间花费，多线程将累加（单位：微秒）。
cpu_time bigint CPU时间（单位：微秒）。
execution_time bigint 执行器内执行时间（单位：微秒）。
parse_time bigint SQL解析时间（单位：微秒）。
plan_time bigint SQL生成计划时间（单位：微秒）。
rewrite_time bigint SQL重写时间（单位：微秒）。
pl_execution_time bigint plpgsql上的执行时间（单位：微秒）。
pl_compilation_time bigint plpgsql上的编译时间（单位：微秒）。
data_io_time bigint IO上的时间花费（单位：微秒）。
net_send_info text 通过物理连接发送消息的网络状态，包含时间（微秒）、调用次数、吞吐量（字节）。通过该字段可以分析SQL在分布式系统下的网络开销，单机模式下不支持该字段。例如：{“time”:xxx, “n_calls”:xxx, “size”:xxx}。
net_recv_info text 通过物理连接接收消息的网络状态，包含时间（微秒）、调用次数、吞吐量（字节）。通过该字段可以分析SQL在分布式系统下的网络开销，单机模式下不支持该字段。例如：{“time”:xxx, “n_calls”:xxx, “size”:xxx}。
net_stream_send_info text 通过逻辑连接发送消息的网络状态，包含时间（微秒）、调用次数、吞吐量（字节）。通过该字段可以分析SQL在分布式系统下的网络开销，单机模式下不支持该字段。例如：{“time”:xxx, “n_calls”:xxx, “size”:xxx}。
net_stream_recv_info text 通过逻辑连接接收消息的网络状态，包含时间（微秒）、调用次数、吞吐量（字节）。通过该字段可以分析SQL在分布式系统下的网络开销，单机模式下不支持该字段。例如：{“time”:xxx, “n_calls”:xxx, “size”:xxx}。
lock_count bigint 加锁次数。
lock_time bigint 加锁耗时。
lock_wait_count bigint 加锁等待次数。
lock_wait_time bigint 加锁等待耗时。
lock_max_count bigint 最大持锁数量。
lwlock_count bigint 轻量级加锁次数（预留）。
lwlock_wait_count bigint 轻量级等锁次数。
lwlock_time bigint 轻量级加锁时间（预留）。
lwlock_wait_time bigint 轻量级加锁时间。
details bytea 等待事件和语句锁事件的列表。 记录级别的值是L0时，开始记录等待事件的列表。显示当前语句event等待相关的统计信息。具体事件信息见等待状态列表、轻量级锁等待事件列表、IO等待事件列表和事务锁等待事件列表。关于每种事务锁对业务的影响程度，请参考LOCK语法小节的详细描述。 记录级别的值是L2时，开始记录语句锁事件的列表，该列表按时间顺序记录事件，记录的数量受参数track_stmt_details_size的影响。 事件包括： - 加锁开始 - 加锁结束 - 等锁开始 - 等锁结束 - 放锁开始 - 放锁结束 - 轻量级等锁开始 - 轻量级等锁结束
is_slow_sql boolean 该SQL是否为slow SQL
trace_id text 驱动传入的trace id，与应用的一次请求相关联。
advise text text 可能导致该SQL为slow SQL的风险信息。

相关特性

对应系统表statement_history，主要目的是记录数据库运行中产生的sql与其运行信息，保证即便数据库重启，SQL信息也依然可以查询到。

一般使用形式:

1. openGauss=# select * from DBE_PERF.statement_history;

主要受到以下参数控制：

  • log_duration：是否记录慢查询。
  • log_min_duration_statement：单位毫秒，标记SQL的慢查询时间，0记录所有SQL，-1则不记录任何信息。
  • track_stmt_stat_level：默认为OFF,L0。参数第一部分为非OFF情况下，会记录所有SQL，第一部分为OFF，第二部分为非OFF情况下，仅记录慢SQL。
  • track_stmt_parameter：追踪语句更详细内容。

此处代码判断逻辑为（以下各个条件为或判定，满足其一即可）：

  1. 打开了动态语句追踪功能：采用dynamic_func_control追踪STMT。
  2. track_stmt_stat_level追踪第一个level为L0或者更高。
  3. track_stmt_stat_level追踪第二个level为L0或者更高，且语句运行时间大于log_min_duration_statement设定值，且log_min_duration_statement大于等于0，并且没有打开track_stmt_parameter。
  4. 打开track_stmt_parameter，并且时间模式第一个值（消耗的DBTIME）大于0。