2024年11月21日: PostgreSQL 17.2、16.6、15.10、14.15、13.18 和 12.22 发布！
支持的版本: 当前 (17) / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2
27.2. 累积统计系统
上一个  向上 第 27 章。监控数据库活动 主页  下一个

27.2. 累积统计系统 #

27.2.1. 统计信息收集配置
27.2.2. 查看统计信息
27.2.3. pg_stat_activity
27.2.4. pg_stat_replication
27.2.5. pg_stat_replication_slots
27.2.6. pg_stat_wal_receiver
27.2.7. pg_stat_recovery_prefetch
27.2.8. pg_stat_subscription
27.2.9. pg_stat_subscription_stats
27.2.10. pg_stat_ssl
27.2.11. pg_stat_gssapi
27.2.12. pg_stat_archiver
27.2.13. pg_stat_io
27.2.14. pg_stat_bgwriter
27.2.15. pg_stat_checkpointer
27.2.16. pg_stat_wal
27.2.17. pg_stat_database
27.2.18. pg_stat_database_conflicts
27.2.19. pg_stat_all_tables
27.2.20. pg_stat_all_indexes
27.2.21. pg_statio_all_tables
27.2.22. pg_statio_all_indexes
27.2.23. pg_statio_all_sequences
27.2.24. pg_stat_user_functions
27.2.25. pg_stat_slru
27.2.26. 统计函数

PostgreSQL 的累积统计系统支持收集和报告服务器活动的信息。目前，会计算对表和索引的访问次数，包括磁盘块和单个行的访问次数。还会计算每个表中的总行数，以及每个表的 vacuum 和 analyze 操作的信息。如果启用，还会计算对用户定义函数的调用以及在每个函数中花费的总时间。

PostgreSQL 还支持报告关于系统中正在发生的确切情况的动态信息，例如其他服务器进程当前正在执行的确切命令，以及系统中存在的其他连接。此功能独立于累积统计系统。

27.2.1. 统计信息收集配置 #

由于收集统计信息会增加查询执行的一些开销，因此可以配置系统收集或不收集信息。这由通常在 postgresql.conf 中设置的配置参数控制。(有关设置配置参数的详细信息，请参阅第 19 章。)

参数 track_activities 启用对任何服务器进程正在执行的当前命令的监控。

参数 track_counts 控制是否收集有关表和索引访问的累积统计信息。

参数 track_functions 启用对用户定义函数的使用情况的跟踪。

参数 track_io_timing 启用对块读取、写入、扩展和 fsync 时间的监控。

参数 track_wal_io_timing 启用对 WAL 写入和 fsync 时间的监控。

通常这些参数在 postgresql.conf 中设置，以便它们应用于所有服务器进程，但可以使用 SET 命令在单个会话中打开或关闭它们。(为了防止普通用户向管理员隐藏他们的活动，只允许超级用户使用 SET 更改这些参数。)

累积统计信息收集在共享内存中。每个 PostgreSQL 进程在本地收集统计信息，然后在适当的时间间隔更新共享数据。当服务器（包括物理副本）正常关闭时，统计数据的永久副本存储在 pg_stat 子目录中，以便可以在服务器重新启动时保留统计信息。相反，当从不干净的关机启动时(例如，在立即关机、服务器崩溃、从基本备份启动以及时间点恢复之后)，所有统计计数器都会重置。

27.2.2. 查看统计信息 #

可以使用几个预定义的视图（在表 27.1 中列出）来显示系统的当前状态。还有其他几个视图（在表 27.2 中列出）可用于显示累积的统计信息。或者，可以使用底层累积统计函数构建自定义视图，如第 27.2.26 节中所讨论的那样。

当使用累积统计视图和函数来监控收集的数据时，重要的是要意识到信息不是立即更新的。每个单独的服务器进程会在空闲之前将累积的统计信息刷新到共享内存中，但频率不会高于每 PGSTAT_MIN_INTERVAL 毫秒一次（1 秒，除非在构建服务器时更改）；因此，仍在进行中的查询或事务不会影响显示的汇总，并且显示的信息会滞后于实际活动。但是，由 track_activities 收集的当前查询信息始终是最新的。

另一个重点是，当要求服务器进程显示任何累积的统计信息时，访问的值将被缓存，直到当前事务在默认配置中结束。因此，只要您继续当前事务，统计信息就会显示静态信息。类似地，当在事务中首次请求任何此类信息时，会收集有关所有会话的当前查询的信息，并且在整个事务中将显示相同的信息。这是一个特性，而不是一个错误，因为它允许您对统计信息执行多个查询并关联结果，而无需担心数字在您下方更改。当以交互方式或使用昂贵的查询分析统计信息时，访问单个统计信息之间的时间差会导致缓存的统计信息出现明显的偏差。为了最大程度地减少偏差，可以将 stats_fetch_consistency 设置为 snapshot，但代价是增加缓存不需要的统计数据的内存使用量。相反，如果知道只访问一次统计信息，则无需缓存访问的统计信息，可以通过将 stats_fetch_consistency 设置为 none 来避免这种情况。您可以调用 pg_stat_clear_snapshot() 来丢弃当前事务的统计快照或缓存的值（如果有）。下次使用统计信息时，（在快照模式下）将导致构建新的快照，或者（在缓存模式下）访问的统计信息将被缓存。

事务还可以在视图 pg_stat_xact_all_tables、pg_stat_xact_sys_tables、pg_stat_xact_user_tables 和 pg_stat_xact_user_functions 中看到自己的统计信息（尚未刷新到共享内存统计信息）。这些数字不会如上所述那样工作；相反，它们会在整个事务中持续更新。

在表 27.1中显示的动态统计视图中的某些信息是受安全限制的。普通用户只能看到他们自己会话的所有信息（属于他们是成员的角色会话）。在关于其他会话的行中，许多列将为空。但是请注意，会话的存在及其一般属性（例如会话用户和数据库）对所有用户都是可见的。超级用户和具有内置角色pg_read_all_stats权限的角色（另请参见第 21.5 节）可以看到所有会话的所有信息。

表 27.1. 动态统计视图

视图名称 描述
pg_stat_activity 每个服务器进程一行，显示该进程当前活动的相关信息，例如状态和当前查询。有关详细信息，请参阅pg_stat_activity。
pg_stat_replication 每个 WAL 发送进程一行，显示有关复制到该发送进程连接的备用服务器的统计信息。 有关详细信息，请参阅pg_stat_replication。
pg_stat_wal_receiver 只有一行，显示来自该接收器连接服务器的 WAL 接收器的统计信息。有关详细信息，请参阅pg_stat_wal_receiver。
pg_stat_recovery_prefetch 只有一行，显示有关恢复期间预取的块的统计信息。有关详细信息，请参阅pg_stat_recovery_prefetch。
pg_stat_subscription 每个订阅至少一行，显示有关订阅工作进程的信息。 有关详细信息，请参阅pg_stat_subscription。
pg_stat_ssl 每个连接（常规和复制）一行，显示有关此连接上使用的 SSL 的信息。有关详细信息，请参阅pg_stat_ssl。
pg_stat_gssapi 每个连接（常规和复制）一行，显示有关此连接上使用的 GSSAPI 身份验证和加密的信息。有关详细信息，请参阅pg_stat_gssapi。
pg_stat_progress_analyze 每个运行 ANALYZE 的后端（包括自动清理工作进程）一行，显示当前进度。请参阅第 27.4.1 节。
pg_stat_progress_create_index 每个运行 CREATE INDEX 或 REINDEX 的后端一行，显示当前进度。请参阅第 27.4.4 节。
pg_stat_progress_vacuum 每个运行 VACUUM 的后端（包括自动清理工作进程）一行，显示当前进度。请参阅第 27.4.5 节。
pg_stat_progress_cluster 每个运行 CLUSTER 或 VACUUM FULL 的后端一行，显示当前进度。请参阅第 27.4.2 节。
pg_stat_progress_basebackup 每个流式传输基本备份的 WAL 发送进程一行，显示当前进度。请参阅第 27.4.6 节。
pg_stat_progress_copy 每个运行 COPY 的后端一行，显示当前进度。请参阅第 27.4.3 节。

表 27.2. 收集的统计视图

视图名称 描述
pg_stat_archiver 只有一行，显示有关 WAL 归档器进程活动的统计信息。 有关详细信息，请参阅pg_stat_archiver。
pg_stat_bgwriter 只有一行，显示有关后台写入器进程活动的统计信息。 有关详细信息，请参阅pg_stat_bgwriter。
pg_stat_checkpointer 只有一行，显示有关检查点进程活动的统计信息。 有关详细信息，请参阅pg_stat_checkpointer。
pg_stat_database 每个数据库一行，显示数据库范围的统计信息。有关详细信息，请参阅pg_stat_database。
pg_stat_database_conflicts 每个数据库一行，显示有关由于与备用服务器上的恢复冲突而导致的查询取消的数据库范围的统计信息。有关详细信息，请参阅pg_stat_database_conflicts。
pg_stat_io 对于包含集群范围 I/O 统计信息的后端类型、上下文和目标对象的每个组合，都有单独的一行。 有关详细信息，请参阅pg_stat_io。
pg_stat_replication_slots 每个复制槽一行，显示有关复制槽使用情况的统计信息。 有关详细信息，请参阅pg_stat_replication_slots。
pg_stat_slru 每个 SLRU 一行，显示操作的统计信息。 有关详细信息，请参阅pg_stat_slru。
pg_stat_subscription_stats 每个订阅一行，显示有关错误的统计信息。有关详细信息，请参阅pg_stat_subscription_stats。
pg_stat_wal 只有一行，显示有关 WAL 活动的统计信息。 有关详细信息，请参阅pg_stat_wal。
pg_stat_all_tables 当前数据库中的每个表一行，显示有关对该特定表的访问统计信息。有关详细信息，请参阅pg_stat_all_tables。
pg_stat_sys_tables 与pg_stat_all_tables相同，只是只显示系统表。
pg_stat_user_tables 与pg_stat_all_tables相同，只是只显示用户表。
pg_stat_xact_all_tables 类似于pg_stat_all_tables，但计算当前事务中迄今为止执行的操作（这些操作不包括在pg_stat_all_tables和相关视图中）。此视图中不存在用于表示活动行数、死行数以及清理和分析操作数的列。
pg_stat_xact_sys_tables 与pg_stat_xact_all_tables相同，只是只显示系统表。
pg_stat_xact_user_tables 与pg_stat_xact_all_tables相同，只是只显示用户表。
pg_stat_all_indexes 当前数据库中的每个索引一行，显示有关对该特定索引的访问统计信息。有关详细信息，请参阅pg_stat_all_indexes。
pg_stat_sys_indexes 与pg_stat_all_indexes相同，只是只显示系统表上的索引。
pg_stat_user_indexes 与pg_stat_all_indexes相同，只是只显示用户表上的索引。
pg_stat_user_functions 每个跟踪函数一行，显示有关该函数执行情况的统计信息。 有关详细信息，请参阅pg_stat_user_functions。
pg_stat_xact_user_functions 与pg_stat_user_functions类似，但仅计算当前事务期间的调用（这些调用不包括在pg_stat_user_functions中）。
pg_statio_all_tables 当前数据库中每个表都有一行，显示关于该特定表的 I/O 统计信息。有关详细信息，请参阅 pg_statio_all_tables。
pg_statio_sys_tables 与 pg_statio_all_tables 相同，但仅显示系统表。
pg_statio_user_tables 与 pg_statio_all_tables 相同，但仅显示用户表。
pg_statio_all_indexes 当前数据库中每个索引都有一行，显示关于该特定索引的 I/O 统计信息。有关详细信息，请参阅 pg_statio_all_indexes。
pg_statio_sys_indexes 与 pg_statio_all_indexes 相同，但仅显示系统表上的索引。
pg_statio_user_indexes 与 pg_statio_all_indexes 相同，但仅显示用户表上的索引。
pg_statio_all_sequences 当前数据库中每个序列都有一行，显示关于该特定序列的 I/O 统计信息。有关详细信息，请参阅 pg_statio_all_sequences。
pg_statio_sys_sequences 与 pg_statio_all_sequences 相同，但仅显示系统序列。（目前，没有定义系统序列，因此此视图始终为空。）
pg_statio_user_sequences 与 pg_statio_all_sequences 相同，但仅显示用户序列。

每个索引的统计信息对于确定正在使用哪些索引以及它们的效率特别有用。

pg_stat_io 和 pg_statio_ 视图集可用于确定缓冲缓存的效率。它们可用于计算缓存命中率。请注意，虽然 PostgreSQL 的 I/O 统计信息捕获了为了执行 I/O 而调用内核的大多数实例，但它们不会区分必须从磁盘获取的数据和已驻留在内核页缓存中的数据。建议用户将 PostgreSQL 统计信息视图与操作系统实用程序结合使用，以更全面地了解其数据库的 I/O 性能。

27.2.3. pg_stat_activity #

pg_stat_activity 视图将为每个服务器进程提供一行，显示与该进程当前活动相关的信息。

表 27.3. pg_stat_activity 视图

列 类型

描述

datid oid

此后端连接的数据库的 OID

datname name

此后端连接的数据库的名称

pid integer

此后端的进程 ID

leader_pid integer

如果此进程是并行查询工作进程，则为并行组领导者的进程 ID；如果此进程是并行应用工作进程，则为领导者应用工作进程的进程 ID。NULL 表示此进程是并行组领导者或领导者应用工作进程，或者不参与任何并行操作。

usesysid oid

登录此后端的用户的 OID

usename name

登录此后端的用户的名称

application_name text

连接到此后端的应用程序的名称

client_addr inet

连接到此后端的客户端的 IP 地址。如果此字段为 null，则表示客户端是通过服务器计算机上的 Unix 套接字连接的，或者这是一个内部进程，例如自动清理。

client_hostname text

连接的客户端的主机名，如 client_addr 的反向 DNS 查找报告的那样。仅当 log_hostname 启用时，此字段才不会为 null，并且仅适用于 IP 连接。

client_port integer

客户端用于与此后端通信的 TCP 端口号，如果使用 Unix 套接字，则为 -1。如果此字段为 null，则表示这是一个内部服务器进程。

backend_start timestamp with time zone

此进程启动的时间。对于客户端后端，这是客户端连接到服务器的时间。

xact_start timestamp with time zone

此进程的当前事务启动的时间，如果没有活动事务，则为 null。如果当前查询是其事务的第一个查询，则此列等于 query_start 列。

query_start timestamp with time zone

当前活动查询启动的时间，如果 state 不是 active，则为上次查询启动的时间

state_change timestamp with time zone

state 上次更改的时间

wait_event_type text

后端正在等待的事件类型（如果有）；否则为 NULL。请参阅 表 27.4。

wait_event text

如果后端当前正在等待，则为等待事件名称，否则为 NULL。请参阅 表 27.5 至 表 27.13。

state text

此后端的当前总体状态。可能的值为

  • active：后端正在执行查询。

  • idle：后端正在等待新的客户端命令。

  • idle in transaction：后端处于事务中，但当前未执行查询。

  • idle in transaction (aborted)：此状态类似于 idle in transaction，但事务中的一个语句导致了错误。

  • fastpath function call：后端正在执行快速路径函数。

  • disabled：如果在此后端中禁用 track_activities，则会报告此状态。

backend_xid xid

此后端的顶级事务标识符（如果有）；请参阅 第 66.1 节。

backend_xmin xid

当前后端的 xmin 水平线。

query_id bigint

此后端最近的查询的标识符。如果 state 为 active，则此字段显示当前正在执行的查询的标识符。在所有其他状态下，它显示上次执行的查询的标识符。默认情况下不计算查询标识符，因此除非启用 compute_query_id 参数或配置了计算查询标识符的第三方模块，否则此字段将为 null。

query text

此后端最近的查询的文本。如果 state 为 active，则此字段显示当前正在执行的查询。在所有其他状态下，它显示上次执行的查询。默认情况下，查询文本在 1024 字节处被截断；此值可以通过参数 track_activity_query_size 更改。

backend_type text

当前后端的类型。可能的类型为 autovacuum launcher、autovacuum worker、logical replication launcher、logical replication worker、parallel worker、background writer、client backend、checkpointer、archiver、standalone backend、startup、walreceiver、walsender、walwriter 和 walsummarizer。此外，由扩展注册的后台工作进程可能有其他类型。

注意

wait_event 和 state 列是独立的。如果后端处于 active 状态，它可能会或可能不会在某个事件上 waiting。如果状态为 active 且 wait_event 不为 null，则表示正在执行查询，但在系统的某个位置被阻塞。

表 27.4. 等待事件类型

等待事件类型 描述
活动 服务器进程处于空闲状态。此事件类型指示一个进程正在等待其主处理循环中的活动。wait_event 将标识特定的等待点；请参阅 表 27.5。
BufferPin 服务器进程正在等待对数据缓冲区的独占访问权限。如果另一个进程持有打开的游标，该游标最后一次读取了有问题的缓冲区中的数据，则缓冲别针等待可能会延长。请参阅 表 27.6。
客户端 服务器进程正在等待连接到用户应用程序的套接字上的活动。因此，服务器期望发生一些独立于其内部进程的事情。wait_event 将标识特定的等待点；请参阅 表 27.7。
扩展 服务器进程正在等待扩展模块定义的某些条件。请参阅 表 27.8。
注入点 服务器进程正在等待注入点达到测试中定义的结果。有关详细信息，请参阅 第 36.10.13 节。此类型没有预定义的等待点。
IO 服务器进程正在等待 I/O 操作完成。wait_event 将标识特定的等待点；请参阅 表 27.9。
IPC 服务器进程正在等待与另一个服务器进程的某些交互。wait_event 将标识特定的等待点；请参阅 表 27.10。
锁定 服务器进程正在等待一个重量级锁。重量级锁，也称为锁管理器锁或简称锁，主要保护 SQL 可见对象，例如表。但是，它们也用于确保某些内部操作（例如关系扩展）的互斥。wait_event 将标识等待的锁类型；请参阅 表 27.11。
LWLock 服务器进程正在等待一个轻量级锁。大多数此类锁保护共享内存中的特定数据结构。 wait_event 将包含一个名称，用于标识轻量级锁的用途。（有些锁有特定的名称；另一些锁是一组具有相似用途的锁的一部分。）请参见表 27.12。
超时 服务器进程正在等待超时过期。 wait_event 将标识特定的等待点；请参见表 27.13。

表 27.5. Activity类型的等待事件

Activity 等待事件 描述
ArchiverMain 在归档进程的主循环中等待。
AutovacuumMain 在自动清理启动进程的主循环中等待。
BgwriterHibernate 在后台写入进程中等待，休眠状态。
BgwriterMain 在后台写入进程的主循环中等待。
CheckpointerMain 在检查点进程的主循环中等待。
LogicalApplyMain 在逻辑复制应用进程的主循环中等待。
LogicalLauncherMain 在逻辑复制启动进程的主循环中等待。
LogicalParallelApplyMain 在逻辑复制并行应用进程的主循环中等待。
RecoveryWalStream 在启动进程的主循环中等待 WAL 到达，在流式恢复期间。
ReplicationSlotsyncMain 在槽同步工作进程的主循环中等待。
ReplicationSlotsyncShutdown 等待槽同步工作进程关闭。
SysloggerMain 在系统日志进程的主循环中等待。
WalReceiverMain 在 WAL 接收进程的主循环中等待。
WalSenderMain 在 WAL 发送进程的主循环中等待。
WalSummarizerWal 在 WAL 摘要器中等待生成更多 WAL。
WalWriterMain 在 WAL 写入进程的主循环中等待。

表 27.6. Bufferpin类型的等待事件

BufferPin 等待事件 描述
BufferPin 等待获取缓冲区上的独占锁。

表 27.7. Client类型的等待事件

Client 等待事件 描述
ClientRead 等待从客户端读取数据。
ClientWrite 等待向客户端写入数据。
GssOpenServer 在建立 GSSAPI 会话时，等待从客户端读取数据。
LibpqwalreceiverConnect 在 WAL 接收器中等待建立与远程服务器的连接。
LibpqwalreceiverReceive 在 WAL 接收器中等待接收来自远程服务器的数据。
SslOpenServer 尝试连接时等待 SSL。
WaitForStandbyConfirmation 等待物理备用服务器接收并刷新 WAL。
WalSenderWaitForWal 等待在 WAL 发送进程中刷新 WAL。
WalSenderWriteData 在 WAL 发送进程中处理来自 WAL 接收器的回复时，等待任何活动。

表 27.8. Extension类型的等待事件

Extension 等待事件 描述
扩展 在扩展中等待。

表 27.9. Io类型的等待事件

IO 等待事件 描述
BasebackupRead 等待基本备份从文件中读取。
BasebackupSync 等待基本备份写入的数据到达持久存储。
BasebackupWrite 等待基本备份写入文件。
BuffileRead 等待从缓冲文件中读取。
BuffileTruncate 等待截断缓冲文件。
BuffileWrite 等待写入缓冲文件。
ControlFileRead 等待从 pg_control 文件中读取。
ControlFileSync 等待 pg_control 文件到达持久存储。
ControlFileSyncUpdate 等待对 pg_control 文件的更新到达持久存储。
ControlFileWrite 等待写入 pg_control 文件。
ControlFileWriteUpdate 等待写入以更新 pg_control 文件。
CopyFileRead 等待文件复制操作期间的读取。
CopyFileWrite 等待文件复制操作期间的写入。
DataFileExtend 等待扩展关系数据文件。
DataFileFlush 等待关系数据文件到达持久存储。
DataFileImmediateSync 等待将关系数据文件立即同步到持久存储。
DataFilePrefetch 等待从关系数据文件进行异步预取。
DataFileRead 等待从关系数据文件中读取。
DataFileSync 等待对关系数据文件的更改到达持久存储。
DataFileTruncate 等待截断关系数据文件。
DataFileWrite 等待写入关系数据文件。
DsmAllocate 等待分配动态共享内存段。
DsmFillZeroWrite 等待用零填充动态共享内存后备文件。
LockFileAddtodatadirRead 等待向数据目录锁定文件添加行时的读取。
LockFileAddtodatadirSync 等待向数据目录锁定文件添加行时数据到达持久存储。
LockFileAddtodatadirWrite 等待向数据目录锁定文件添加行时的写入。
LockFileCreateRead 等待创建数据目录锁定文件时的读取。
LockFileCreateSync 等待创建数据目录锁定文件时数据到达持久存储。
LockFileCreateWrite 等待创建数据目录锁定文件时的写入。
LockFileRecheckdatadirRead 等待重新检查数据目录锁定文件期间的读取。
LogicalRewriteCheckpointSync 等待逻辑重写映射在检查点期间到达持久存储。
LogicalRewriteMappingSync 等待逻辑重写期间映射数据到达持久存储。
LogicalRewriteMappingWrite 等待逻辑重写期间写入映射数据。
LogicalRewriteSync 等待逻辑重写映射到达持久存储。
LogicalRewriteTruncate 等待在逻辑重写期间截断映射数据。
LogicalRewriteWrite 等待写入逻辑重写映射。
RelationMapRead 等待读取关系映射文件。
RelationMapReplace 等待持久替换关系映射文件。
RelationMapWrite 等待写入关系映射文件。
ReorderBufferRead 等待在重排序缓冲区管理期间进行读取。
ReorderBufferWrite 等待在重排序缓冲区管理期间进行写入。
ReorderLogicalMappingRead 等待在重排序缓冲区管理期间读取逻辑映射。
ReplicationSlotRead 等待从复制槽控制文件中读取。
ReplicationSlotRestoreSync 等待复制槽控制文件在恢复到内存时到达持久存储。
ReplicationSlotSync 等待复制槽控制文件到达持久存储。
ReplicationSlotWrite 等待写入复制槽控制文件。
SlruFlushSync 等待 SLRU 数据在检查点或数据库关闭期间到达持久存储。
SlruRead 等待读取 SLRU 页面。
SlruSync 等待 SLRU 数据在页面写入后到达持久存储。
SlruWrite 等待写入 SLRU 页面。
SnapbuildRead 等待读取序列化的历史目录快照。
SnapbuildSync 等待序列化的历史目录快照到达持久存储。
SnapbuildWrite 等待写入序列化的历史目录快照。
TimelineHistoryFileSync 等待通过流式复制接收的时间线历史文件到达持久存储。
TimelineHistoryFileWrite 等待写入通过流式复制接收的时间线历史文件。
TimelineHistoryRead 等待读取时间线历史文件。
TimelineHistorySync 等待新创建的时间线历史文件到达持久存储。
TimelineHistoryWrite 等待写入新创建的时间线历史文件。
TwophaseFileRead 等待读取两阶段状态文件。
TwophaseFileSync 等待两阶段状态文件到达持久存储。
TwophaseFileWrite 等待写入两阶段状态文件。
VersionFileSync 等待在创建数据库时版本文件到达持久存储。
VersionFileWrite 等待在创建数据库时写入版本文件。
WalsenderTimelineHistoryRead 等待在 walsender 时间线命令期间从时间线历史文件中读取。
WalBootstrapSync 等待在引导期间 WAL 到达持久存储。
WalBootstrapWrite 等待在引导期间写入 WAL 页面。
WalCopyRead 等待通过复制现有 WAL 段创建新 WAL 段时的读取。
WalCopySync 等待通过复制现有 WAL 段创建的新 WAL 段到达持久存储。
WalCopyWrite 等待通过复制现有 WAL 段创建新 WAL 段时的写入。
WalInitSync 等待新初始化的 WAL 文件到达持久存储。
WalInitWrite 等待初始化新 WAL 文件时的写入。
WalRead 等待从 WAL 文件中读取。
WalSummaryRead 等待从 WAL 摘要文件中读取。
WalSummaryWrite 等待写入 WAL 摘要文件。
WalSync 等待 WAL 文件到达持久存储。
WalSyncMethodAssign 等待在分配新的 WAL 同步方法时数据到达持久存储。
WalWrite 等待写入 WAL 文件。

表 27.10. Ipc类型的等待事件

IPC 等待事件 描述
AppendReady 等待 Append 计划节点的子计划节点准备就绪。
ArchiveCleanupCommand 等待 archive_cleanup_command 完成。
ArchiveCommand 等待 archive_command 完成。
BackendTermination 等待另一个后端进程终止。
BackupWaitWalArchive 等待备份所需的 WAL 文件成功归档。
BgworkerShutdown 等待后台工作进程关闭。
BgworkerStartup 等待后台工作进程启动。
BtreePage 等待继续并行 B 树扫描所需的页码变为可用。
BufferIo 等待缓冲区 I/O 完成。
CheckpointDelayComplete 等待阻塞检查点的后端进程完成。
CheckpointDelayStart 等待阻塞检查点启动的后端进程。
CheckpointDone 等待检查点完成。
CheckpointStart 等待检查点启动。
ExecuteGather 在执行 Gather 计划节点时，等待来自子进程的活动。
HashBatchAllocate 等待被选中的并行哈希参与者分配哈希表。
HashBatchElect 等待选举一个并行哈希参与者来分配哈希表。
HashBatchLoad 等待其他并行哈希参与者完成加载哈希表。
HashBuildAllocate 等待被选中的并行哈希参与者分配初始哈希表。
HashBuildElect 等待选举一个并行哈希参与者来分配初始哈希表。
HashBuildHashInner 等待其他并行哈希参与者完成对内部关系的哈希处理。
HashBuildHashOuter 等待其他并行哈希参与者完成对外部关系的分区。
HashGrowBatchesDecide 等待选举一个并行哈希参与者来决定未来的批次增长。
HashGrowBatchesElect 等待选举一个并行哈希参与者来分配更多批次。
HashGrowBatchesFinish 等待被选中的并行哈希参与者来决定未来的批次增长。
HashGrowBatchesReallocate 等待被选中的并行哈希参与者来分配更多批次。
HashGrowBatchesRepartition 等待其他并行哈希参与者完成重新分区。
HashGrowBucketsElect 等待选举一个并行哈希参与者来分配更多桶。
HashGrowBucketsReallocate 等待被选中的并行哈希参与者完成分配更多桶。
HashGrowBucketsReinsert 等待其他并行哈希参与者完成将元组插入到新桶中。
LogicalApplySendData 等待逻辑复制领导应用进程向并行应用进程发送数据。
LogicalParallelApplyStateChange 等待逻辑复制并行应用进程更改状态。
LogicalSyncData 等待逻辑复制远程服务器发送初始表同步的数据。
LogicalSyncStateChange 等待逻辑复制远程服务器更改状态。
MessageQueueInternal 等待另一个进程连接到共享消息队列。
MessageQueuePutMessage 等待将协议消息写入共享消息队列。
MessageQueueReceive 等待从共享消息队列接收字节。
MessageQueueSend 等待向共享消息队列发送字节。
MultixactCreation 等待多事务创建完成。
ParallelBitmapScan 等待并行位图扫描初始化。
ParallelCreateIndexScan 等待并行 CREATE INDEX 工作进程完成堆扫描。
ParallelFinish 等待并行工作进程完成计算。
ProcarrayGroupUpdate 等待组领导在事务结束时清除事务 ID。
ProcSignalBarrier 等待所有后端进程处理屏障事件。
Promote 等待备用服务器升级。
RecoveryConflictSnapshot 等待回收清理的恢复冲突解决。
RecoveryConflictTablespace 等待删除表空间的恢复冲突解决。
RecoveryEndCommand 等待 recovery_end_command 完成。
RecoveryPause 等待恢复恢复。
ReplicationOriginDrop 等待复制源变为非活动状态，以便可以删除它。
ReplicationSlotDrop 等待复制槽变为非活动状态，以便可以删除它。
RestoreCommand 等待 restore_command 完成。
SafeSnapshot 等待获取用于 READ ONLY DEFERRABLE 事务的有效快照。
SyncRep 等待同步复制期间来自远程服务器的确认。
WalReceiverExit 等待 WAL 接收器退出。
WalReceiverWaitStart 等待启动进程发送用于流复制的初始数据。
WalSummaryReady 等待生成新的 WAL 摘要。
XactGroupUpdate 等待组领导在事务结束时更新事务状态。

表 27.11. Lock 类型的等待事件

Lock 等待事件 描述
advisory 等待获取咨询用户锁。
applytransaction 等待获取逻辑复制订阅者正在应用的远程事务的锁。
extend 等待扩展关系。
frozenid 等待更新 pg_database.datfrozenxid 和 pg_database.datminmxid。
object 等待获取非关系数据库对象的锁。
page 等待获取关系页的锁。
relation 等待获取关系的锁。
spectoken 等待获取推测插入锁。
transactionid 等待事务完成。
tuple 等待获取元组的锁。
userlock 等待获取用户锁。
virtualxid 等待获取虚拟事务 ID 锁；请参阅第 66.1 节。

表 27.12. Lwlock 类型的等待事件

LWLock 等待事件 描述
AddinShmemInit 等待管理共享内存中扩展的空间分配。
AutoFile 等待更新 postgresql.auto.conf 文件。
Autovacuum 等待读取或更新自动清理工作进程的当前状态。
AutovacuumSchedule 等待确保选定用于自动清理的表仍然需要清理。
BackgroundWorker 等待读取或更新后台工作进程状态。
BtreeVacuum 等待读取或更新 B 树索引的与清理相关的信息。
BufferContent 等待访问内存中的数据页。
BufferMapping 等待将数据块与缓冲池中的缓冲区关联。
CheckpointerComm 等待管理 fsync 请求。
CommitTs 等待读取或更新为事务提交时间戳设置的最后一个值。
CommitTsBuffer 等待提交时间戳 SLRU 缓冲区上的 I/O。
CommitTsSLRU 等待访问提交时间戳 SLRU 缓存。
ControlFile 等待读取或更新 pg_control 文件或创建新的 WAL 文件。
DSMRegistry 等待读取或更新动态共享内存注册表。
DSMRegistryDSA 等待访问动态共享内存注册表的动态共享内存分配器。
DSMRegistryHash 等待访问动态共享内存注册表的共享哈希表。
DynamicSharedMemoryControl 等待读取或更新动态共享内存分配信息。
注入点 等待读取或更新与注入点相关的信息。
LockFastPath 等待读取或更新进程的快速路径锁信息。
LockManager 等待读取或更新有关“重量级”锁的信息。
LogicalRepLauncherDSA 等待访问逻辑复制启动器的动态共享内存分配器。
LogicalRepLauncherHash 等待访问逻辑复制启动器的共享哈希表。
LogicalRepWorker 等待读取或更新逻辑复制工作进程的状态。
MultiXactGen 等待读取或更新共享多事务状态。
MultiXactMemberBuffer 等待多事务成员 SLRU 缓冲区上的 I/O。
MultiXactMemberSLRU 等待访问多事务成员 SLRU 缓存。
MultiXactOffsetBuffer 等待多事务偏移 SLRU 缓冲区上的 I/O。
MultiXactOffsetSLRU 等待访问多事务偏移 SLRU 缓存。
MultiXactTruncation 等待读取或截断多事务信息。
NotifyBuffer 等待 NOTIFY 消息 SLRU 缓冲区上的 I/O。
NotifyQueue 等待读取或更新 NOTIFY 消息。
NotifyQueueTail 等待更新 NOTIFY 消息存储的限制。
NotifySLRU 等待访问 NOTIFY 消息 SLRU 缓存。
OidGen 等待分配新的 OID。
ParallelAppend 等待在并行追加计划执行期间选择下一个子计划。
ParallelHashJoin 等待在并行哈希连接计划执行期间同步工作进程。
ParallelQueryDSA 等待并行查询动态共享内存分配。
ParallelVacuumDSA 等待并行清理动态共享内存分配。
PerSessionDSA 等待并行查询动态共享内存分配。
PerSessionRecordType 等待访问并行查询的有关复合类型的信息。
PerSessionRecordTypmod 等待访问并行查询的有关标识匿名记录类型的类型修饰符的信息。
PerXactPredicateList 等待访问并行查询期间当前可序列化事务持有的谓词锁列表。
PgStatsData 等待共享内存统计数据访问。
PgStatsDSA 等待统计动态共享内存分配器访问。
PgStatsHash 等待统计共享内存哈希表访问。
PredicateLockManager 等待访问可序列化事务使用的谓词锁信息。
ProcArray 等待访问每个进程共享的数据结构（通常是为了获取快照或报告会话的事务 ID）。
RelationMapping 等待读取或更新 pg_filenode.map 文件（用于跟踪某些系统目录的文件节点分配）。
RelCacheInit 等待读取或更新 pg_internal.init 关系缓存初始化文件。
ReplicationOrigin 等待创建、删除或使用复制源。
ReplicationOriginState 等待读取或更新一个复制源的进度。
ReplicationSlotAllocation 等待分配或释放复制槽。
ReplicationSlotControl 等待读取或更新复制槽状态。
ReplicationSlotIO 等待复制槽上的 I/O。
SerialBuffer 等待可序列化事务冲突 SLRU 缓冲区上的 I/O。
SerialControl 等待读取或更新共享的 pg_serial 状态。
SerializableFinishedList 等待访问已完成的可序列化事务列表。
SerializablePredicateList 等待访问可序列化事务持有的谓词锁列表。
SerializableXactHash 等待读取或更新有关可序列化事务的信息。
SerialSLRU 等待访问可序列化事务冲突 SLRU 缓存。
SharedTidBitmap 等待在并行位图索引扫描期间访问共享 TID 位图。
SharedTupleStore 等待在并行查询期间访问共享元组存储。
ShmemIndex 等待在共享内存中查找或分配空间。
SInvalRead 等待从共享目录失效队列中检索消息。
SInvalWrite 等待向共享目录失效队列添加消息。
SubtransBuffer 等待子事务 SLRU 缓冲区上的 I/O。
SubtransSLRU 等待访问子事务 SLRU 缓存。
SyncRep 等待读取或更新有关同步复制状态的信息。
SyncScan 等待选择同步表扫描的起始位置。
TablespaceCreate 等待创建或删除表空间。
TwoPhaseState 等待读取或更新已准备事务的状态。
WaitEventCustom 等待读取或更新自定义等待事件信息。
WALBufMapping 等待替换 WAL 缓冲区中的页面。
WALInsert 等待将 WAL 数据插入到内存缓冲区中。
WALSummarizer 等待读取或更新 WAL 汇总状态。
WALWrite 等待将 WAL 缓冲区写入磁盘。
WrapLimitsVacuum 等待更新事务 ID 和多事务消耗的限制。
XactBuffer 等待事务状态 SLRU 缓冲区上的 I/O。
XactSLRU 等待访问事务状态 SLRU 缓存。
XactTruncation 等待执行 pg_xact_status 或更新其可用的最旧事务 ID。
XidGen 等待分配新的事务 ID。

表 27.13。类型为 Timeout 的等待事件

Timeout 等待事件 描述
BaseBackupThrottle 在执行基本备份时，当活动受到限制时等待。
CheckpointWriteDelay 在执行检查点时，在写入之间等待。
PgSleep 由于调用 pg_sleep 或其同类函数而等待。
RecoveryApplyDelay 由于延迟设置，在恢复期间等待应用 WAL。
RecoveryRetrieveRetryInterval 在恢复期间等待，当 WAL 数据从任何来源（pg_wal、存档或流）都不可用时。
RegisterSyncRequest 当请求队列已满时，在向检查点发送同步请求时等待。
SpinDelay 在获取有争议的自旋锁时等待。
VacuumDelay 在基于成本的清理延迟点等待。
VacuumTruncate 等待获取独占锁，以截断已清理表的末尾的任何空页。
WalSummarizerError 在 WAL 汇总器错误之后等待。

以下是如何查看等待事件的示例

SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event is NOT NULL;
 pid  | wait_event_type | wait_event
------+-----------------+------------
 2540 | Lock            | relation
 6644 | LWLock          | ProcArray
(2 rows)

SELECT a.pid, a.wait_event, w.description
  FROM pg_stat_activity a JOIN
       pg_wait_events w ON (a.wait_event_type = w.type AND
                            a.wait_event = w.name)
  WHERE a.wait_event is NOT NULL and a.state = 'active';
-[ RECORD 1 ]------------------------------------------------------​------------
pid         | 686674
wait_event  | WALInitSync
description | Waiting for a newly initialized WAL file to reach durable storage

注意

扩展可以向 表 27.8 和 表 27.12 中显示的列表添加 Extension、InjectionPoint 和 LWLock 事件。在某些情况下，扩展分配的 LWLock 的名称并非在所有服务器进程中都可用。它可能只报告为 “extension”，而不是扩展分配的名称。

27.2.4. pg_stat_replication #

pg_stat_replication 视图将为每个 WAL 发送进程包含一行，显示有关复制到该发送方连接的备用服务器的统计信息。仅列出直接连接的备用服务器；没有关于下游备用服务器的信息可用。

表 27.14。 pg_stat_replication 视图

列 类型

描述

pid integer

WAL 发送进程的进程 ID

usesysid oid

登录到此 WAL 发送进程的用户的 OID

usename name

登录到此 WAL 发送进程的用户的名称

application_name text

连接到此 WAL 发送方的应用程序的名称

client_addr inet

连接到此 WAL 发送方的客户端的 IP 地址。如果此字段为空，则表示客户端是通过服务器计算机上的 Unix 套接字连接的。

client_hostname text

连接的客户端的主机名，如 client_addr 的反向 DNS 查找报告的那样。仅当 log_hostname 启用时，此字段才不会为 null，并且仅适用于 IP 连接。

client_port integer

客户端用于与此 WAL 发送方通信的 TCP 端口号，如果使用 Unix 套接字，则为 -1

backend_start timestamp with time zone

此进程启动的时间，即客户端连接到此 WAL 发送方的时间

backend_xmin xid

此备用服务器的 xmin 水平线，由 hot_standby_feedback 报告。

state text

当前 WAL 发送方状态。可能的值为

  • startup: 此 WAL 发送方正在启动。

  • catchup: 此 WAL 发送方连接的备用服务器正在赶上主服务器。

  • streaming: 此 WAL 发送方的连接备用服务器已赶上主服务器后，正在流式传输更改。

  • backup: 此 WAL 发送方正在发送备份。

  • stopping: 此 WAL 发送方正在停止。

sent_lsn pg_lsn

在此连接上发送的最后写入预写日志位置

write_lsn pg_lsn

此备用服务器写入磁盘的最后写入预写日志位置

flush_lsn pg_lsn

此备用服务器刷新到磁盘的最后写入预写日志位置

replay_lsn pg_lsn

在此备用服务器上重播到数据库中的最后写入预写日志位置

write_lag interval

最近在本地刷新 WAL 和接收到此备用服务器已写入（但尚未刷新或应用）的通知之间经过的时间。如果此服务器配置为同步备用服务器，则可以使用此时间来衡量 synchronous_commit 级别 remote_write 在提交时产生的延迟。

flush_lag interval

最近在本地刷新 WAL 和接收到此备用服务器已写入并刷新（但尚未应用）的通知之间经过的时间。如果此服务器配置为同步备用服务器，则可以使用此时间来衡量 synchronous_commit 级别 on 在提交时产生的延迟。

replay_lag interval

最近在本地刷新 WAL 和接收到此备用服务器已写入、刷新和应用它的通知之间经过的时间。如果此服务器配置为同步备用服务器，则可以使用此时间来衡量 synchronous_commit 级别 remote_apply 在提交时产生的延迟。

sync_priority integer

在基于优先级的同步复制中，此备用服务器被选为同步备用服务器的优先级。这在基于仲裁的同步复制中不起作用。

sync_state text

此备用服务器的同步状态。可能的值为

  • async: 此备用服务器是异步的。

  • potential: 此备用服务器现在是异步的，但如果当前同步服务器之一失败，则有可能变为同步。

  • sync: 此备用服务器是同步的。

  • quorum: 此备用服务器被视为仲裁备用服务器的候选者。

reply_time timestamp with time zone

从备用服务器接收的最后一个回复消息的发送时间

在 pg_stat_replication 视图中报告的延迟时间是对最近的 WAL 进行写入、刷新和重播以及发送方了解它所花费时间的度量。如果远程服务器配置为同步备用服务器，则这些时间表示每个同步提交级别引入的提交延迟。对于异步备用服务器，replay_lag 列近似于最近的事务对查询可见之前产生的延迟。如果备用服务器已完全赶上发送服务器并且不再有 WAL 活动，则最近测量的延迟时间将继续显示一段时间，然后显示 NULL。

延迟时间自动适用于物理复制。逻辑解码插件可以选择发出跟踪消息；如果它们不这样做，则跟踪机制将仅显示 NULL 延迟。

注意

报告的延迟时间并不是预测假设当前重播速率，备用服务器赶上发送服务器需要多长时间。这样的系统在生成新的 WAL 时会显示相似的时间，但当发送方变得空闲时会有所不同。特别是，当备用服务器完全赶上时，pg_stat_replication 会显示写入、刷新和重播最近报告的 WAL 位置所花费的时间，而不是某些用户可能期望的零。这与衡量最近写入事务的同步提交和事务可见性延迟的目标一致。为了减少期望不同延迟模型的用户的困惑，延迟列在完全重播的空闲系统上短时间后会恢复为 NULL。监控系统应选择将其表示为缺少数据、零还是继续显示最后一个已知值。

27.2.5. pg_stat_replication_slots #

pg_stat_replication_slots 视图将为每个逻辑复制槽包含一行，显示有关其使用情况的统计信息。

表 27.15。 pg_stat_replication_slots 视图

列 类型

描述

slot_name text

复制槽的唯一集群范围标识符

spill_txns bigint

一旦逻辑解码用于解码 WAL 中的更改的内存超过 logical_decoding_work_mem，则溢出到磁盘的事务数。对于顶层事务和子事务，该计数器都会递增。

spill_count bigint

在为此槽解码 WAL 中的更改时，事务溢出到磁盘的次数。每次事务溢出时，此计数器都会递增，并且同一事务可能会溢出多次。

spill_bytes bigint

在为此槽执行 WAL 更改解码时，溢出到磁盘的已解码事务数据量。此计数器和其他溢出计数器可用于衡量逻辑解码期间发生的 I/O，并允许调整 logical_decoding_work_mem。

stream_txns bigint

在逻辑解码用于解码此槽的 WAL 更改的内存超过 logical_decoding_work_mem 后，流式传输到解码输出插件的正在进行中的事务的数量。流式传输仅适用于顶层事务（子事务不能独立流式传输），因此子事务的计数器不会增加。

stream_countbigint

在解码此槽的 WAL 更改时，正在进行中的事务被流式传输到解码输出插件的次数。每次流式传输事务时，此计数器都会增加，并且同一个事务可能会被流式传输多次。

stream_bytesbigint

为将正在进行中的事务流式传输到解码输出插件而解码的事务数据量，该数据是在解码此槽的 WAL 更改时生成的。此槽的此流式传输计数器和其他计数器可用于调整 logical_decoding_work_mem。

total_txns bigint

发送到此槽的解码输出插件的已解码事务的数量。这仅计算顶层事务，子事务不增加计数。请注意，这包括已流式传输和/或溢出的事务。

total_bytesbigint

为将事务发送到此槽的解码输出插件而解码的事务数据量。请注意，这包括已流式传输和/或溢出的数据。

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.6. pg_stat_wal_receiver #

pg_stat_wal_receiver 视图将仅包含一行，显示有关该接收器连接的服务器的 WAL 接收器的统计信息。

表 27.16. pg_stat_wal_receiver 视图

列 类型

描述

pid integer

WAL 接收器进程的进程 ID

status text

WAL 接收器进程的活动状态

receive_start_lsn pg_lsn

WAL 接收器启动时使用的第一个预写日志位置

receive_start_tli integer

WAL 接收器启动时使用的第一个时间线编号

written_lsn pg_lsn

最后接收并写入磁盘但未刷新的预写日志位置。这不应用于数据完整性检查。

flushed_lsn pg_lsn

最后接收并刷新到磁盘的预写日志位置，该字段的初始值是 WAL 接收器启动时使用的第一个日志位置

received_tli integer

最后接收并刷新到磁盘的预写日志位置的时间线编号，该字段的初始值是 WAL 接收器启动时使用的第一个日志位置的时间线编号

last_msg_send_time timestamp with time zone

从原始 WAL 发送者收到的最后一条消息的发送时间

last_msg_receipt_time timestamp with time zone

从原始 WAL 发送者收到的最后一条消息的接收时间

latest_end_lsn pg_lsn

报告给原始 WAL 发送者的最后一个预写日志位置

latest_end_time timestamp with time zone

报告给原始 WAL 发送者的最后一个预写日志位置的时间

slot_name text

此 WAL 接收器使用的复制槽名称

sender_host text

此 WAL 接收器连接的 PostgreSQL 实例的主机。这可以是主机名、IP 地址，或者如果通过 Unix 套接字连接，则可以是目录路径。（路径情况可以区分，因为它将始终是绝对路径，以 / 开头。）

sender_port integer

此 WAL 接收器连接的 PostgreSQL 实例的端口号。

conninfo text

此 WAL 接收器使用的连接字符串，其中包含模糊处理的安全性敏感字段。

27.2.7. pg_stat_recovery_prefetch #

pg_stat_recovery_prefetch 视图将仅包含一行。wal_distance、block_distance 和 io_depth 列显示当前值，其他列显示可以使用 pg_stat_reset_shared 函数重置的累积计数器。

表 27.17. pg_stat_recovery_prefetch 视图

列 类型

描述

stats_reset timestamp with time zone

上次重置这些统计信息的时间

prefetch bigint

由于块不在缓冲区池中而预取的块数

hit bigint

由于块已在缓冲区池中而未预取的块数

skip_init bigint

由于块将被零初始化而未预取的块数

skip_new bigint

由于块尚不存在而未预取的块数

skip_fpw bigint

由于 WAL 中包含完整页面映像而未预取的块数

skip_rep bigint

由于块最近已被预取而未预取的块数

wal_distance int

预取器提前查看多少字节

block_distance int

预取器提前查看多少个块

io_depth int

已启动但尚不知道已完成的预取数量

27.2.8. pg_stat_subscription #

表 27.18. pg_stat_subscription 视图

列 类型

描述

subid oid

订阅的 OID

subname name

订阅的名称

worker_type text

订阅工作进程的类型。可能的类型包括 apply、parallel apply 和 table synchronization。

pid integer

订阅工作进程的进程 ID

leader_pid integer

如果此进程是并行应用工作进程，则为领导者应用工作进程的进程 ID；如果此进程是领导者应用工作进程或表同步工作进程，则为 NULL

relid oid

工作进程正在同步的关系的 OID；对于领导者应用工作进程和并行应用工作进程，则为 NULL

received_lsn pg_lsn

最后接收的预写日志位置，该字段的初始值为 0；对于并行应用工作进程，则为 NULL

last_msg_send_time timestamp with time zone

从原始 WAL 发送者收到的最后一条消息的发送时间；对于并行应用工作进程，则为 NULL

last_msg_receipt_time timestamp with time zone

从原始 WAL 发送者收到的最后一条消息的接收时间；对于并行应用工作进程，则为 NULL

latest_end_lsn pg_lsn

报告给原始 WAL 发送者的最后一个预写日志位置；对于并行应用工作进程，则为 NULL

latest_end_time timestamp with time zone

报告给原始 WAL 发送者的最后一个预写日志位置的时间；对于并行应用工作进程，则为 NULL

27.2.9. pg_stat_subscription_stats #

pg_stat_subscription_stats 视图将每个订阅包含一行。

表 27.19. pg_stat_subscription_stats 视图

列 类型

描述

subid oid

订阅的 OID

subname name

订阅的名称

apply_error_count bigint

应用更改时发生错误的次数

sync_error_count bigint

初始表同步期间发生错误的次数

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.10. pg_stat_ssl #

pg_stat_ssl 视图将每个后端或 WAL 发送器进程包含一行，显示有关此连接上 SSL 使用情况的统计信息。可以将其与 pg_stat_activity 或 pg_stat_replication 的 pid 列连接，以获取有关连接的更多详细信息。

表 27.20. pg_stat_ssl 视图

列 类型

描述

pid integer

后端或 WAL 发送器进程的进程 ID

ssl boolean

如果在此连接上使用了 SSL，则为 True

version text

正在使用的 SSL 版本，如果此连接上未使用 SSL，则为 NULL

cipher text

正在使用的 SSL 密码的名称，如果此连接上未使用 SSL，则为 NULL

bits integer

使用的加密算法中的位数，如果此连接上未使用 SSL，则为 NULL

client_dn text

客户端证书中使用的可分辨名称 (DN) 字段，如果未提供客户端证书或此连接上未使用 SSL，则为 NULL。如果 DN 字段长度超过 NAMEDATALEN（标准构建中为 64 个字符），则此字段将被截断。

client_serial numeric

客户端证书的序列号，如果未提供客户端证书或此连接上未使用 SSL，则为 NULL。证书序列号和证书颁发者的组合唯一标识一个证书（除非颁发者错误地重用了序列号）。

issuer_dn text

客户端证书颁发者的 DN，如果未提供客户端证书或此连接上未使用 SSL，则为 NULL。此字段像 client_dn 一样被截断。

27.2.11. pg_stat_gssapi #

pg_stat_gssapi 视图将每个后端包含一行，显示有关此连接上 GSSAPI 使用情况的信息。可以将其与 pg_stat_activity 或 pg_stat_replication 的 pid 列连接，以获取有关连接的更多详细信息。

表 27.21. pg_stat_gssapi 视图

列 类型

描述

pid integer

后端的进程 ID

gss_authenticated boolean

如果此连接使用了 GSSAPI 身份验证，则为 True

principal text

用于验证此连接的主体，如果未使用 GSSAPI 验证此连接，则为 NULL。如果主体长度超过 NAMEDATALEN（标准构建中为 64 个字符），则此字段将被截断。

encrypted boolean

如果在此连接上使用 GSSAPI 加密，则为 True

credentials_delegated boolean

如果在此连接上委托了 GSSAPI 凭据，则为 True。

27.2.12. pg_stat_archiver #

pg_stat_archiver 视图始终只有一行，其中包含有关集群归档进程的数据。

表 27.22. pg_stat_archiver 视图

列 类型

描述

archived_count bigint

已成功归档的 WAL 文件数量

last_archived_wal text

最近成功归档的 WAL 文件的名称

last_archived_time timestamp with time zone

最近一次成功归档操作的时间

failed_count bigint

归档 WAL 文件失败的尝试次数

last_failed_wal text

最近一次失败的归档操作的 WAL 文件名

last_failed_time timestamp with time zone

最近一次失败的归档操作的时间

stats_reset timestamp with time zone

上次重置这些统计信息的时间

通常，WAL 文件按顺序从旧到新进行归档，但这不能保证，并且在提升备用服务器或崩溃恢复后等特殊情况下不成立。因此，假设所有早于 last_archived_wal 的文件也已成功归档是不安全的。

27.2.13. pg_stat_io #

pg_stat_io 视图将为后端类型、目标 I/O 对象和 I/O 上下文的每种组合包含一行，显示集群范围的 I/O 统计信息。省略没有意义的组合。

当前，跟踪关系（例如表、索引）的 I/O。但是，绕过共享缓冲区（例如，将表从一个表空间移动到另一个表空间时）的关系 I/O 当前未跟踪。

表 27.23. pg_stat_io 视图

列 类型

描述

backend_type text

后端类型（例如，后台工作进程、自动清理工作进程）。有关 backend_type 的更多信息，请参阅 pg_stat_activity。某些 backend_type 不会累积 I/O 操作统计信息，并且不会包含在视图中。

object text

I/O 操作的目标对象。可能的值为

  • relation：永久关系。

  • temp relation：临时关系。

context text

I/O 操作的上下文。可能的值为

  • normal：I/O 操作类型的默认或标准 context。例如，默认情况下，关系数据会读入和写出共享缓冲区。因此，关系数据与共享缓冲区之间的数据读写在 context normal 中进行跟踪。

  • vacuum：在清理和分析永久关系时，在共享缓冲区之外执行的 I/O 操作。临时表清理使用与其它临时表 I/O 操作相同的本地缓冲区池，并在 context normal 中进行跟踪。

  • bulkread：在共享缓冲区之外完成的某些大型读取 I/O 操作，例如，大型表的顺序扫描。

  • bulkwrite：在共享缓冲区之外完成的某些大型写入 I/O 操作，例如 COPY。

reads bigint

读取操作的数量，每个操作的大小在 op_bytes 中指定。

read_time double precision

读取操作所花费的时间，以毫秒为单位（如果启用 track_io_timing，否则为零）

writes bigint

写入操作的数量，每个操作的大小在 op_bytes 中指定。

write_time double precision

写入操作所花费的时间，以毫秒为单位（如果启用 track_io_timing，否则为零）

writebacks bigint

进程请求内核写入永久存储的 op_bytes 大小的单元数。

writeback_time double precision

在回写操作中花费的时间，以毫秒为单位（如果启用 track_io_timing，否则为零）。这包括排队回写请求所花费的时间，以及可能的回写脏数据所花费的时间。

extends bigint

关系扩展操作的数量，每个操作的大小在 op_bytes 中指定。

extend_time double precision

扩展操作所花费的时间，以毫秒为单位（如果启用 track_io_timing，否则为零）

op_bytes bigint

每次读取、写入或扩展 I/O 的字节数。

关系数据读取、写入和扩展以 block_size 为单位进行，该单位来自构建时参数 BLCKSZ，默认值为 8192。

hits bigint

在共享缓冲区中找到所需块的次数。

evictions bigint

为了使其可用于其他用途，块从共享或本地缓冲区中写出的次数。

在 context normal 中，这计算从缓冲区中逐出并替换为另一个块的次数。在 context bulkwrite、bulkread 和 vacuum 中，这计算从共享缓冲区中逐出块以便将共享缓冲区添加到单独的、大小受限的环形缓冲区以用于批量 I/O 操作的次数。

reuses bigint

在共享缓冲区之外的、大小受限的环形缓冲区中，现有缓冲区在 bulkread、bulkwrite 或 vacuum context 中作为 I/O 操作的一部分被重用的次数。

fsyncs bigint

fsync 调用的次数。这些仅在 context normal 中进行跟踪。

fsync_time double precision

在 fsync 操作中花费的时间，以毫秒为单位（如果启用 track_io_timing，否则为零）

stats_reset timestamp with time zone

上次重置这些统计信息的时间。

某些后端类型永远不会在某些 I/O 对象上和/或在某些 I/O 上下文中执行 I/O 操作。这些行将从视图中省略。例如，检查点进程不检查临时表，因此对于 backend_type checkpointer 和 object temp relation 将没有行。

此外，某些 I/O 操作永远不会由某些后端类型执行，也不会在某些 I/O 对象上和/或在某些 I/O 上下文中执行。这些单元格将为 NULL。例如，临时表不进行 fsync，因此对于 object temp relation，fsyncs 将为 NULL。此外，后台写入器不执行读取，因此在 backend_type background writer 的行中，reads 将为 NULL。

pg_stat_io 可用于为数据库调整提供信息。例如

  • 较高的 evictions 计数可能表明应增加共享缓冲区。

  • 客户端后端依赖检查点进程来确保将数据持久保存到永久存储。 client backend 的大量 fsyncs 可能表明共享缓冲区或检查点进程配置错误。有关配置检查点进程的更多信息，请参见 第 28.5 节。

  • 通常，客户端后端应该能够依赖辅助进程（如检查点进程和后台写入器）来尽可能多地写入脏数据。客户端后端的大量写入可能表明共享缓冲区或检查点进程配置错误。有关配置检查点进程的更多信息，请参见 第 28.5 节。

注意

仅当启用 track_io_timing 时，跟踪 I/O 时间的列才为非零。如果自上次统计信息重置以来没有在整个时间内启用 track_io_timing，则用户在引用这些列及其对应的 I/O 操作时应小心。

27.2.14. pg_stat_bgwriter #

pg_stat_bgwriter 视图始终只有一行，其中包含有关集群后台写入器的数据。

表 27.24. pg_stat_bgwriter 视图

列 类型

描述

buffers_clean bigint

后台写入器写入的缓冲区数量

maxwritten_clean bigint

后台写入器因写入过多缓冲区而停止清理扫描的次数

buffers_alloc bigint

已分配的缓冲区数量

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.15. pg_stat_checkpointer #

pg_stat_checkpointer 视图始终只有一行，包含关于集群检查点进程的数据。

表 27.25. pg_stat_checkpointer 视图

列 类型

描述

num_timed bigint

由于超时而计划的检查点数量。 请注意，如果自上次检查点以来服务器一直处于空闲状态，则可能会跳过检查点，此值会计算已完成和跳过的检查点。

num_requested bigint

已执行的请求的检查点数量

restartpoints_timed bigint

由于超时或尝试执行失败后而计划的重启点数量

restartpoints_req bigint

请求的重启点数量

restartpoints_done bigint

已执行的重启点数量

write_time double precision

处理检查点和重启点过程中，将文件写入磁盘所花费的总时间，以毫秒为单位

sync_time double precision

处理检查点和重启点过程中，将文件同步到磁盘所花费的总时间，以毫秒为单位

buffers_written bigint

在检查点和重启点期间写入的缓冲区数量

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.16. pg_stat_wal #

pg_stat_wal 视图始终只有一行，包含关于集群 WAL 活动的数据。

表 27.26. pg_stat_wal 视图

列 类型

描述

wal_records bigint

生成的 WAL 记录总数

wal_fpi bigint

生成的 WAL 全页映像总数

wal_bytes numeric

以字节为单位生成的 WAL 总量

wal_buffers_full bigint

由于 WAL 缓冲区已满而将 WAL 数据写入磁盘的次数

wal_write bigint

通过 XLogWrite 请求将 WAL 缓冲区写入磁盘的次数。 有关内部 WAL 函数 XLogWrite 的更多信息，请参阅 第 28.5 节。

wal_sync bigint

通过 issue_xlog_fsync 请求将 WAL 文件同步到磁盘的次数（如果 fsync 为 on 且 wal_sync_method 为 fdatasync、fsync 或 fsync_writethrough，否则为零）。 有关内部 WAL 函数 issue_xlog_fsync 的更多信息，请参阅 第 28.5 节。

wal_write_time double precision

通过 XLogWrite 请求将 WAL 缓冲区写入磁盘所花费的总时间，以毫秒为单位（如果启用了 track_wal_io_timing，否则为零）。 这包括 wal_sync_method 为 open_datasync 或 open_sync 时的同步时间。

wal_sync_time double precision

通过 issue_xlog_fsync 请求将 WAL 文件同步到磁盘所花费的总时间，以毫秒为单位（如果启用了 track_wal_io_timing、fsync 为 on 且 wal_sync_method 为 fdatasync、fsync 或 fsync_writethrough，否则为零）。

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.17. pg_stat_database #

pg_stat_database 视图将包含集群中每个数据库的一行，以及共享对象的一行，显示数据库范围的统计信息。

表 27.27. pg_stat_database 视图

列 类型

描述

datid oid

此数据库的 OID，对于属于共享关系的对象，则为 0

datname name

此数据库的名称，对于共享对象，则为 NULL。

numbackends integer

当前连接到此数据库的后端数量，对于共享对象，则为 NULL。 这是此视图中唯一返回反映当前状态的值的列；所有其他列返回自上次重置以来累积的值。

xact_commit bigint

此数据库中已提交的事务数量

xact_rollback bigint

此数据库中已回滚的事务数量

blks_read bigint

在此数据库中读取的磁盘块数

blks_hit bigint

磁盘块已在缓冲区缓存中找到的次数，因此无需读取（这仅包括 PostgreSQL 缓冲区缓存中的命中，不包括操作系统的文件系统缓存）

tup_returned bigint

在此数据库中，顺序扫描提取的活动行数和索引扫描返回的索引条目数

tup_fetched bigint

在此数据库中，索引扫描提取的活动行数

tup_inserted bigint

在此数据库中，查询插入的行数

tup_updated bigint

在此数据库中，查询更新的行数

tup_deleted bigint

在此数据库中，查询删除的行数

conflicts bigint

在此数据库中，由于与恢复的冲突而取消的查询数量。（冲突仅发生在备用服务器上；有关详细信息，请参阅pg_stat_database_conflicts。）

temp_files bigint

在此数据库中，查询创建的临时文件数量。 无论创建临时文件的原因（例如，排序或哈希）如何，并且无论 log_temp_files 设置如何，都会计算所有临时文件。

temp_bytes bigint

在此数据库中，查询写入临时文件的数据总量。 无论创建临时文件的原因如何，并且无论 log_temp_files 设置如何，都会计算所有临时文件。

deadlocks bigint

在此数据库中检测到的死锁数量

checksum_failures bigint

在此数据库（或共享对象）中检测到的数据页校验和失败的数量，如果未启用数据校验和，则为 NULL。

checksum_last_failure timestamp with time zone

在此数据库（或共享对象）中检测到上次数据页校验和失败的时间，如果未启用数据校验和，则为 NULL。

blk_read_time double precision

在此数据库中，后端读取数据文件块所花费的时间，以毫秒为单位（如果启用了 track_io_timing，否则为零）

blk_write_time double precision

在此数据库中，后端写入数据文件块所花费的时间，以毫秒为单位（如果启用了 track_io_timing，否则为零）

session_time double precision

此数据库中，数据库会话所花费的时间，以毫秒为单位（请注意，仅当会话状态更改时才会更新统计信息，因此，如果会话已空闲很长时间，则不会包括此空闲时间）

active_time double precision

在此数据库中，执行 SQL 语句所花费的时间，以毫秒为单位（这对应于 pg_stat_activity 中的 active 和 fastpath function call 状态）

idle_in_transaction_time double precision

在此数据库中，在事务中空闲所花费的时间，以毫秒为单位（这对应于 pg_stat_activity 中的 idle in transaction 和 idle in transaction (aborted) 状态）

sessions bigint

为此数据库建立的会话总数

sessions_abandoned bigint

由于与客户端的连接丢失而终止的此数据库的数据库会话数量

sessions_fatal bigint

由于致命错误而终止的此数据库的数据库会话数量

sessions_killed bigint

由于操作员干预而终止的此数据库的数据库会话数量

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.18. pg_stat_database_conflicts #

pg_stat_database_conflicts 视图将包含每个数据库的一行，显示关于备用服务器上由于与恢复的冲突而发生的查询取消的数据库范围的统计信息。 此视图将仅包含备用服务器上的信息，因为冲突不会发生在主服务器上。

表 27.28. pg_stat_database_conflicts 视图

列 类型

描述

datid oid

数据库的 OID

datname name

此数据库的名称

confl_tablespace bigint

在此数据库中，由于已删除的表空间而被取消的查询数量

confl_lock bigint

在此数据库中，由于锁超时而被取消的查询数量

confl_snapshot bigint

在此数据库中，由于旧快照而被取消的查询数量

confl_bufferpin bigint

在此数据库中，由于已固定的缓冲区而被取消的查询数量

confl_deadlock bigint

在此数据库中，由于死锁而被取消的查询数量

confl_active_logicalslot bigint

在此数据库中，由于主服务器上的旧快照或过低的 wal_level 而取消的逻辑槽使用次数

27.2.19. pg_stat_all_tables #

pg_stat_all_tables 视图将包含当前数据库中每个表（包括 TOAST 表）的一行，显示关于对该特定表的访问的统计信息。pg_stat_user_tables 和 pg_stat_sys_tables 视图包含相同的信息，但经过筛选以仅分别显示用户表和系统表。

表 27.29. pg_stat_all_tables 视图

列 类型

描述

relid oid

表的 OID

schemaname name

此表所在的模式名称

relname name

此表的名称

seq_scan bigint

在此表上发起的顺序扫描次数

last_seq_scan timestamp with time zone

基于最近事务停止时间，此表上最后一次顺序扫描的时间

seq_tup_read bigint

顺序扫描获取的活动行数

idx_scan bigint

在此表上发起的索引扫描次数

last_idx_scan timestamp with time zone

基于最近事务停止时间，此表上最后一次索引扫描的时间

idx_tup_fetch bigint

索引扫描获取的活动行数

n_tup_ins bigint

插入的总行数

n_tup_upd bigint

更新的总行数。（包括在 n_tup_hot_upd 和 n_tup_newpage_upd 中统计的行更新，以及剩余的非HOT更新。）

n_tup_del bigint

删除的总行数

n_tup_hot_upd bigint

HOT 更新的行数。这些是不需要在索引中存在后继版本的更新。

n_tup_newpage_upd bigint

后继版本转到新堆页的更新行数，留下一个具有指向不同堆页的t_ctid 字段的原始版本。这些总是非HOTHOT 更新。

n_live_tup bigint

估计的活动行数

n_dead_tup bigint

估计的死行数

n_mod_since_analyze bigint

自上次分析此表以来，估计的修改行数

n_ins_since_vacuum bigint

自上次清理此表以来，估计的插入行数

last_vacuum timestamp with time zone

上次手动清理此表的时间（不包括 VACUUM FULL）

last_autovacuum timestamp with time zone

上次自动清理守护进程清理此表的时间

last_analyze timestamp with time zone

上次手动分析此表的时间

last_autoanalyze timestamp with time zone

上次自动清理守护进程分析此表的时间

vacuum_count bigint

此表被手动清理的次数（不包括 VACUUM FULL）

autovacuum_count bigint

此表被自动清理守护进程清理的次数

analyze_count bigint

此表被手动分析的次数

autoanalyze_count bigint

此表被自动清理守护进程分析的次数

27.2.20. pg_stat_all_indexes #

pg_stat_all_indexes 视图将包含当前数据库中每个索引的一行，显示关于访问该特定索引的统计信息。pg_stat_user_indexes 和 pg_stat_sys_indexes 视图包含相同的信息，但过滤后仅分别显示用户索引和系统索引。

表 27.30. pg_stat_all_indexes 视图

列 类型

描述

relid oid

此索引的表的 OID

indexrelid oid

此索引的 OID

schemaname name

此索引所在的模式名称

relname name

此索引的表的名称

indexrelname name

此索引的名称

idx_scan bigint

在此索引上发起的索引扫描次数

last_idx_scan timestamp with time zone

基于最近事务停止时间，此索引上最后一次扫描的时间

idx_tup_read bigint

此索引上的扫描返回的索引条目数

idx_tup_fetch bigint

使用此索引的简单索引扫描获取的活动表行数

索引可以被简单索引扫描、“位图” 索引扫描和优化器使用。在位图扫描中，多个索引的输出可以通过 AND 或 OR 规则组合，因此在使用位图扫描时，很难将单个堆行获取与特定索引相关联。因此，位图扫描会增加其使用的索引的 pg_stat_all_indexes.idx_tup_read 计数，并增加表的 pg_stat_all_tables.idx_tup_fetch 计数，但不会影响 pg_stat_all_indexes.idx_tup_fetch。优化器还会访问索引以检查其值在优化器统计记录范围之外的提供的常量，因为优化器统计可能已过时。

注意

idx_tup_read 和 idx_tup_fetch 计数即使在不使用任何位图扫描的情况下也可能不同，因为 idx_tup_read 会计算从索引中检索的索引条目，而 idx_tup_fetch 会计算从表中获取的活动行。如果使用索引获取任何死行或未提交的行，或者通过仅索引扫描避免任何堆获取，则后者会更少。

注意

使用某些SQL构造来搜索与多个标量值的列表或数组中的任何值匹配的行的查询（请参阅 第 9.25 节）会在查询执行期间执行多个“原始”索引扫描（每个标量值最多一个原始扫描）。每个内部原始索引扫描都会增加 pg_stat_all_indexes.idx_scan，因此索引扫描的计数可能大大超过索引扫描执行器节点执行的总数。

27.2.21. pg_statio_all_tables #

pg_statio_all_tables 视图将包含当前数据库中每个表（包括 TOAST 表）的一行，显示关于该特定表上的 I/O 统计信息。pg_statio_user_tables 和 pg_statio_sys_tables 视图包含相同的信息，但过滤后仅分别显示用户表和系统表。

表 27.31. pg_statio_all_tables 视图

列 类型

描述

relid oid

表的 OID

schemaname name

此表所在的模式名称

relname name

此表的名称

heap_blks_read bigint

从此表读取的磁盘块数

heap_blks_hit bigint

此表中的缓冲区命中数

idx_blks_read bigint

从此表的所有索引读取的磁盘块数

idx_blks_hit bigint

此表的所有索引中的缓冲区命中数

toast_blks_read bigint

从此表的 TOAST 表（如果有）读取的磁盘块数

toast_blks_hit bigint

此表的 TOAST 表（如果有）中的缓冲区命中数

tidx_blks_read bigint

从此表的 TOAST 表索引（如果有）读取的磁盘块数

tidx_blks_hit bigint

此表的 TOAST 表索引（如果有）中的缓冲区命中数

27.2.22. pg_statio_all_indexes #

pg_statio_all_indexes 视图将包含当前数据库中每个索引的一行，显示关于该特定索引上的 I/O 统计信息。pg_statio_user_indexes 和 pg_statio_sys_indexes 视图包含相同的信息，但过滤后仅分别显示用户索引和系统索引。

表 27.32. pg_statio_all_indexes 视图

列 类型

描述

relid oid

此索引的表的 OID

indexrelid oid

此索引的 OID

schemaname name

此索引所在的模式名称

relname name

此索引的表的名称

indexrelname name

此索引的名称

idx_blks_read bigint

从此索引读取的磁盘块数

idx_blks_hit bigint

此索引中的缓冲区命中数

27.2.23. pg_statio_all_sequences #

pg_statio_all_sequences 视图将包含当前数据库中每个序列的一行，显示关于该特定序列上的 I/O 统计信息。

表 27.33. pg_statio_all_sequences 视图

列 类型

描述

relid oid

序列的 OID

schemaname name

此序列所在的模式名称

relname name

此序列的名称

blks_read bigint

从此序列读取的磁盘块数

blks_hit bigint

此序列中的缓冲区命中数

27.2.24. pg_stat_user_functions #

pg_stat_user_functions 视图将包含每个被跟踪函数的一行，显示关于该函数执行情况的统计信息。track_functions 参数控制要跟踪哪些函数。

表 27.34. pg_stat_user_functions 视图

列 类型

描述

funcid oid

函数的 OID

schemaname name

此函数所在的模式名称

funcname name

此函数的名称

calls bigint

此函数被调用的次数

total_time double precision

在此函数和它调用的所有其他函数中花费的总时间，以毫秒为单位

self_time double precision

此函数本身所花费的总时间，不包括它调用的其他函数，单位为毫秒。

27.2.25. pg_stat_slru #

PostgreSQL 通过 SLRU（简单最近最少使用）缓存访问某些磁盘上的信息。pg_stat_slru 视图将包含每个被跟踪的 SLRU 缓存的行，显示有关访问缓存页面的统计信息。

对于核心服务器的每个 SLRU 缓存，都有一个配置参数来控制其大小，并附加后缀 _buffers。

表 27.35. pg_stat_slru 视图

列 类型

描述

name text

SLRU 的名称

blks_zeroed bigint

初始化期间清零的块数

blks_hit bigint

在 SLRU 中找到磁盘块的次数，因此不需要读取（这仅包括 SLRU 中的命中，不包括操作系统的文件系统缓存）

blks_read bigint

为这个 SLRU 读取的磁盘块数

blks_written bigint

为这个 SLRU 写入的磁盘块数

blks_exists bigint

为此 SLRU 检查存在的块数

flushes bigint

为此 SLRU 刷新脏数据的次数

truncates bigint

为此 SLRU 截断的次数

stats_reset timestamp with time zone

上次重置这些统计信息的时间

27.2.26. 统计函数 #

可以通过编写使用与上面显示的标准视图相同的底层统计访问函数的查询来设置查看统计信息的其他方式。有关函数名称等详细信息，请查阅标准视图的定义。（例如，在 psql 中，您可以发出 \d+ pg_stat_activity。）每个数据库的统计信息的访问函数采用数据库 OID 作为参数来标识要报告的数据库。每个表和每个索引的函数采用表或索引 OID。每个函数统计信息的函数采用函数 OID。请注意，只有当前数据库中的表、索引和函数才能使用这些函数查看。

与累积统计系统相关的其他函数列在 表 27.36 中。

表 27.36. 其他统计函数

函数

描述

pg_backend_pid () → integer

返回附加到当前会话的服务器进程的进程 ID。

pg_stat_get_activity ( integer ) → setof record

返回有关具有指定进程 ID 的后端的记录信息，如果指定 NULL，则为系统中每个活动后端返回一条记录。返回的字段是 pg_stat_activity 视图中的字段子集。

pg_stat_get_snapshot_timestamp () → timestamp with time zone

返回当前统计快照的时间戳，如果没有拍摄统计快照，则返回 NULL。如果 stats_fetch_consistency 设置为 snapshot，则在事务中首次访问累积统计信息时会拍摄快照。

pg_stat_get_xact_blocks_fetched ( oid ) → bigint

返回当前事务中表或索引的块读取请求数。此数字减去 pg_stat_get_xact_blocks_hit 得出内核 read() 调用的次数；由于内核级缓冲，实际物理读取次数通常较低。

pg_stat_get_xact_blocks_hit ( oid ) → bigint

返回当前事务中表或索引的块读取请求数，这些请求在缓存中找到（不触发内核 read() 调用）。

pg_stat_clear_snapshot () → void

丢弃当前统计快照或缓存的信息。

pg_stat_reset () → void

将当前数据库的所有统计计数器重置为零。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

pg_stat_reset_shared ( [ target text DEFAULT NULL ] ) → void

根据参数将一些集群范围的统计计数器重置为零。target 可以是

  • archiver: 重置 pg_stat_archiver 视图中显示的所有计数器。

  • bgwriter: 重置 pg_stat_bgwriter 视图中显示的所有计数器。

  • checkpointer: 重置 pg_stat_checkpointer 视图中显示的所有计数器。

  • io: 重置 pg_stat_io 视图中显示的所有计数器。

  • recovery_prefetch: 重置 pg_stat_recovery_prefetch 视图中显示的所有计数器。

  • slru: 重置 pg_stat_slru 视图中显示的所有计数器。

  • wal: 重置 pg_stat_wal 视图中显示的所有计数器。

  • NULL 或未指定：重置上面列出的视图中的所有计数器。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

pg_stat_reset_single_table_counters ( oid ) → void

将当前数据库或集群中所有数据库共享的单个表或索引的统计信息重置为零。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

pg_stat_reset_single_function_counters ( oid ) → void

将当前数据库中单个函数的统计信息重置为零。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

pg_stat_reset_slru ( [ target text DEFAULT NULL ] ) → void

将单个 SLRU 缓存或集群中所有 SLRU 的统计信息重置为零。如果 target 为 NULL 或未指定，则重置所有 SLRU 缓存的 pg_stat_slru 视图中显示的所有计数器。该参数可以是 commit_timestamp、multixact_member、multixact_offset、notify、serializable、subtransaction 或 transaction 之一，以仅重置该条目的计数器。如果参数是 other（或者实际上是任何无法识别的名称），则会重置所有其他 SLRU 缓存（例如扩展定义的缓存）的计数器。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

pg_stat_reset_replication_slot ( text ) → void

重置由参数定义的复制槽的统计信息。如果参数为 NULL，则重置所有复制槽的统计信息。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

pg_stat_reset_subscription_stats ( oid ) → void

将 pg_stat_subscription_stats 视图中显示的单个订阅的统计信息重置为零。如果参数为 NULL，则重置所有订阅的统计信息。

默认情况下，此函数仅限于超级用户，但可以授予其他用户 EXECUTE 权限来运行该函数。

警告

使用 pg_stat_reset() 还会重置自动清理用于确定何时触发清理或分析的计数器。重置这些计数器可能会导致自动清理不执行必要的工作，这可能会导致诸如表膨胀或过时的表统计信息等问题。建议在重置统计信息后进行数据库范围的 ANALYZE。

pg_stat_get_activity（pg_stat_activity 视图的底层函数）返回一个记录集，其中包含有关每个后端进程的所有可用信息。有时，可能更方便地只获取此信息的一个子集。在这种情况下，可以使用另一组每个后端的统计信息访问函数；这些函数在 表 27.37 中显示。这些访问函数使用会话的后端 ID 号，这是一个小的整数（>= 0），它与任何并发会话的后端 ID 不同，尽管会话的 ID 一旦退出就可以回收。后端 ID 用于标识会话的临时模式（如果有的话）等等。函数 pg_stat_get_backend_idset 提供了一种方便的方法来列出所有活动后端的 ID 号，以便调用这些函数。例如，要显示所有后端的PID和当前查询

SELECT pg_stat_get_backend_pid(backendid) AS pid,
       pg_stat_get_backend_activity(backendid) AS query
FROM pg_stat_get_backend_idset() AS backendid;

表 27.37. 每个后端的统计信息函数

函数

描述

pg_stat_get_backend_activity ( integer ) → text

返回此后端最近查询的文本。

pg_stat_get_backend_activity_start ( integer ) → 带时区的时间戳

返回后端最近一次查询开始的时间。

pg_stat_get_backend_client_addr ( integer ) → inet

返回连接到此后端的客户端的 IP 地址。

pg_stat_get_backend_client_port ( integer ) → integer

返回客户端用于通信的 TCP 端口号。

pg_stat_get_backend_dbid ( integer ) → oid

返回此后端连接的数据库的 OID。

pg_stat_get_backend_idset () → integer 的集合

返回当前活动后端 ID 号的集合。

pg_stat_get_backend_pid ( integer ) → integer

返回此后端的进程 ID。

pg_stat_get_backend_start ( integer ) → 带时区的时间戳

返回此进程启动的时间。

pg_stat_get_backend_subxact ( integer ) → 记录

返回有关具有指定 ID 的后端的子事务信息的记录。返回的字段是subxact_count，它是后端子事务缓存中子事务的数量，以及subxact_overflow，它指示后端的子事务缓存是否溢出。

pg_stat_get_backend_userid ( integer ) → oid

返回登录此后端的用户的 OID。

pg_stat_get_backend_wait_event ( integer ) → 文本

如果此后端当前正在等待，则返回等待事件名称，否则返回 NULL。请参阅表 27.5至表 27.13。

pg_stat_get_backend_wait_event_type ( integer ) → 文本

如果此后端当前正在等待，则返回等待事件类型名称，否则返回 NULL。有关详细信息，请参阅表 27.4。

pg_stat_get_backend_xact_start ( integer ) → 带时区的时间戳

返回后端当前事务开始的时间。

上一个  向上  下一个
27.1. 标准 Unix 工具  主页  27.3. 查看锁

提交更正

如果您在文档中发现任何不正确、与您特定功能的使用体验不符或需要进一步澄清的地方，请使用此表单报告文档问题。