F.28. pg_stat_statements

pg_stat_statements模块提供一种方法追踪一个服务器所执行的所有 SQL 语句的执行统计信息。

该模块必须通过在postgresql.confshared_preload_libraries中增加pg_stat_statements来载入,因为它需要额外的共享内存。这意味着增加或移除该模块需要一次服务器重启。

F.28.1. pg_stat_statements视图

由该模块收集的统计信息通过一个名为pg_stat_statements的系统视图可用。这个视图为每一个可区分的查询、数据库 ID 和用户 ID(最多到该模块可以追踪的可区分语句的数量)的组合都包含一行。该视图的列如Table F-20中所示。

Table F-20. pg_stat_statements

名称类型引用描述
useridoidpg_authid.oid执行该语句的用户的 OID
dbidoidpg_database.oid在其中执行该语句的数据库的 OID
querytext 语句的文本形式(最多track_activity_query_size字节)
callsbigint 被执行的次数
total_timedouble precision 在该语句中花费的总时间,以毫秒计
rowsbigint 该语句检索或影响的行总数
shared_blks_hitbigint 该语句造成的共享块缓冲命中总数
shared_blks_readbigint 该语句读取的共享块的总数
shared_blks_dirtiedbigint 该语句弄脏的共享块的总数
shared_blks_writtenbigint 该语句写入的共享块的总数
local_blks_hitbigint 该语句造成的本地块缓冲命中总数
local_blks_readbigint 该语句读取的本地块的总数
local_blks_dirtiedbigint 该语句弄脏的本地块的总数
local_blks_writtenbigint 该语句写入的本地块的总数
temp_blks_readbigint 该语句读取的临时块的总数
temp_blks_writtenbigint 该语句写入的临时块的总数
blk_read_timedouble precision  该语句花在读取块上的总时间,以毫秒计(如果track_io_timing被启用,否则为零)
blk_write_timedouble precision  该语句花在写入块上的总时间,以毫秒计(如果track_io_timing被启用,否则为零)

只有在通过安装pg_stat_statements扩展明确地安装了这个视图和函数pg_stat_statements_reset的数据库中,这个视图以及函数才有效。不过,只要pg_stat_statements被载入到服务器,就会在服务器的所有数据库上跟踪统计信息,不管该视图是否存在。

由于安全性原因,非超级用户不被允许看到其他用户执行的查询的文本。不过,如果该视图被安装在他们的数据库中,他们就能够看见统计信息。

只要可规划的查询(即SELECTINSERTUPDATE以及DELETE)根据一种内部哈希计算具有相同的查询结构,它们就会被组合到一个单一的pg_stat_statements项。通常,对于这里的目的,如果两个查询除了查询中的文本常量值之外在语义上等效,它们将会被认为是相同的。不过,功能性命令(即所有其他命令)会严格地以它们的文本查询字符串为基础进行比较。

当为了把一个查询与其他查询匹配,常数值会被忽略,在pg_stat_statements显示中它会被一个?所替换。查询文本的剩余部分就是具有与该pg_stat_statements项相关的特定哈希值的第一个查询的文本。

在某些情况中,具有明显不同文本的查询可能会被融合到一个单一的pg_stat_statements项。通常这只会发生在语义等价的查询身上,但是也有很小的机会因为哈希碰撞的原因导致无关的查询被融合到一个项中(不过,对于属于不同用户或数据库的查询来说不会发生这种情况)。

由于哈希值是根据查询被解析和分析后的表达计算的,对立的情况也可能存在:如果具有相同文本的查询由于参数(如不同的search_path设置)的原因而具有不同的含义,它们就可能作为不同的项存在。

F.28.2. 函数

pg_stat_statements_reset() 返回 void

pg_stat_statements_reset抛弃目前由pg_stat_statements收集的所有统计信息。默认情况下,这个函数只能被超级用户执行。

F.28.3. 配置参数

pg_stat_statements.max (integer)

pg_stat_statements.max是由该模块跟踪的语句的最大数目(即pg_stat_statements视图中行的最大数量)。如果观测到的可区分的语句超过这个数量,最少被执行的语句的信息将会被丢弃。默认值为 1000。这个参数只能在服务器启动时设置。

pg_stat_statements.track (enum)

pg_stat_statements.track控制哪些语句会被该模块计数。指定top可以跟踪顶层语句(那些直接由客户端发出的语句),指定all还可以跟踪嵌套的语句(例如在函数中调用的语句),指定none可以禁用语句统计信息收集。默认值是top。 只有超级用户能够改变这个设置。

pg_stat_statements.track_utility (boolean)

pg_stat_statements.track_utility控制该模块是否会跟踪工具命令。工具命令是除了SELECTINSERTUPDATEDELETE之外所有的其他命令。默认值是on。 只有超级用户能够改变这个设置。

pg_stat_statements.save (boolean)

pg_stat_statements.save指定是否在服务器关闭之后还保存语句统计信息。如果被设置为off,那么关闭后不保存统计信息并且在服务器启动时也不会重新载入统计信息。默认值为on。这个参数只能在postgresql.conf文件中或者在服务器命令行上设置。

该模块要求大约pg_stat_statements.max * track_activity_query_size字节的额外共享内存。注意只要该模块被载入就会消耗这么多的内存,即便pg_stat_statements.track被设置为none

这些参数必须在postgresql.conf中设置。典型的用法可能是:

# postgresql.conf
shared_preload_libraries = 'pg_stat_statements'

pg_stat_statements.max = 10000
pg_stat_statements.track = all

F.28.4. 示例输出

bench=# SELECT pg_stat_statements_reset();

$ pgbench -i bench
$ pgbench -c10 -t300 bench

bench=# \x
bench=# SELECT query, calls, total_time, rows, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          FROM pg_stat_statements ORDER BY total_time DESC LIMIT 5;
-[ RECORD 1 ]---------------------------------------------------------------------
query       | UPDATE pgbench_branches SET bbalance = bbalance + ? WHERE bid = ?;
calls       | 3000
total_time  | 9609.00100000002
rows        | 2836
hit_percent | 99.9778970000200936
-[ RECORD 2 ]---------------------------------------------------------------------
query       | UPDATE pgbench_tellers SET tbalance = tbalance + ? WHERE tid = ?;
calls       | 3000
total_time  | 8015.156
rows        | 2990
hit_percent | 99.9731126579631345
-[ RECORD 3 ]---------------------------------------------------------------------
query       | copy pgbench_accounts from stdin
calls       | 1
total_time  | 310.624
rows        | 100000
hit_percent | 0.30395136778115501520
-[ RECORD 4 ]---------------------------------------------------------------------
query       | UPDATE pgbench_accounts SET abalance = abalance + ? WHERE aid = ?;
calls       | 3000
total_time  | 271.741999999997
rows        | 3000
hit_percent | 93.7968855088209426
-[ RECORD 5 ]---------------------------------------------------------------------
query       | alter table pgbench_accounts add primary key (aid)
calls       | 1
total_time  | 81.42
rows        | 0
hit_percent | 34.4947735191637631

F.28.5. 作者

Takahiro Itagaki 。Peter Geoghegan 为它加入了查询正规化的功能。