PostgreSQL：文档：17：27.2. 累积统计系统

27.2. 累积统计系统
上一页	上级	第27章监控数据库活动	首页	下一页

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 中显示的动态统计信息视图中的一些信息受到安全限制。普通用户只能查看有关其自身会话（属于其所属角色的会话）的所有信息。在有关其他会话的行中，许多列将为 null。但是，请注意，会话的存在及其通用属性（例如其会话用户和数据库）对所有用户都是可见的。超级用户和具有内置角色 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`的后端（包括 autovacuum 工作进程）一行，显示当前进度。请参阅第 27.4.1 节。
`pg_stat_progress_create_index`	每个正在运行`CREATE INDEX`或`REINDEX`的后端一行，显示当前进度。请参阅第 27.4.4 节。
`pg_stat_progress_vacuum`	每个正在运行`VACUUM`的后端（包括 autovacuum 工作进程）一行，显示当前进度。请参阅第 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`和相关视图中）。此视图中没有活动行和死行数量以及 vacuum 和 analyze 操作的列。
`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 地址。如果此字段为空，则表示客户端通过服务器机器上的 Unix 套接字连接，或者这是一个内部进程（例如 autovacuum）。
`client_hostname` `text` 已连接客户端的主机名，由 `client_addr` 的反向 DNS 查询报告。此字段仅对 IP 连接有效，并且仅在启用 log_hostname 时有效。
`client_port` `integer` 客户端用于与此后端通信的 TCP 端口号，或者如果使用 Unix 套接字，则为 `-1`。如果此字段为空，则表示这是一个内部服务器进程。
`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`。此外，扩展注册的后台工作程序可能具有其他类型。

列类型

描述

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 地址。如果此字段为空，则表示客户端通过服务器机器上的 Unix 套接字连接，或者这是一个内部进程（例如 autovacuum）。

client_hostname text

已连接客户端的主机名，由 client_addr 的反向 DNS 查询报告。此字段仅对 IP 连接有效，并且仅在启用 log_hostname 时有效。

client_port integer

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

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 状态，它可能正在等待某个事件，也可能没有。如果状态为 active 且 wait_event 不为空，则表示正在执行查询，但系统中的某个地方正在阻塞它。

表 27.4. 等待事件类型

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

注意

扩展可以将 Extension、InjectionPoint 和 LWLock 事件添加到表 27.8 和表 27.12 中所示的列表中。在某些情况下，扩展分配的 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 查询报告。此字段仅对 IP 连接有效，并且仅在启用 log_hostname 时有效。
`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` 从备用服务器接收到的最后一个回复消息的发送时间

列类型

描述

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 查询报告。此字段仅对 IP 连接有效，并且仅在启用 log_hostname 时有效。

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` 在为该槽解码 WAL 中的更改时，解码用于将事务发送到解码输出插件的事务数据量。请注意，这包括已流式传输和/或溢出的数据。
`stats_reset` `timestamp with time zone` 上次重置这些统计信息的时间

列类型

描述

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

在为该槽解码 WAL 中的更改时，解码用于将事务发送到解码输出插件的事务数据量。请注意，这包括已流式传输和/或溢出的数据。

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 接收器使用的连接字符串，其中安全敏感字段已模糊处理。

列类型

描述

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` 已启动但尚未知是否已完成的预取次数

列类型

描述

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

列类型

描述

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` 上次重置这些统计信息的时间

列类型

描述

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用法的统计信息。它可以通过 pid 列与 pg_stat_activity 或 pg_stat_replication 连接，以获取有关连接的更多详细信息。

表 27.20. pg_stat_ssl 视图

列类型描述
`pid` `integer` 后端或WAL发送者进程的进程ID
`ssl` `boolean` 如果此连接使用SSL，则为真
`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` 一样会被截断。

列类型

描述

pid integer

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

ssl boolean

如果此连接使用SSL，则为真

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用法的相关信息。它可以通过 pid 列与 pg_stat_activity 或 pg_stat_replication 连接，以获取有关连接的更多详细信息。

表 27.21. pg_stat_gssapi 视图

列类型描述
`pid` `integer` 后端的进程ID
`gss_authenticated` `boolean` 如果此连接使用GSSAPI身份验证，则为真
`principal` `text` 用于验证此连接的主体，如果未使用GSSAPI验证此连接，则为NULL。如果主体长度超过 `NAMEDATALEN`（标准构建中为64个字符），则此字段会被截断。
`encrypted` `boolean` 如果此连接正在使用GSSAPI加密，则为真
`credentials_delegated` `boolean` 如果此连接上已委托GSSAPI凭据，则为真。

列类型

描述

pid integer

后端的进程ID

gss_authenticated boolean

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

principal text

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

encrypted boolean

如果此连接正在使用GSSAPI加密，则为真

credentials_delegated boolean

如果此连接上已委托GSSAPI凭据，则为真。

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` 上次重置这些统计信息的时间

列类型

描述

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` 上次重置这些统计信息的时间。

列类型

描述

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` 上次重置这些统计信息的时间

列类型

描述

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` 上次重置这些统计信息的时间

列类型

描述

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` 上次重置这些统计信息的时间

列类型

描述

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` `双精度浮点数` 后端在此数据库中读取数据文件块所花费的时间，以毫秒为单位（如果启用了track_io_timing，否则为零）
`blk_write_time` `双精度浮点数` 后端在此数据库中写入数据文件块所花费的时间，以毫秒为单位（如果启用了track_io_timing，否则为零）
`session_time` `双精度浮点数` 数据库会话在此数据库中花费的时间，以毫秒为单位（请注意，仅在会话状态发生变化时才会更新统计信息，因此，如果会话长时间处于空闲状态，则不会包含此空闲时间）
`active_time` `双精度浮点数` 在此数据库中执行 SQL 语句所花费的时间，以毫秒为单位（这对应于`pg_stat_activity`中的`active`和`fastpath function call`状态）
`idle_in_transaction_time` `双精度浮点数` 在此数据库中处于事务状态时处于空闲状态所花费的时间，以毫秒为单位（这对应于`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` 上次重置这些统计信息的时间

列类型

描述

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 双精度浮点数

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

blk_write_time 双精度浮点数

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

session_time 双精度浮点数

数据库会话在此数据库中花费的时间，以毫秒为单位（请注意，仅在会话状态发生变化时才会更新统计信息，因此，如果会话长时间处于空闲状态，则不会包含此空闲时间）

active_time 双精度浮点数

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

idle_in_transaction_time 双精度浮点数

在此数据库中处于事务状态时处于空闲状态所花费的时间，以毫秒为单位（这对应于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过低而取消的此数据库中逻辑槽的使用次数

列类型

描述

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` `名称` 此表所在的模式的名称
`relname` `名称` 此表的名称
`seq_scan` `bigint` 在此表上启动的顺序扫描次数
`last_seq_scan` `带有时区的timestamp` 此表上上次顺序扫描的时间，基于最近的事务停止时间
`seq_tup_read` `bigint` 顺序扫描获取的活动行数
`idx_scan` `bigint` 在此表上启动的索引扫描次数
`last_idx_scan` `带有时区的timestamp` 此表上上次索引扫描的时间，基于最近的事务停止时间
`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`字段的原始版本。这些始终是非HOT更新。
`n_live_tup` `bigint` 活动行的估计数量
`n_dead_tup` `bigint` 死行的估计数量
`n_mod_since_analyze` `bigint` 自上次分析此表以来修改的行的估计数量
`n_ins_since_vacuum` `bigint` 自上次清理此表以来插入的行的估计数量
`last_vacuum` `带有时区的timestamp` 手动清理此表的最后时间（不包括`VACUUM FULL`）
`last_autovacuum` `带有时区的timestamp` 自动清理守护程序上次清理此表的时间
`last_analyze` `带有时区的timestamp` 手动分析此表的最后时间
`last_autoanalyze` `带有时区的timestamp` 自动分析守护程序上次分析此表的时间
`vacuum_count` `bigint` 手动清理此表的次数（不包括`VACUUM FULL`）
`autovacuum_count` `bigint` 自动清理守护程序清理此表的次数
`analyze_count` `bigint` 手动分析此表的次数
`autoanalyze_count` `bigint` 自动分析守护程序分析此表的次数

列类型

描述

relid oid

表的 OID

schemaname 名称

此表所在的模式的名称

relname 名称

此表的名称

seq_scan bigint

在此表上启动的顺序扫描次数

last_seq_scan 带有时区的timestamp

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

seq_tup_read bigint

顺序扫描获取的活动行数

idx_scan bigint

在此表上启动的索引扫描次数

last_idx_scan 带有时区的timestamp

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

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字段的原始版本。这些始终是非HOT更新。

n_live_tup bigint

活动行的估计数量

n_dead_tup bigint

死行的估计数量

n_mod_since_analyze bigint

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

n_ins_since_vacuum bigint

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

last_vacuum 带有时区的timestamp

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

last_autovacuum 带有时区的timestamp

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

last_analyze 带有时区的timestamp

手动分析此表的最后时间

last_autoanalyze 带有时区的timestamp

自动分析守护程序上次分析此表的时间

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` `名称` 此索引所在的模式的名称
`relname` `名称` 此索引的表的名称
`indexrelname` `名称` 此索引的名称
`idx_scan` `bigint` 在此索引上启动的索引扫描次数
`last_idx_scan` `带有时区的timestamp` 此索引上上次扫描的时间，基于最近的事务停止时间
`idx_tup_read` `bigint` 在此索引上扫描返回的索引条目数
`idx_tup_fetch` `bigint` 使用此索引的简单索引扫描获取的活动表行数

列类型

描述

relid oid

此索引的表的 OID

indexrelid oid

此索引的 OID

schemaname 名称

此索引所在的模式的名称

relname 名称

此索引的表的名称

indexrelname 名称

此索引的名称

idx_scan bigint

在此索引上启动的索引扫描次数

last_idx_scan 带有时区的timestamp

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

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` `名称` 此表所在的模式的名称
`relname` `名称` 此表的名称
`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表索引（如果有）中的缓冲区命中次数

列类型

描述

relid oid

表的 OID

schemaname 名称

此表所在的模式的名称

relname 名称

此表的名称

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` `名称` 此索引所在的模式的名称
`relname` `名称` 此索引的表的名称
`indexrelname` `名称` 此索引的名称
`idx_blks_read` `bigint` 从该索引读取的磁盘块数
`idx_blks_hit` `bigint` 该索引中的缓冲区命中次数

列类型

描述

relid oid

此索引的表的 OID

indexrelid oid

此索引的 OID

schemaname 名称

此索引所在的模式的名称

relname 名称

此索引的表的名称

indexrelname 名称

此索引的名称

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` `名称` 此序列所在的模式名称
`relname` `名称` 此序列的名称
`blks_read` `bigint` 从该序列读取的磁盘块数
`blks_hit` `bigint` 该序列中的缓冲区命中次数

列类型

描述

relid oid

序列的 OID

schemaname 名称

此序列所在的模式名称

relname 名称

此序列的名称

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` `名称` 此函数所在的模式名称
`funcname` `name` 此函数的名称
`calls` `bigint` 此函数被调用的次数
`total_time` `double precision` 在此函数及其所有其他被调用函数中花费的总时间（以毫秒为单位）
`self_time` `double precision` 仅在此函数本身中花费的总时间，不包括其调用的其他函数（以毫秒为单位）

列类型

描述

funcid oid

函数的 OID

schemaname 名称

此函数所在的模式名称

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` 上次重置这些统计信息的时间

列类型

描述

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` 或未指定，则将 `pg_stat_slru` 视图中所有 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_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 或未指定，则将 pg_stat_slru 视图中所有 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() 还会重置 autovacuum 用于确定何时触发 vacuum 或 analyze 的计数器。重置这些计数器可能会导致 autovacuum 不执行必要的工作，这可能会导致表膨胀或表统计信息过时等问题。建议在重置统计信息后进行数据库范围的 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` ) → `timestamp with time zone` 返回后端最近查询的开始时间。
`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` () → `setof integer` 返回当前活动后端 ID 号的集合。
`pg_stat_get_backend_pid` ( `integer` ) → `integer` 返回此后端的进程 ID。
`pg_stat_get_backend_start` ( `integer` ) → `timestamp with time zone` 返回此进程的启动时间。
`pg_stat_get_backend_subxact` ( `integer` ) → `record` 返回有关具有指定 ID 的后端子事务的信息记录。返回的字段是 `subxact_count`，表示后端子事务缓存中的子事务数，以及 `subxact_overflow`，表示后端子事务缓存是否溢出。
`pg_stat_get_backend_userid` ( `integer` ) → `oid` 返回登录到此后端的用户的 OID。
`pg_stat_get_backend_wait_event` ( `integer` ) → `text` 如果此后端当前正在等待，则返回等待事件名称，否则返回 NULL。请参阅表 27.5 到表 27.13。
`pg_stat_get_backend_wait_event_type` ( `integer` ) → `text` 如果此后端当前正在等待，则返回等待事件类型名称，否则返回 NULL。有关详细信息，请参阅表 27.4。
`pg_stat_get_backend_xact_start` ( `integer` ) → `timestamp with time zone` 返回后端当前事务的开始时间。

函数

描述

pg_stat_get_backend_activity ( integer ) → text

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

pg_stat_get_backend_activity_start ( integer ) → timestamp with time zone

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

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 () → setof integer

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

pg_stat_get_backend_pid ( integer ) → integer

返回此后端的进程 ID。

pg_stat_get_backend_start ( integer ) → timestamp with time zone

返回此进程的启动时间。

pg_stat_get_backend_subxact ( integer ) → record

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

pg_stat_get_backend_userid ( integer ) → oid

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

pg_stat_get_backend_wait_event ( integer ) → text

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

pg_stat_get_backend_wait_event_type ( integer ) → text

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

pg_stat_get_backend_xact_start ( integer ) → timestamp with time zone

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

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. 统计函数 #

警告

提交更正

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. 统计函数 #

警告

提交更正

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` #