sys_stat_statements 扩展使用介绍
sys_stat_statements 模块提供追踪服务器所执行的所有SQL语句的执行统计信息，可以用于统计数据库的资源开销，如分析TOP SQL。
KingbaseES V8R6版本该插件已经内置化，初始化数据库实例的时候，就会被自动加载。但功能默认关闭，需要设置：sys_stat_statements.track = ’top’ 才能正常使用。
该组件的主要配置参数：
-
sys_stat_statements.max（整数）
sys_stat_statements.max是模块跟踪的最大语句数（即sys_stat_statements视图中的最大行数）。如果观察到的语句不同，则将丢弃关于执行最少的语句的信息。默认值为5000。只能在服务器启动时设置此参数。 -
sys_stat_statements.track（枚举）
sys_stat_statements.track控制模块计算哪些语句。指定top以跟踪顶级语句（由客户端直接发出的语句），全部也可以跟踪嵌套语句（例如在函数内调用的语句），或者不指定以禁用语句统计信息收集。默认值为 'none'。仅超级用户可以更改此设置。 -
sys_stat_statements.track_utility（boolean）
sys_stat_statements.track_utility控制模块是否跟踪实用程序命令。实用程序命令是除SELECT，INSERT，UPDATE和DELETE之外的所有命令。默认值为on。仅超级用户可以更改此设置。 -
sys_stat_statements.save（boolean）
sys_stat_statements.save指定是否在服务器关闭时保存语句统计信息。如果关闭，则统计信息不会在关闭时保存，也不会在服务器启动时重新加载。默认值为on。只能在kingbase.conf文件或服务器命令行中设置此参数。
参数配置示例：配置后需要重启数据库生效
shared_preload_libraries ='liboracle_parser, sys_stat_statements'
sys_stat_statements.max = 10000
sys_stat_statements.track = 'top'
sys_stat_statements 视图结构：
| 名称 | 类型 | 描述 |
|---|---|---|
| userid | oid | 执行该语句的用户的 OID |
| dbid | oid | 在其中执行该语句的数据库的 OID |
| queryid | bigint | 内部哈希码，从语句的解析树计算得来 |
| query | text | 语句的文本形式 |
| parses | bigint | 该语句被解析的次数 |
| total_parse_time | double precision | 在该语句中解析花费的总时间，以毫秒计 |
| min_parse_time | double precision | 在该语句中解析花费的最小时间，以毫秒计 |
| max_parse_time | double precision | 在该语句中解析花费的最大时间，以毫秒计 |
| mean_parse_time | double precision | 在该语句中解析花费的平均时间，以毫秒计 |
| stddev_parse_time | double precision | 在该语句中解析花费时间的总体标准偏差，以毫秒计 |
| plans | bigint | 该语句执行Plan的次数 |
| total_plan_time | double precision | 在该语句中执行Plan花费的总时间，以毫秒计 |
| min_plan_time | double precision | 在该语句中执行Plan花费的最小时间，以毫秒计 |
| max_plan_time | double precision | 在该语句中执行Plan花费的最大时间，以毫秒计 |
| mean_plan_time | double precision | 在该语句中执行Plan花费的平均时间，以毫秒计 |
| stddev_plan_time | double precision | 在该语句中执行P lan花费时间的总体标准偏差，以毫秒计 |
| calls | bigint | 被执行的次数 |
| total_exec_time | double precision | 在该语句中花费的总时间，以毫秒计（该字段在V8R5里面为：total_time） |
| min_exec_time | double precision | 在该语句中花费的最小时间，以毫秒计（该字段在V8R5里面为：min_time） |
| max_exec_time | double precision | 在该语句中花费的最大时间，以毫秒计（该字段在V8R5里面为：max_time） |
| mean_exec_time | double precision | 在该语句中花费的平均时间，以毫秒计（该字段在V8R5里面为：mean_time） |
| stddev_exec_time | double precision | 在该语句中花费时间的总体标准偏差，以毫秒计（该字段在V8R5里面为：stddev_time） |
| rows | bigint | 该语句检索或影响的行总数 |
| shared_blks_hit | bigint | 该语句造成的共享块缓冲命中总数 |
| shared_blks_read | bigint | 该语句读取的共享块的总数 |
| shared_blks_dirtied | bigint | 该语句弄脏的共享块的总数 |
| shared_blks_written | bigint | 该语句写入的共享块的总数 |
| local_blks_hit | bigint | 该语句造成的本地块缓冲命中总数 |
| local_blks_read | bigint | 该语句读取的本地块的总数 |
| local_blks_dirtied | bigint | 该语句弄脏的本地块的总数 |
| local_blks_written | bigint | 该语句写入的本地块的总数 |
| temp_blks_read | bigint | 该语句读取的临时块的总数 |
| temp_blks_written | bigint | 该语句写入的临时块的总数 |
| blk_read_time | double precision | 该语句花在读取块上的总时间，以毫秒计 |
| blk_write_time | double precision | 该语句花在写入块上的总时间，以毫秒计 |
常用的分析SQL
调用次数较多的SQL
select * from sys_stat_statements stat order by calls desc limit 10;
总执行时间较长的SQL
select * from sys_stat_statements order by total_exec_time desc limit 10;
平均执行时间较长的SQL
select * from sys_stat_statements order by mean_exec_time desc limit 10;
在读/写块上总执行时间最多的SQL
select * from sys_stat_statements order by (blk_read_time+blk_write_time) desc limit 10;
在读/写块上平均执行时间最多的SQL
select * from sys_stat_statements order by (blk_read_time+blk_write_time)/calls desc limit 10;
查看时间抖动严重的SQL
select * from sys_stat_statements order by stddev_exec_time desc limit 10;
消耗共享内存较多的SQL
select * from sys_stat_statements order by (shared_blks_hit+shared_blks_dirtied) desc limit 10;
使用临时块较多的SQL
select * from sys_stat_statements order by temp_blks_written desc limit 10;
缓冲池命中率较低的SQL
SELECT *,cast(100.0*shared_blks_hit/nullif(shared_blks_hit + shared_blks_read,0) as decimal(10,2)) AS hit_percent FROM sys_stat_statements ORDER BY total_exec_time DESC LIMIT 10;
