模块收集的统计信息通过名为 pg_stat_statements 的视图提供。此视图包含数据库 ID、用户 ID、查询 ID 和它是否为顶级语句（最多模块可以跟踪的不同语句的最大数量）的每个不同组合的一行。该视图的列显示在 表 F.21 中。

出于安全原因，只有超级用户和具有pg_read_all_stats角色权限的角色才能查看其他用户执行的查询的SQL文本和queryid。但是，如果该视图已安装在其数据库中，则其他用户可以查看统计信息。

可计划查询（即SELECT、INSERT、UPDATE、DELETE和MERGE）和实用程序命令在具有相同查询结构（根据内部哈希计算）时合并到单个pg_stat_statements条目中。通常，如果两个查询在语义上等效，但查询中出现的文字常量的值不同，则出于此目的将它们视为相同。

当常量的值已被忽略以用于将查询与其他查询匹配时，该常量在pg_stat_statements显示中被替换为参数符号，例如$1。查询文本的其余部分是第一个具有与pg_stat_statements条目关联的特定queryid哈希值的查询的文本。

可以在pg_stat_statements中观察到可以应用规范化的查询的常量值，尤其是在条目释放率很高的情况下。为了降低发生这种情况的可能性，请考虑增加pg_stat_statements.max。下面在第 F.30.2 节中讨论的pg_stat_statements_info视图提供了有关条目释放的统计信息。

在某些情况下，具有明显不同文本的查询可能会合并到单个pg_stat_statements条目中。通常，这只会发生在语义上等效的查询中，但存在很小的几率哈希冲突会导致不相关的查询合并到一个条目中。（但是，对于属于不同用户或数据库的查询，这不可能发生。）

由于queryid哈希值是在查询的后解析分析表示上计算的，因此反之亦然：如果查询由于不同的search_path设置等因素而具有不同的含义，则具有相同文本的查询可能会显示为单独的条目。

pg_stat_statements的使用者可能希望使用queryid（可能与dbid和userid结合使用）作为每个条目的更稳定和可靠的标识符，而不是其查询文本。但是，必须了解围绕queryid哈希值的稳定性只有有限的保证。由于标识符是从后解析分析树派生的，因此其值是除其他事项外，此表示中出现的内部对象标识符的函数。这有一些违反直觉的含义。例如，如果在两个查询的执行之间删除并重新创建了表，则pg_stat_statements会将两个看似相同的查询视为不同的查询。哈希过程也对机器架构和平台的其他方面差异敏感。此外，不能假设queryid在PostgreSQL的主要版本之间是稳定的。

参与基于物理 WAL 重放的复制的两个服务器可以预期对同一查询具有相同的queryid值。但是，逻辑复制方案并不能保证副本在所有相关细节上保持相同，因此queryid不会成为跨一组逻辑副本累积成本的有用标识符。如有疑问，建议进行直接测试。

通常，可以假设queryid值在PostgreSQL的次要版本发布之间是稳定的，前提是实例在相同的机器架构上运行并且目录元数据详细信息匹配。兼容性只会作为最后的手段在次要版本之间中断。

用于替换代表性查询文本中常量的参数符号从原始查询文本中最高的$n参数后的下一个数字开始，如果没有，则为$1。值得注意的是，在某些情况下，可能存在影响此编号的隐藏参数符号。例如，PL/pgSQL使用隐藏的参数符号将函数局部变量的值插入查询中，因此PL/pgSQL语句（如SELECT i + 1 INTO j）将具有类似于SELECT i + $2的代表性文本。

代表性查询文本保存在外部磁盘文件中，并且不占用共享内存。因此，即使是非常长的查询文本也可以成功存储。但是，如果累积了许多长的查询文本，则外部文件可能会变得过大而无法管理。如果发生这种情况，作为恢复方法，pg_stat_statements可能会选择丢弃查询文本，此时pg_stat_statements视图中所有现有条目都将显示空query字段，尽管与每个queryid关联的统计信息将保留。如果发生这种情况，请考虑减少pg_stat_statements.max以防止再次发生。

plans和calls并不总是期望匹配，因为计划和执行统计信息是在其各自的结束阶段更新的，并且仅针对成功的操作。例如，如果语句已成功计划但在执行阶段失败，则只会更新其计划统计信息。如果由于使用了缓存计划而跳过计划，则只会更新其执行统计信息。

pg_stat_statements模块本身的统计信息会被跟踪，并通过名为pg_stat_statements_info的视图提供。此视图仅包含一行。该视图的列显示在表 F.22中。

该模块需要与 pg_stat_statements.max 成比例的额外共享内存。请注意，即使将 pg_stat_statements.track 设置为 none，加载模块时也会消耗此内存。

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

# postgresql.conf
shared_preload_libraries = 'pg_stat_statements'

compute_query_id = on
pg_stat_statements.max = 10000
pg_stat_statements.track = all

bench=# SELECT pg_stat_statements_reset();

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

bench=# \x
bench=# SELECT query, calls, total_exec_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_exec_time DESC LIMIT 5;
-[ RECORD 1 ]---+--------------------------------------------------​------------------
query           | UPDATE pgbench_branches SET bbalance = bbalance + $1 WHERE bid = $2
calls           | 3000
total_exec_time | 25565.855387
rows            | 3000
hit_percent     | 100.0000000000000000
-[ RECORD 2 ]---+--------------------------------------------------​------------------
query           | UPDATE pgbench_tellers SET tbalance = tbalance + $1 WHERE tid = $2
calls           | 3000
total_exec_time | 20756.669379
rows            | 3000
hit_percent     | 100.0000000000000000
-[ RECORD 3 ]---+--------------------------------------------------​------------------
query           | copy pgbench_accounts from stdin
calls           | 1
total_exec_time | 291.865911
rows            | 100000
hit_percent     | 100.0000000000000000
-[ RECORD 4 ]---+--------------------------------------------------​------------------
query           | UPDATE pgbench_accounts SET abalance = abalance + $1 WHERE aid = $2
calls           | 3000
total_exec_time | 271.232977
rows            | 3000
hit_percent     | 98.8454011741682975
-[ RECORD 5 ]---+--------------------------------------------------​------------------
query           | alter table pgbench_accounts add primary key (aid)
calls           | 1
total_exec_time | 160.588563
rows            | 0
hit_percent     | 100.0000000000000000


bench=# SELECT pg_stat_statements_reset(0,0,s.queryid) FROM pg_stat_statements AS s
            WHERE s.query = 'UPDATE pgbench_branches SET bbalance = bbalance + $1 WHERE bid = $2';

bench=# SELECT query, calls, total_exec_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_exec_time DESC LIMIT 5;
-[ RECORD 1 ]---+--------------------------------------------------​------------------
query           | UPDATE pgbench_tellers SET tbalance = tbalance + $1 WHERE tid = $2
calls           | 3000
total_exec_time | 20756.669379
rows            | 3000
hit_percent     | 100.0000000000000000
-[ RECORD 2 ]---+--------------------------------------------------​------------------
query           | copy pgbench_accounts from stdin
calls           | 1
total_exec_time | 291.865911
rows            | 100000
hit_percent     | 100.0000000000000000
-[ RECORD 3 ]---+--------------------------------------------------​------------------
query           | UPDATE pgbench_accounts SET abalance = abalance + $1 WHERE aid = $2
calls           | 3000
total_exec_time | 271.232977
rows            | 3000
hit_percent     | 98.8454011741682975
-[ RECORD 4 ]---+--------------------------------------------------​------------------
query           | alter table pgbench_accounts add primary key (aid)
calls           | 1
total_exec_time | 160.588563
rows            | 0
hit_percent     | 100.0000000000000000
-[ RECORD 5 ]---+--------------------------------------------------​------------------
query           | vacuum analyze pgbench_accounts
calls           | 1
total_exec_time | 136.448116
rows            | 0
hit_percent     | 99.9201915403032721

bench=# SELECT pg_stat_statements_reset(0,0,0);

bench=# SELECT query, calls, total_exec_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_exec_time DESC LIMIT 5;
-[ RECORD 1 ]---+--------------------------------------------------​---------------------------
query           | SELECT pg_stat_statements_reset(0,0,0)
calls           | 1
total_exec_time | 0.189497
rows            | 1
hit_percent     |
-[ RECORD 2 ]---+--------------------------------------------------​---------------------------
query           | SELECT query, calls, total_exec_time, rows, $1 * shared_blks_hit /          +
                |                nullif(shared_blks_hit + shared_blks_read, $2) AS hit_percent+
                |           FROM pg_stat_statements ORDER BY total_exec_time DESC LIMIT $3
calls           | 0
total_exec_time | 0
rows            | 0
hit_percent     |

板垣貴弘 <[email protected]>。Peter Geoghegan <[email protected]> 添加了查询规范化。