27.2. 累积统计系统 — PostgreSQL 19

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

27.2.1. 统计信息收集配置 #

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

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

参数 track_cost_delay_timing 启用对基于代价的清理延迟的监控。

参数 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.29 节中所述那样，使用底层的累积统计函数构建自定义视图。

当使用累积统计视图和函数来监视收集的数据时，重要的是要意识到信息不会立即更新。每个单独的服务器进程在空闲之前将累积的统计信息刷新到共享内存中，但每 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 权限的角色可以查看所有会话的全部信息。

表 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`	至多一行，显示有关恢复状态的统计信息。有关详细信息，请参阅 `pg_stat_recovery`。
`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.6 节。
`pg_stat_progress_cluster`	每个正在运行 `REPACK`、`CLUSTER` 或 `VACUUM FULL` 的后端一行，显示当前进度。请参阅第 27.4.2 节。
`pg_stat_progress_repack`	每个正在运行 `REPACK`、`CLUSTER` 或 `VACUUM FULL` 的后端一行，显示当前进度。请参阅第 27.4.5 节。
`pg_stat_progress_basebackup`	每个正在流式传输基础备份的 WAL 发送进程一行，显示当前进度。请参阅第 27.4.7 节。
`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_lock`	每种锁类型一行，显示集簇范围的锁统计信息。有关详细信息，请参阅 `pg_stat_lock`。
`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_autovacuum_scores`	当前数据库中的每个表一行，显示该表当前的自动清理评分。有关详细信息，请参阅 `pg_stat_autovacuum_scores`。
`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 套接字连接或者这是一个内部进程，如自动清理。
`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` 这个进程的当前事务被启动的时间，如果没有活动事务则为空值。如果当前查询是其事务中的第一个查询，这一列等于 `query_start` 列。
`query_start` `timestamp with time zone` 当前活动查询开始的时间；如果 `state` 不是 `active`，则为上一个查询的开始时间
`state_change` `timestamp with time zone` `state` 上一次发生改变的时间
`wait_event_type` `text` 后端正在等待的事件类型（如果有）；否则为空值。请参阅表 27.4。
`wait_event` `text` 如果此后端当前正在等待，则返回等待事件名称，否则为空值。请参阅表 27.5 到表 27.13。
`state` `text` 该后端当前的总体状态。可能的值为： `starting`：后端正处于初始启动阶段。客户端认证在此阶段执行。 `active`：后端正在执行一个查询。 `idle`：后端正在等待新的客户端命令。 `idle in transaction`：后端处于事务中，但当前没有执行查询。 `idle in transaction (aborted)`：该状态与 `idle in transaction` 类似，但事务中的某个语句导致了错误。 `fastpath function call`：后端正在执行一个快速路径函数。 `disabled`：如果在此后端中禁用了 track_activities，就会报告此状态。
`backend_xid` `xid` 这个后端的顶层事务 ID（如果存在）；请参阅第 67.1 节。
`backend_xmin` `xid` 当前后端的 `xmin` 视界。
`query_id` `bigint` 这个后端的最近查询的标识符。如果 `state` 是 `active`，这个字段显示当前正在执行的查询的标识符。在所有其他状态，它显示执行的最后一个查询的标识符。默认不计算查询标识符，因此该字段将为空值，除非启用 compute_query_id 参数或配置了计算查询标识符的第三方模块。
`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 套接字连接或者这是一个内部进程，如自动清理。

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

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

query_start timestamp with time zone

当前活动查询开始的时间；如果 state 不是 active，则为上一个查询的开始时间

state_change timestamp with time zone

state 上一次发生改变的时间

wait_event_type text

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

wait_event text

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

state text

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

starting：后端正处于初始启动阶段。客户端认证在此阶段执行。
active：后端正在执行一个查询。
idle：后端正在等待新的客户端命令。
idle in transaction：后端处于事务中，但当前没有执行查询。
idle in transaction (aborted)：该状态与 idle in transaction 类似，但事务中的某个语句导致了错误。
fastpath function call：后端正在执行一个快速路径函数。
disabled：如果在此后端中禁用了 track_activities，就会报告此状态。

backend_xid xid

这个后端的顶层事务 ID（如果存在）；请参阅第 67.1 节。

backend_xmin xid

当前后端的 xmin 视界。

query_id bigint

这个后端的最近查询的标识符。如果 state 是 active，这个字段显示当前正在执行的查询的标识符。在所有其他状态，它显示执行的最后一个查询的标识符。默认不计算查询标识符，因此该字段将为空值，除非启用 compute_query_id 参数或配置了计算查询标识符的第三方模块。

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 非空，就意味着某个查询正在执行，但在系统中的某处被阻塞了。为将报告开销保持在较低水平，系统不会尝试为某个后端同步活动数据的不同方面。因此，视图各列之间可能暂时存在不一致。

表 27.4. 等待事件类型

等待事件类型	描述
`Activity`	服务器进程空闲。此事件类型表示在其主处理循环中等待活动的进程。`wait_event` 将标识具体的等待点；参见表 27.5。
`Buffer`	服务器进程正在等待访问一个数据缓冲区。参见表 27.6。
`Client`	服务器进程正在等待连接到用户应用程序的套接字上的活动。因此，服务器预计发生一些独立于其内部进程的事情。`wait_event` 将识别特定的等待点；参见表 27.7。
`Extension`	服务器进程正在等待扩展模块定义的某个条件。参见表 27.8。
`InjectionPoint`	服务器进程正在等待某个注入点在测试中达到预定义结果。更多细节请参见第 36.10.14 节。该类型没有预定义的等待点。
`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`	在检查点进程的主循环中等待。
`CheckpointerShutdown`	等待检查点进程终止。
`IoWorkerMain`	在 I/O 工作进程的主循环中等待。
`LogicalApplyMain`	在逻辑复制应用进程的主循环中等待。
`LogicalLauncherMain`	在逻辑复制启动器进程的主循环中等待。
`LogicalParallelApplyMain`	在逻辑复制并行应用进程的主循环中等待。
`RecoveryWalStream`	在流恢复期间，在启动进程的主循环中等待 WAL 到达。
`ReplicationSlotsyncMain`	在复制槽同步的主循环中等待。
`ReplicationSlotsyncShutdown`	等待复制槽同步工作进程关闭。
`SysloggerMain`	在 syslogger 进程的主循环中等待。
`WalReceiverMain`	在 WAL 接收进程的主循环中等待。
`WalSenderMain`	在 WAL 发送进程的主循环中等待。
`WalSummarizerWal`	在 WAL 汇总进程中等待生成更多 WAL。
`WalWriterMain`	在 WAL 写入进程的主循环中等待。

表 27.6. Buffer 类型的等待事件

`Buffer` 等待事件	描述
`BufferCleanup`	等待获得缓冲区上的独占钉住。如果另一个进程持有尚未关闭的游标，且该游标最近一次读取的数据来自该缓冲区，缓冲区钉住等待可能会持续较长时间。
`BufferExclusive`	等待获取缓冲区上的排他锁。
`BufferShared`	等待获取缓冲区上的共享锁。
`BufferShareExclusive`	等待获取缓冲区上的共享排他锁。

表 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` 等待事件	描述
`AioIoCompletion`	等待另一个进程完成 I/O。
`AioIoUringExecution`	等待通过 io_uring 执行 I/O。
`AioIoUringSubmit`	等待通过 io_uring 提交 I/O。
`BasebackupRead`	等待基础备份从文件中读取。
`BasebackupSync`	等待基础备份写入的数据同步到持久存储。
`BasebackupWrite`	等待基础备份写入文件。
`BuffileRead`	等待从缓冲文件中读取。
`BuffileTruncate`	等待一个缓冲文件被截断。
`BuffileWrite`	等待对缓冲文件的写入。
`ControlFileRead`	等待读取 `pg_control` 文件。
`ControlFileSync`	等待 `pg_control` 文件同步到持久存储。
`ControlFileSyncUpdate`	等待对 `pg_control` 文件的更新同步到持久存储。
`ControlFileWrite`	等待写入 `pg_control` 文件。
`ControlFileWriteUpdate`	等待写入以更新 `pg_control` 文件。
`CopyFileCopy`	等待文件复制操作。
`CopyFileRead`	在文件复制操作期间等待读取。
`CopyFileWrite`	在文件复制操作期间等待写入。
`CopyFromRead`	在 COPY FROM 期间等待从管道、文件或程序读取数据。
`CopyToWrite`	在 COPY TO 期间等待向管道、文件或程序写入数据。
`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`	在 WAL 发送进程执行时间线命令期间，等待从时间线历史文件读取。
`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`	等待选出的 Parallel Hash 参与者分配 hash 表。
`HashBatchElect`	等待选出负责分配 hash 表的 Parallel Hash 参与者。
`HashBatchLoad`	等待其他 Parallel Hash 参与者完成 hash 表的加载。
`HashBuildAllocate`	等待选出的 Parallel Hash 参与者分配初始 hash 表。
`HashBuildElect`	等待选出负责分配初始 hash 表的 Parallel Hash 参与者。
`HashBuildHashInner`	等待其他 Parallel Hash 参与者完成对内层关系的 hash 处理。
`HashBuildHashOuter`	等待其他 Parallel Hash 参与者完成对外层关系的分区。
`HashGrowBatchesDecide`	等待选出负责决定后续批次增长的 Parallel Hash 参与者。
`HashGrowBatchesElect`	等待选出负责分配更多批次的 Parallel Hash 参与者。
`HashGrowBatchesFinish`	等待选出的 Parallel Hash 参与者决定后续的批次增长。
`HashGrowBatchesReallocate`	等待选出的 Parallel Hash 参与者分配更多批次。
`HashGrowBatchesRepartition`	等待其他 Parallel Hash 参与者完成重新分区。
`HashGrowBucketsElect`	等待选出负责分配更多桶的 Parallel Hash 参与者。
`HashGrowBucketsReallocate`	等待选出的 Parallel Hash 参与者完成更多桶的分配。
`HashGrowBucketsReinsert`	等待其他 Parallel Hash 参与者完成向新桶插入元组。
`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`	等待恢复继续进行。
`RepackWorkerExport`	等待解码工作进程导出新的输出文件。
`ReplicationOriginDrop`	等待复制源变为非活动状态，以便可以删除它。
`ReplicationSlotDrop`	等待复制槽变为非活动状态，以便可以删除它。
`RestoreCommand`	等待 restore_command 完成。
`SafeSnapshot`	等待获取 `READ ONLY DEFERRABLE` 事务的有效快照。
`SyncRep`	在同步复制期间等待来自远程服务器的确认。
`WaitForWalFlush`	等待主库或备库上的 WAL 刷盘达到目标 LSN。
`WaitForWalReplay`	等待备库上的 WAL 重放达到目标 LSN。
`WaitForWalWrite`	等待备库上的 WAL 写入达到目标 LSN。
`WalReceiverExit`	等待 WAL 接收进程退出。
`WalReceiverUpstreamCatchup`	等待上游服务器的 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 锁；参见第 67.1 节。

表 27.12. LWLock 类型的等待事件

`LWLock` 等待事件	描述
`AddinShmemInit`	等待管理扩展在共享内存中的空间分配。
`AioUringCompletion`	等待另一个进程通过 io_uring 完成 I/O。
`AioWorkerControl`	等待更新 AIO 工作进程信息。
`AioWorkerSubmissionQueue`	等待访问 AIO 工作进程的提交队列。
`AutoFile`	等待更新 `postgresql.auto.conf` 文件。
`Autovacuum`	等待读取或更新自动清理工作进程的当前状态。
`AutovacuumSchedule`	等待确认选中进行自动清理的表是否仍需清理。
`BackgroundWorker`	等待读取或更新后台工作进程状态。
`BtreeVacuum`	等待读取或更新 B-树索引的清理相关信息。
`BufferMapping`	等待将数据块与缓冲池中的缓冲区关联。
`CheckpointerComm`	等待管理 fsync 请求。
`CommitTs`	等待读取或更新最近设置的事务提交时间戳值。
`CommitTsBuffer`	在提交时间戳 SLRU 缓冲区上等待 I/O。
`CommitTsSLRU`	等待访问提交时间戳 SLRU 缓存。
`ControlFile`	等待读取或更新 `pg_control` 文件或创建一个新的 WAL 文件。
`DSMRegistry`	等待读取或更新动态共享内存注册表。
`DSMRegistryDSA`	等待访问动态共享内存注册表的动态共享内存分配器。
`DSMRegistryHash`	等待访问动态共享内存注册表的共享 hash 表。
`DynamicSharedMemoryControl`	等待读取或更新动态共享内存分配信息。
`InjectionPoint`	等待读取或更新注入点相关信息。
`LockFastPath`	等待读取或更新进程的快速路径锁信息。
`LockManager`	等待读取或更新有关“重量级”锁的信息。
`LogicalDecodingControl`	等待读取或更新逻辑解码状态信息。
`LogicalRepLauncherDSA`	等待访问逻辑复制启动进程的动态共享内存分配器。
`LogicalRepLauncherHash`	等待访问逻辑复制启动进程的共享 hash 表。
`LogicalRepWorker`	等待读取或更新逻辑复制工作进程的状态。
`MultiXactGen`	等待读取或更新共享的多事务状态。
`MultiXactMemberBuffer`	等待多事务成员 SLRU 缓冲区上的 I/O。
`MultiXactMemberSLRU`	等待访问多事务成员 SLRU 缓存。
`MultiXactOffsetBuffer`	等待多事务偏移量 SLRU 缓冲区上的 I/O。
`MultiXactOffsetSLRU`	等待访问多事务偏移量 SLRU 缓存。
`MultiXactTruncation`	等待读取或截断多事务信息。
`NotifyBuffer`	在 `NOTIFY` 消息 SLRU 缓冲区上等待 I/O。
`NotifyChannelHash`	等待访问 `NOTIFY` 通道 hash 表。
`NotifyQueue`	等待读取或更新 `NOTIFY` 消息。
`NotifyQueueTail`	等待更新 `NOTIFY` 消息存储的限制。
`NotifySLRU`	等待访问 `NOTIFY` 消息 SLRU 缓存。
`OidGen`	等待分配一个新的 OID。
`ParallelAppend`	在 Parallel Append 计划执行期间等待选择下一个子计划。
`ParallelBtreeScan`	在并行 B-树扫描计划执行期间等待同步工作进程。
`ParallelHashJoin`	在 Parallel Hash Join 计划执行期间等待同步工作进程。
`ParallelQueryDSA`	等待并行查询动态共享内存分配。
`ParallelVacuumDSA`	等待为并行清理分配动态共享内存。
`PerSessionDSA`	等待并行查询动态共享内存分配。
`PerSessionRecordType`	等待访问并行查询中有关复合类型的信息。
`PerSessionRecordTypmod`	等待访问并行查询中用于标识匿名记录类型的类型修饰符信息。
`PerXactPredicateList`	在并行查询期间等待访问当前可串行化事务持有的谓词锁列表。
`PgStatsData`	等待访问共享内存中的统计数据。
`PgStatsDSA`	等待访问统计信息的动态共享内存分配器。
`PgStatsHash`	等待访问统计信息的共享内存 hash 表。
`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`	等待读取或更新自定义等待事件信息。
`WaitLSN`	等待读取或更新共享的 LSN 等待状态。
`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`	在执行检查点时，在各次写入之间等待。
`CommitDelay`	等待 WAL 刷盘前的提交延迟。
`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 所示的列表中。

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` 由 hot_standby_feedback 报告的该备库的 `xmin` 视界。如果使用了复制槽（此时备库的 `xmin` 显示在 pg_replication_slots 中），或禁用了 `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 刷盘，到收到该备库已写入该 WAL（但尚未刷盘或应用）的通知之间经过的时间。如果该服务器被配置为同步备库，可用此值衡量在提交时 `synchronous_commit` 级别 `remote_write` 所导致的延迟。
`flush_lag` `interval` 从在本地将最近的 WAL 刷盘，到收到该备库已写入该 WAL 并将其刷盘（但尚未应用）的通知之间经过的时间。如果该服务器被配置为同步备库，可用此值衡量在提交时 `synchronous_commit` 级别 `on` 所导致的延迟。
`replay_lag` `interval` 从在本地将最近的 WAL 刷盘，到收到该备库已写入该 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

由 hot_standby_feedback 报告的该备库的 xmin 视界。如果使用了复制槽（此时备库的 xmin 显示在 pg_replication_slots 中），或禁用了 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 刷盘，到收到该备库已写入该 WAL（但尚未刷盘或应用）的通知之间经过的时间。如果该服务器被配置为同步备库，可用此值衡量在提交时 synchronous_commit 级别 remote_write 所导致的延迟。

flush_lag interval

从在本地将最近的 WAL 刷盘，到收到该备库已写入该 WAL 并将其刷盘（但尚未应用）的通知之间经过的时间。如果该服务器被配置为同步备库，可用此值衡量在提交时 synchronous_commit 级别 on 所导致的延迟。

replay_lag interval

从在本地将最近的 WAL 刷盘，到收到该备库已写入该 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 活动，系统会在短时间内继续显示最近测得的滞后时间，随后显示为空值。

对于物理复制，滞后时间会自动测量。逻辑解码插件可以选择发出跟踪消息；如果没有这样做，跟踪机制会将滞后显示为空值。

注意

报告出的滞后时间并不是根据当前重放速率预测该备库还需多久才能追上发送服务器。在持续生成新 WAL 时，那样的系统可能会显示相近的时间；但当发送端空闲时，就会显示不同的值。特别是当备库已经完全追上时，pg_stat_replication 显示的是写入、刷盘和重放最近报告的 WAL 位置所花费的时间，而不是某些用户可能预期的零。这样做符合为最近写事务测量同步提交和事务可见性延迟的目的。为减少用户因预期另一种滞后模型而产生的混淆，在一个已完全重放且处于空闲状态的系统上，滞后列会在较短时间后恢复为空值。监控系统应自行决定将这种情况表示为缺失数据、零，还是继续显示最近一次已知值。

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`。
`mem_exceeded_countbigint` 逻辑解码使用的内存超过 `logical_decoding_work_mem` 的次数。
`total_txns` `bigint` 针对此槽发送到解码输出插件的已解码事务数。这只统计顶层事务，不会因子事务而增加计数。注意，这包括流式传输和/或溢出的事务。
`total_bytesbigint` 在为此槽从 WAL 解码更改时，为将事务发送到解码输出插件而解码的事务数据量。注意这包括流式传输和/或溢出的数据。
`slotsync_skip_countbigint` 跳过槽同步的次数。槽同步只在备库上发生，因此这个列在主库上没有意义。
`slotsync_last_skiptimestamp with time zone` 最后一次跳过槽同步的时间。槽同步只在备库上发生，因此这个列在主库上没有意义。
`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。

mem_exceeded_countbigint

逻辑解码使用的内存超过 logical_decoding_work_mem 的次数。

total_txns bigint

针对此槽发送到解码输出插件的已解码事务数。这只统计顶层事务，不会因子事务而增加计数。注意，这包括流式传输和/或溢出的事务。

total_bytesbigint

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

slotsync_skip_countbigint

跳过槽同步的次数。槽同步只在备库上发生，因此这个列在主库上没有意义。

slotsync_last_skiptimestamp with time zone

最后一次跳过槽同步的时间。槽同步只在备库上发生，因此这个列在主库上没有意义。

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 接收进程的活动状态。可能的值有： `restarting`：WAL 接收进程已被要求重新开始流式传输。 `starting`：WAL 接收进程已启动，但尚未初始化。 `connecting`：WAL 接收进程正在连接到上游服务器，复制尚未开始。 `stopping`：WAL 接收进程已被要求停止。 `streaming`：WAL 接收进程正在流式传输 WAL 数据。 `waiting`：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 接收进程的活动状态。可能的值有：

restarting：WAL 接收进程已被要求重新开始流式传输。
starting：WAL 接收进程已启动，但尚未初始化。
connecting：WAL 接收进程正在连接到上游服务器，复制尚未开始。
stopping：WAL 接收进程已被要求停止。
streaming：WAL 接收进程正在流式传输 WAL 数据。
waiting：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` #

pg_stat_recovery 视图至多包含一行，用来显示启动进程的恢复状态统计信息。当服务器不处于恢复状态，或者用户没有 pg_read_all_stats 角色的权限时，这个视图不返回任何行。

表 27.17. pg_stat_recovery 视图

列类型描述
`promote_triggered` `boolean` 如果已经触发提升，则为真。
`last_replayed_read_lsn` `pg_lsn` 最近一次成功重放的 WAL 记录在预写式日志中的起始位置。
`last_replayed_end_lsn` `pg_lsn` 最近一次成功重放的 WAL 记录在预写式日志中的结束位置加一。
`last_replayed_tli` `integer` 最近一次成功重放的 WAL 记录所在的时间线。
`replay_end_lsn` `pg_lsn` 当前正在重放的记录的预写式日志位置（结束位置加一）。如果当前没有正在重放的记录，则等于 `last_replayed_end_lsn`。
`replay_end_tli` `integer` 当前正在重放的 WAL 记录所在的时间线。如果当前没有正在重放的记录，则等于 `last_replayed_tli`。
`recovery_last_xact_time` `timestamp with time zone` 恢复期间最近重放的事务提交或中止记录的时间戳。这个时间是该事务的提交或中止 WAL 记录在主库上生成的时间。
`current_chunk_start_time` `timestamp with time zone` 启动进程观察到重放已经追上从流复制接收的最新 WAL 块的时间。用于恢复冲突计时和重放/应用延迟诊断。如果尚未接收到流式 WAL，或无法获得该时间，则为空值。
`pause_state` `text` 恢复暂停状态。可能的值有： `not paused`：恢复正在正常进行。 `pause requested`：已经请求暂停，但恢复尚未真正暂停。 `paused`：恢复已暂停。

列类型

描述

promote_triggered boolean

如果已经触发提升，则为真。

last_replayed_read_lsn pg_lsn

最近一次成功重放的 WAL 记录在预写式日志中的起始位置。

last_replayed_end_lsn pg_lsn

最近一次成功重放的 WAL 记录在预写式日志中的结束位置加一。

last_replayed_tli integer

最近一次成功重放的 WAL 记录所在的时间线。

replay_end_lsn pg_lsn

当前正在重放的记录的预写式日志位置（结束位置加一）。如果当前没有正在重放的记录，则等于 last_replayed_end_lsn。

replay_end_tli integer

当前正在重放的 WAL 记录所在的时间线。如果当前没有正在重放的记录，则等于 last_replayed_tli。

recovery_last_xact_time timestamp with time zone

恢复期间最近重放的事务提交或中止记录的时间戳。这个时间是该事务的提交或中止 WAL 记录在主库上生成的时间。

current_chunk_start_time timestamp with time zone

启动进程观察到重放已经追上从流复制接收的最新 WAL 块的时间。用于恢复冲突计时和重放/应用延迟诊断。如果尚未接收到流式 WAL，或无法获得该时间，则为空值。

pause_state text

恢复暂停状态。可能的值有：

not paused：恢复正在正常进行。
pause requested：已经请求暂停，但恢复尚未真正暂停。
paused：恢复已暂停。

27.2.8. `pg_stat_recovery_prefetch` #

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

表 27.18. 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.9. `pg_stat_subscription` #

表 27.19. pg_stat_subscription 视图

列类型描述
`subid` `oid` 订阅的 OID
`subname` `name` 订阅的名称
`worker_type` `text` 订阅工作进程的类型。可能的类型有 `apply`、`parallel apply`、`table synchronization` 和 `sequence 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 和 sequence 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.10. `pg_stat_subscription_stats` #

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

表 27.20. pg_stat_subscription_stats 视图

列类型描述
`subid` `oid` 订阅的 OID
`subname` `name` 订阅的名称
`apply_error_count` `bigint` 应用更改时发生错误的次数。请注意，导致应用错误的任何冲突都会同时计入 `apply_error_count` 和对应的冲突计数（例如 `confl_*`）。
`sync_seq_error_count` `bigint` 序列同步工作进程发生错误的次数。一个工作进程会同步所有序列，因此一次错误计数增加可能代表多个序列的失败。
`sync_table_error_count` `bigint` 在初始表同步期间发生错误的次数
`confl_insert_exists` `bigint` 在应用更改期间，行插入违反 `NOT DEFERRABLE` 唯一约束的次数。有关该冲突的详细信息，请参阅 insert_exists。
`confl_update_origin_differs` `bigint` 在应用更改期间，更新被应用到先前已被另一个源修改过的行上的次数。有关该冲突的详细信息，请参阅 update_origin_differs。
`confl_update_exists` `bigint` 在应用更改期间，更新后的行值违反 `NOT DEFERRABLE` 唯一约束的次数。有关该冲突的详细信息，请参阅 update_exists。
`confl_update_deleted` `bigint` 在应用更改期间，待更新的元组被另一个源并发删除的次数。有关该冲突的详细信息，请参阅 update_deleted。
`confl_update_missing` `bigint` 在应用更改期间，待更新的元组未找到的次数。有关该冲突的详细信息，请参阅 update_missing。
`confl_delete_origin_differs` `bigint` 在应用更改期间，删除操作被应用到先前已被另一个源修改过的行上的次数。有关该冲突的详细信息，请参阅 delete_origin_differs。
`confl_delete_missing` `bigint` 在应用更改期间，待删除的元组未找到的次数。有关该冲突的详细信息，请参阅 delete_missing。
`confl_multiple_unique_conflicts` `bigint` 在应用更改期间，行插入或更新后的行值违反多个 `NOT DEFERRABLE` 唯一约束的次数。有关该冲突的详细信息，请参阅 multiple_unique_conflicts。
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

subid oid

订阅的 OID

subname name

订阅的名称

apply_error_count bigint

应用更改时发生错误的次数。请注意，导致应用错误的任何冲突都会同时计入 apply_error_count 和对应的冲突计数（例如 confl_*）。

sync_seq_error_count bigint

序列同步工作进程发生错误的次数。一个工作进程会同步所有序列，因此一次错误计数增加可能代表多个序列的失败。

sync_table_error_count bigint

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

confl_insert_exists bigint

在应用更改期间，行插入违反 NOT DEFERRABLE 唯一约束的次数。有关该冲突的详细信息，请参阅 insert_exists。

confl_update_origin_differs bigint

在应用更改期间，更新被应用到先前已被另一个源修改过的行上的次数。有关该冲突的详细信息，请参阅 update_origin_differs。

confl_update_exists bigint

在应用更改期间，更新后的行值违反 NOT DEFERRABLE 唯一约束的次数。有关该冲突的详细信息，请参阅 update_exists。

confl_update_deleted bigint

在应用更改期间，待更新的元组被另一个源并发删除的次数。有关该冲突的详细信息，请参阅 update_deleted。

confl_update_missing bigint

在应用更改期间，待更新的元组未找到的次数。有关该冲突的详细信息，请参阅 update_missing。

confl_delete_origin_differs bigint

在应用更改期间，删除操作被应用到先前已被另一个源修改过的行上的次数。有关该冲突的详细信息，请参阅 delete_origin_differs。

confl_delete_missing bigint

在应用更改期间，待删除的元组未找到的次数。有关该冲突的详细信息，请参阅 delete_missing。

confl_multiple_unique_conflicts bigint

在应用更改期间，行插入或更新后的行值违反多个 NOT DEFERRABLE 唯一约束的次数。有关该冲突的详细信息，请参阅 multiple_unique_conflicts。

stats_reset timestamp with time zone

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

27.2.11. `pg_stat_ssl` #

pg_stat_ssl 视图将为每一个后端或者 WAL 发送进程包含一行，用来显示这个连接上的 SSL 使用情况。可以把它与 pg_stat_activity 或者 pg_stat_replication 通过 pid 列连接来得到更多有关该连接的细节。

表 27.21. pg_stat_ssl 视图

列类型描述
`pid` `integer` 后端或 WAL 发送进程的进程 ID
`ssl` `boolean` 如果在此连接上使用 SSL，则为真
`version` `text` 使用 SSL 的版本，如果此连接上没有使用 SSL 则为空值
`cipher` `text` 正在使用的 SSL 密码套件的名称，如果此连接上没有使用 SSL 则为空值
`bits` `integer` 使用的加密算法中的位数，如果此连接上没有使用 SSL 则为空值
`client_dn` `text` 所用客户端证书中的区别名称（DN，Distinguished Name）字段，如果没有提供客户端证书或在此连接上没有使用 SSL，则为空值。如果 DN 字段长于 `NAMEDATALEN`（标准构建中为 64 个字符），则该字段将被截断。
`client_serial` `numeric` 客户端证书的序列号，如果没有提供客户端证书或在此连接上没有使用 SSL，则为空值。证书序列号和证书颁发者的组合唯一标识一个证书（除非颁发者错误地重用序列号）。
`issuer_dn` `text` 客户端证书颁发者的区别名称（DN，Distinguished Name），如果没有提供客户端证书或在此连接上没有使用 SSL，则为空值。该字段像 `client_dn` 一样被截断。

列类型

描述

pid integer

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

ssl boolean

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

version text

使用 SSL 的版本，如果此连接上没有使用 SSL 则为空值

cipher text

正在使用的 SSL 密码套件的名称，如果此连接上没有使用 SSL 则为空值

bits integer

使用的加密算法中的位数，如果此连接上没有使用 SSL 则为空值

client_dn text

所用客户端证书中的区别名称（DN，Distinguished Name）字段，如果没有提供客户端证书或在此连接上没有使用 SSL，则为空值。如果 DN 字段长于 NAMEDATALEN（标准构建中为 64 个字符），则该字段将被截断。

client_serial numeric

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

issuer_dn text

客户端证书颁发者的区别名称（DN，Distinguished Name），如果没有提供客户端证书或在此连接上没有使用 SSL，则为空值。该字段像 client_dn 一样被截断。

27.2.12. `pg_stat_gssapi` #

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

表 27.22. pg_stat_gssapi 视图

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

列类型

描述

pid integer

后端进程 ID

gss_authenticated boolean

如果此连接使用了 GSSAPI 认证，则为真

principal text

用于认证此连接的主体，如果未使用 GSSAPI 对此连接进行认证，则为空值。如果主体长度超过 NAMEDATALEN（标准构建中为 64 个字符），则该字段被截断。

encrypted boolean

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

credentials_delegated boolean

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

27.2.13. `pg_stat_archiver` #

pg_stat_archiver 视图总是有一行，其中包含关于集簇的归档进程的数据。

表 27.23. 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.14. `pg_stat_io` #

pg_stat_io 视图对每种后端类型、目标 I/O 对象和 I/O 上下文的组合各提供一行，显示整个集簇范围内的 I/O 统计信息。没有意义的组合会被省略。

目前会跟踪关系（例如表、索引）的 I/O 以及 WAL 活动。不过，绕过共享缓冲区的关系 I/O（例如将表从一个表空间移动到另一个表空间时）目前不会被跟踪。

表 27.24. pg_stat_io 视图

列类型描述
`backend_type` `text` 后端类型（例如后台工作进程、自动清理工作进程）。有关 `backend_type` 的更多信息，请参阅 `pg_stat_activity`。某些 `backend_type` 不会累积 I/O 操作统计信息，因此不会出现在该视图中。
`object` `text` I/O 操作的目标对象。可能的值有： `relation`：永久关系。 `temp relation`：临时关系。 `wal`：预写式日志。
`context` `text` I/O 操作的上下文。可能的值有： `normal`：某类 I/O 操作的默认或标准 `context`。例如，默认情况下关系数据会读入共享缓冲区并从共享缓冲区写出，因此关系数据与共享缓冲区之间的读写会在 `context` 为 `normal` 时跟踪。 `init`：创建 WAL 段时执行的 I/O 操作会在 `context` 为 `init` 时跟踪。 `vacuum`：对永久关系执行清理和分析时，在共享缓冲区之外执行的 I/O 操作。临时表清理与其他临时表 I/O 操作共用同一本地缓冲池，因此会在 `context` 为 `normal` 时跟踪。 `bulkread`：某些在共享缓冲区之外执行的大型读取 I/O 操作，例如对大表的顺序扫描。 `bulkwrite`：某些在共享缓冲区之外执行的大型写入 I/O 操作，例如 `COPY`。
`reads` `bigint` 读取操作的数量。
`read_bytes` `numeric` 读取操作的总大小（以字节为单位）。
`read_time` `double precision` 等待读取操作所花费的时间，以毫秒计（如果启用了 track_io_timing 且 `object` 不是 `wal`，或者启用了 track_wal_io_timing 且 `object` 是 `wal`；否则为零）。这可能包括等待另一个后端发起的读取所花费的时间。在这种情况下，`reads` 仍可能为零。
`writes` `bigint` 写入操作的数量。
`write_bytes` `numeric` 写入操作的总大小（以字节为单位）。
`write_time` `double precision` 等待写入操作所花费的时间，以毫秒计（如果启用了 track_io_timing 且 `object` 不是 `wal`，或者启用了 track_wal_io_timing 且 `object` 是 `wal`；否则为零）。
`writebacks` `bigint` 进程请求内核写出到永久存储的、大小为 `BLCKSZ`（通常为 8kB）的单位数量。
`writeback_time` `double precision` 等待写回操作所花费的时间，以毫秒计（如果启用了 track_io_timing，否则为零）。这包括排队写出请求所花费的时间，以及可能实际写出脏数据所花费的时间。
`extends` `bigint` 关系扩展操作的数量。
`extend_bytes` `numeric` 关系扩展操作的总大小（以字节为单位）。
`extend_time` `double precision` 等待扩展操作所花费的时间，以毫秒计（如果启用了 track_io_timing 且 `object` 不是 `wal`，或者启用了 track_wal_io_timing 且 `object` 是 `wal`；否则为零）。
`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 且 `object` 不是 `wal`，或者启用了 track_wal_io_timing 且 `object` 是 `wal`；否则为零）。
`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：临时关系。
wal：预写式日志。

context text

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

normal：某类 I/O 操作的默认或标准 context。例如，默认情况下关系数据会读入共享缓冲区并从共享缓冲区写出，因此关系数据与共享缓冲区之间的读写会在 context 为 normal 时跟踪。
init：创建 WAL 段时执行的 I/O 操作会在 context 为 init 时跟踪。
vacuum：对永久关系执行清理和分析时，在共享缓冲区之外执行的 I/O 操作。临时表清理与其他临时表 I/O 操作共用同一本地缓冲池，因此会在 context 为 normal 时跟踪。
bulkread：某些在共享缓冲区之外执行的大型读取 I/O 操作，例如对大表的顺序扫描。
bulkwrite：某些在共享缓冲区之外执行的大型写入 I/O 操作，例如 COPY。

reads bigint

读取操作的数量。

read_bytes numeric

读取操作的总大小（以字节为单位）。

read_time double precision

等待读取操作所花费的时间，以毫秒计（如果启用了 track_io_timing 且 object 不是 wal，或者启用了 track_wal_io_timing 且 object 是 wal；否则为零）。这可能包括等待另一个后端发起的读取所花费的时间。在这种情况下，reads 仍可能为零。

writes bigint

写入操作的数量。

write_bytes numeric

写入操作的总大小（以字节为单位）。

write_time double precision

等待写入操作所花费的时间，以毫秒计（如果启用了 track_io_timing 且 object 不是 wal，或者启用了 track_wal_io_timing 且 object 是 wal；否则为零）。

writebacks bigint

进程请求内核写出到永久存储的、大小为 BLCKSZ（通常为 8kB）的单位数量。

writeback_time double precision

等待写回操作所花费的时间，以毫秒计（如果启用了 track_io_timing，否则为零）。这包括排队写出请求所花费的时间，以及可能实际写出脏数据所花费的时间。

extends bigint

关系扩展操作的数量。

extend_bytes numeric

关系扩展操作的总大小（以字节为单位）。

extend_time double precision

等待扩展操作所花费的时间，以毫秒计（如果启用了 track_io_timing 且 object 不是 wal，或者启用了 track_wal_io_timing 且 object 是 wal；否则为零）。

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 且 object 不是 wal，或者启用了 track_wal_io_timing 且 object 是 wal；否则为零）。

stats_reset timestamp with time zone

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

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

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

对于 object 为 wal 的行，fsyncs 和 fsync_time 跟踪在 issue_xlog_fsync 中完成的 WAL 文件 fsync 活动；writes 和 write_time 跟踪在 XLogWrite 中完成的 WAL 文件写入活动。更多信息请参阅第 28.5 节。

pg_stat_io 可用于指导数据库调优。例如：

较高的 evictions 计数可能表明应增大共享缓冲区。
客户端后端依赖检查点进程确保数据持久化到永久存储。client backend 出现大量 fsyncs 可能表明共享缓冲区或检查点进程配置不当。有关配置检查点进程的更多信息，请参阅第 28.5 节。
通常，客户端后端应尽可能依赖检查点进程和后台写入器等辅助进程去写出脏数据。客户端后端出现大量写入可能表明共享缓冲区或检查点进程配置不当。有关配置检查点进程的更多信息，请参阅第 28.5 节。

注意

跟踪 I/O 等待时间的列只有在启用 track_io_timing 时才会非零。若自上次统计信息重置以来的整个时间段内并未始终启用 track_io_timing，则用户在将这些列与对应的 I/O 操作结合引用时应格外小心。

27.2.15. `pg_stat_lock` #

pg_stat_lock 视图将为每种锁类型包含一行，显示集簇范围的锁统计信息。

表 27.25. pg_stat_lock 视图

列类型描述
`locktype` `text` 可加锁对象的类型。有关详细信息，请参阅 `pg_locks`。
`waits` `bigint` 此类型的锁因与其他锁冲突而必须等待的次数。只有在等待超过 deadlock_timeout 后成功获得锁时才会递增。
`wait_time` `double precision` 等待这种锁类型的总时间，以毫秒计。只有在等待超过 deadlock_timeout 后成功获得锁时才会递增。
`fastpath_exceeded` `bigint` 因超出快速路径槽数量上限而无法通过快速路径获取此类型锁的次数。增大 max_locks_per_transaction 可以减少此次数。
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间。

列类型

描述

locktype text

可加锁对象的类型。有关详细信息，请参阅 pg_locks。

waits bigint

此类型的锁因与其他锁冲突而必须等待的次数。只有在等待超过 deadlock_timeout 后成功获得锁时才会递增。

wait_time double precision

等待这种锁类型的总时间，以毫秒计。只有在等待超过 deadlock_timeout 后成功获得锁时才会递增。

fastpath_exceeded bigint

因超出快速路径槽数量上限而无法通过快速路径获取此类型锁的次数。增大 max_locks_per_transaction 可以减少此次数。

stats_reset timestamp with time zone

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

27.2.16. `pg_stat_bgwriter` #

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

表 27.26. 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.17. `pg_stat_checkpointer` #

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

表 27.27. pg_stat_checkpointer 视图

列类型描述
`num_timed` `bigint` 因超时而安排的检查点数量
`num_requested` `bigint` 被请求执行的检查点数量
`num_done` `bigint` 已执行的检查点数量
`restartpoints_timed` `bigint` 因超时或在上次尝试执行失败后安排的重启点数量
`restartpoints_req` `bigint` 被请求执行的重启点数量
`restartpoints_done` `bigint` 已执行的重启点数量
`write_time` `double precision` 处理检查点和重启点时，将文件写入磁盘阶段所花费的总时间，以毫秒计
`sync_time` `double precision` 处理检查点和重启点时，将文件同步到磁盘阶段所花费的总时间，以毫秒计
`buffers_written` `bigint` 在检查点和重启点期间写入的共享缓冲区数量
`slru_written` `bigint` 在检查点和重启点期间写入的 SLRU 缓冲区数量
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

num_timed bigint

因超时而安排的检查点数量

num_requested bigint

被请求执行的检查点数量

num_done bigint

已执行的检查点数量

restartpoints_timed bigint

因超时或在上次尝试执行失败后安排的重启点数量

restartpoints_req bigint

被请求执行的重启点数量

restartpoints_done bigint

已执行的重启点数量

write_time double precision

处理检查点和重启点时，将文件写入磁盘阶段所花费的总时间，以毫秒计

sync_time double precision

处理检查点和重启点时，将文件同步到磁盘阶段所花费的总时间，以毫秒计

buffers_written bigint

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

slru_written bigint

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

stats_reset timestamp with time zone

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

如果服务器自上次检查点以来一直处于空闲状态，则检查点可能会被跳过。num_timed 和 num_requested 统计的是已完成和已跳过的检查点，而 num_done 只跟踪实际完成的检查点。类似地，如果最后一个重放的检查点记录已经是最后一个重启点，则重启点也可能被跳过。restartpoints_timed 和 restartpoints_req 统计的是已完成和已跳过的重启点，而 restartpoints_done 只跟踪实际完成的重启点。

27.2.18. `pg_stat_wal` #

pg_stat_wal 视图一直有一行，包含关于集簇的 WAL 活动的数据。

表 27.28. pg_stat_wal 视图

列类型描述
`wal_records` `bigint` 生成的 WAL 记录的总数
`wal_fpi` `bigint` 生成的 WAL 整页镜像的总数
`wal_bytes` `numeric` 生成的 WAL 总量，以字节计
`wal_fpi_bytes` `numeric` WAL 整页镜像的总字节数
`wal_buffers_full` `bigint` 因为 WAL 缓冲区已满，WAL 数据被写入磁盘的次数
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

wal_records bigint

生成的 WAL 记录的总数

wal_fpi bigint

生成的 WAL 整页镜像的总数

wal_bytes numeric

生成的 WAL 总量，以字节计

wal_fpi_bytes numeric

WAL 整页镜像的总字节数

wal_buffers_full bigint

因为 WAL 缓冲区已满，WAL 数据被写入磁盘的次数

stats_reset timestamp with time zone

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

27.2.19. `pg_stat_database` #

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

表 27.29. 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` 这个数据库中查询创建的临时文件的数量。所有临时文件都将被计数，而不顾及临时文件为什么被创建（例如，排序或 hash 运算），也不考虑 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` 此数据库因为操作者介入而被终止的数据库会话数
`parallel_workers_to_launch` `bigint` 计划由该数据库上的查询启动的并行工作进程数
`parallel_workers_launched` `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

这个数据库中查询创建的临时文件的数量。所有临时文件都将被计数，而不顾及临时文件为什么被创建（例如，排序或 hash 运算），也不考虑 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

此数据库因为操作者介入而被终止的数据库会话数

parallel_workers_to_launch bigint

计划由该数据库上的查询启动的并行工作进程数

parallel_workers_launched bigint

由该数据库上的查询启动的并行工作进程数

stats_reset timestamp with time zone

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

27.2.20. `pg_stat_database_conflicts` #

pg_stat_database_conflicts 视图为每个数据库包含一行，用来显示数据库范围内因与备库上的恢复过程冲突而被取消的查询统计信息。该视图只包含备库上的信息，因为这类冲突不会发生在主库上。

表 27.30. 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 太低而被取消的逻辑槽使用次数
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

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 太低而被取消的逻辑槽使用次数

stats_reset timestamp with time zone

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

27.2.21. `pg_stat_all_tables` #

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

表 27.31. 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` 字段指向不同的堆页。这些始终是非 HOT 更新。
`n_live_tup` `bigint` 活的行的估计数量
`n_dead_tup` `bigint` 死行的估计数量
`n_mod_since_analyze` `bigint` 自上次分析此表以来修改的行的估计数量
`n_ins_since_vacuum` `bigint` 自上次清理此表以来插入的行的估计数量（不计 `VACUUM FULL`）
`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` 这个表被自动清理守护进程分析的次数
`total_vacuum_time` `double precision` 手动清理此表所花费的总时间，以毫秒计（不包括 `VACUUM FULL`）。（这包括由于基于代价的延迟而睡眠的时间。）
`total_autovacuum_time` `double precision` 自动清理守护进程清理该表所花费的总时间，以毫秒计。（这包括由于基于代价的延迟而睡眠的时间。）
`total_analyze_time` `double precision` 手动分析该表所花费的总时间，以毫秒计。（这包括由于基于代价的延迟而睡眠的时间。）
`total_autoanalyze_time` `double precision` 自动清理守护进程分析该表所花费的总时间，以毫秒计。（这包括由于基于代价的延迟而睡眠的时间。）
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

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 字段指向不同的堆页。这些始终是非 HOT 更新。

n_live_tup bigint

活的行的估计数量

n_dead_tup bigint

死行的估计数量

n_mod_since_analyze bigint

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

n_ins_since_vacuum bigint

自上次清理此表以来插入的行的估计数量（不计 VACUUM FULL）

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

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

total_vacuum_time double precision

手动清理此表所花费的总时间，以毫秒计（不包括 VACUUM FULL）。（这包括由于基于代价的延迟而睡眠的时间。）

total_autovacuum_time double precision

自动清理守护进程清理该表所花费的总时间，以毫秒计。（这包括由于基于代价的延迟而睡眠的时间。）

total_analyze_time double precision

手动分析该表所花费的总时间，以毫秒计。（这包括由于基于代价的延迟而睡眠的时间。）

total_autoanalyze_time double precision

自动清理守护进程分析该表所花费的总时间，以毫秒计。（这包括由于基于代价的延迟而睡眠的时间。）

stats_reset timestamp with time zone

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

27.2.22. `pg_stat_autovacuum_scores` #

pg_stat_autovacuum_scores 视图将为当前数据库中的每个表（包括 TOAST 表）包含一行，显示该表当前的自动清理评分。对符合处理条件的表，自动清理会根据 score 确定优先级，分数越高优先级越高。更多信息请参阅第 24.1.6.1 节。

该视图的结果生成方式与自动清理工作进程相同，但它使用的是当前源信息，而这可能与自动清理工作进程收集待处理表列表时看到的源信息不同。因此，这个视图并不能完全可靠地指示自动清理会处理哪些表以及处理顺序。

表 27.32. pg_stat_autovacuum_scores 视图

列类型描述
`relid` `oid` 表的 OID。
`schemaname` `name` 表所在模式的名称。
`relname` `name` 表名。
`score` `double precision` 所有分量评分中的最大值。这也是自动清理用来排序待处理表列表的值。
`xid_score` `double precision` 事务 ID 年龄分量评分。大于 autovacuum_freeze_score_weight 的分数表示自动清理会为防止事务 ID 回卷而清理该表。
`mxid_score` `double precision` 多事务 ID 年龄分量评分。大于 autovacuum_multixact_freeze_score_weight 的分数表示自动清理会为防止多事务 ID 回卷而清理该表。
`vacuum_score` `double precision` 清理分量评分。大于 autovacuum_vacuum_score_weight 的分数表示自动清理会清理该表（除非自动清理被禁用）。
`vacuum_insert_score` `double precision` 由插入触发的清理分量评分。大于 autovacuum_vacuum_insert_score_weight 的分数表示自动清理会清理该表（除非自动清理被禁用）。
`analyze_score` `double precision` 分析分量评分。大于 autovacuum_analyze_score_weight 的分数表示自动清理会分析该表（除非自动清理被禁用）。
`do_vacuum` `bool` 自动清理是否会清理该表。请注意，即使分量评分表明自动清理会清理该表，如果自动清理被禁用，这里也可能是 `false`。
`do_analyze` `bool` 自动清理是否会分析该表。请注意，即使分量评分表明自动清理会分析该表，如果自动清理被禁用，这里也可能是 `false`。
`for_wraparound` `bool` 自动清理是否会为了防止回卷而清理该表。

列类型

描述

relid oid

表的 OID。

schemaname name

表所在模式的名称。

relname name

表名。

score double precision

所有分量评分中的最大值。这也是自动清理用来排序待处理表列表的值。

xid_score double precision

事务 ID 年龄分量评分。大于 autovacuum_freeze_score_weight 的分数表示自动清理会为防止事务 ID 回卷而清理该表。

mxid_score double precision

多事务 ID 年龄分量评分。大于 autovacuum_multixact_freeze_score_weight 的分数表示自动清理会为防止多事务 ID 回卷而清理该表。

vacuum_score double precision

清理分量评分。大于 autovacuum_vacuum_score_weight 的分数表示自动清理会清理该表（除非自动清理被禁用）。

vacuum_insert_score double precision

由插入触发的清理分量评分。大于 autovacuum_vacuum_insert_score_weight 的分数表示自动清理会清理该表（除非自动清理被禁用）。

analyze_score double precision

分析分量评分。大于 autovacuum_analyze_score_weight 的分数表示自动清理会分析该表（除非自动清理被禁用）。

do_vacuum bool

自动清理是否会清理该表。请注意，即使分量评分表明自动清理会清理该表，如果自动清理被禁用，这里也可能是 false。

do_analyze bool

自动清理是否会分析该表。请注意，即使分量评分表明自动清理会分析该表，如果自动清理被禁用，这里也可能是 false。

for_wraparound bool

自动清理是否会为了防止回卷而清理该表。

27.2.23. `pg_stat_all_indexes` #

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

表 27.33. 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` 使用此索引进行简单索引扫描获取的存活表行数
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

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

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

stats_reset timestamp with time zone

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

索引可以被简单索引扫描、“位图”索引扫描以及优化器使用。在一次位图扫描中，多个索引的输出可以通过 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 统计从表取得的存活行。如果使用该索引取得了任何死亡行或还未提交的行，或者如果通过一次仅索引扫描的方式避免了任何堆获取，后者将较小。

注意

索引扫描在一次执行中有时会进行多次索引搜索。每次索引搜索都会递增 pg_stat_all_indexes.idx_scan，因此索引扫描计数可能显著超过索引扫描执行器节点的总执行次数。

使用某些 SQL 构造来搜索与列表或数组中的多个标量值之一匹配的行时，可能出现这种情况（参见第 9.26 节）。使用 column_name = value1 OR column_name = value2 ...构造的查询也可能如此，但前提是优化器将该构造转换为等价的多值数组表示。同样，当 B-树索引扫描使用跳过扫描优化时，每次将扫描位置移至下一个可能包含匹配元组的索引叶子页，都会进行一次索引搜索（参见第 11.3 节）。

提示

EXPLAIN ANALYZE 会输出每个索引扫描节点执行的索引搜索总次数。有关展示其工作方式的示例，请参见第 14.1.2 节。

27.2.24. `pg_statio_all_tables` #

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

表 27.34. 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 表索引中的缓冲区命中数（如果有的话）
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

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 表索引中的缓冲区命中数（如果有的话）

stats_reset timestamp with time zone

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

27.2.25. `pg_statio_all_indexes` #

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

表 27.35. pg_statio_all_indexes 视图

列类型描述
`relid` `oid` 此索引所在表的 OID
`indexrelid` `oid` 这个索引的 OID
`schemaname` `name` 这个索引所在的模式名称
`relname` `name` 这个索引的表的名称
`indexrelname` `name` 这个索引的名称
`idx_blks_read` `bigint` 从此索引中读取的磁盘块的数量
`idx_blks_hit` `bigint` 此索引中的缓冲区命中数
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

relid oid

此索引所在表的 OID

indexrelid oid

这个索引的 OID

schemaname name

这个索引所在的模式名称

relname name

这个索引的表的名称

indexrelname name

这个索引的名称

idx_blks_read bigint

从此索引中读取的磁盘块的数量

idx_blks_hit bigint

此索引中的缓冲区命中数

stats_reset timestamp with time zone

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

27.2.26. `pg_statio_all_sequences` #

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

表 27.36. pg_statio_all_sequences 视图

列类型描述
`relid` `oid` 序列的 OID
`schemaname` `name` 此序列所在的模式的名称
`relname` `name` 此序列的名称
`blks_read` `bigint` 从这个序列中读取的磁盘块的数量
`blks_hit` `bigint` 在此序列中的缓冲区命中数
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

relid oid

序列的 OID

schemaname name

此序列所在的模式的名称

relname name

此序列的名称

blks_read bigint

从这个序列中读取的磁盘块的数量

blks_hit bigint

在此序列中的缓冲区命中数

stats_reset timestamp with time zone

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

27.2.27. `pg_stat_user_functions` #

pg_stat_user_functions 视图将为每一个被追踪的函数包含一行，该行显示有关该函数执行的统计信息。track_functions 参数控制到底哪些函数被跟踪。

表 27.37. pg_stat_user_functions 视图

列类型描述
`funcid` `oid` 函数的 OID
`schemaname` `name` 这个函数所在的模式的名称
`funcname` `name` 这个函数的名称
`calls` `bigint` 这个函数已经被调用的次数
`total_time` `double precision` 在这个函数以及它所调用的其他函数中花费的总时间，以毫秒计
`self_time` `double precision` 在这个函数本身花费的总时间，不包括被它调用的其他函数，以毫秒计
`stats_reset` `timestamp with time zone` 这些统计信息上次被重置的时间

列类型

描述

funcid oid

函数的 OID

schemaname name

这个函数所在的模式的名称

funcname name

这个函数的名称

calls bigint

这个函数已经被调用的次数

total_time double precision

在这个函数以及它所调用的其他函数中花费的总时间，以毫秒计

self_time double precision

在这个函数本身花费的总时间，不包括被它调用的其他函数，以毫秒计

stats_reset timestamp with time zone

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

27.2.28. `pg_stat_slru` #

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

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

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

其他查看统计信息的方法是直接使用查询，这些查询使用上述标准视图用到的底层统计信息访问函数。如要了解如函数名等细节，可参考标准视图的定义（例如，在 psql 中你可以发出\d+ pg_stat_activity）。针对每一个数据库统计信息的访问函数把一个数据库 OID 作为参数来标识要报告哪个数据库。而针对每个表和每个索引的函数要求表或索引 OID。针对每个函数统计信息的函数用一个函数 OID。注意只有在当前数据库中的表、索引和函数才能被这些函数看到。

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

表 27.39. 附加统计函数

函数描述
`pg_backend_pid` () → `integer` 返回附加到当前会话的服务器进程的进程 ID。
`pg_stat_get_backend_io` ( `integer` ) → `setof record` 返回指定进程 ID 的后端的 I/O 统计信息。输出字段与 `pg_stat_io` 视图中的字段完全相同。该函数不返回检查点进程、后台写入器、启动进程和自动清理启动器的 I/O 统计信息，因为这些统计信息已显示在 `pg_stat_io` 视图中，而且每种进程都只有一个。
`pg_stat_get_activity` ( `integer` ) → `setof record` 使用指定的进程 ID 返回有关后端信息的记录，如果指定了 `NULL`，则返回系统中每个活动后端的一条记录。返回的字段是 `pg_stat_activity` 视图中字段的子集。
`pg_stat_get_backend_wal` ( `integer` ) → `record` 返回指定进程 ID 的后端的 WAL 统计信息。输出字段与 `pg_stat_wal` 视图中的字段完全相同。该函数不会返回检查点进程、后台写入器、启动进程和自动清理启动器的 WAL 统计信息。
`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` 视图中显示的所有计数器。 `lock`：重置 `pg_stat_lock` 视图中显示的所有计数器。 `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_backend_stats` ( `integer` ) → `void` 将指定进程 ID 的单个后端进程的统计信息重置为零。默认情况下，此函数仅限超级用户使用，但可以授予其他用户 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_backend_io ( integer ) → setof record

返回指定进程 ID 的后端的 I/O 统计信息。输出字段与 pg_stat_io 视图中的字段完全相同。

该函数不返回检查点进程、后台写入器、启动进程和自动清理启动器的 I/O 统计信息，因为这些统计信息已显示在 pg_stat_io 视图中，而且每种进程都只有一个。

pg_stat_get_activity ( integer ) → setof record

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

pg_stat_get_backend_wal ( integer ) → record

返回指定进程 ID 的后端的 WAL 统计信息。输出字段与 pg_stat_wal 视图中的字段完全相同。

该函数不会返回检查点进程、后台写入器、启动进程和自动清理启动器的 WAL 统计信息。

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 视图中显示的所有计数器。
lock：重置 pg_stat_lock 视图中显示的所有计数器。
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_backend_stats ( integer ) → void

将指定进程 ID 的单个后端进程的统计信息重置为零。

默认情况下，此函数仅限超级用户使用，但可以授予其他用户 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() 还会重置自动清理使用的计数器，以确定何时触发清理或分析。重置这些计数器可能导致自动清理不执行必要的工作，这可能会导致问题，如表膨胀或过时的表统计信息。建议在统计信息重置后进行全库 ANALYZE。

pg_stat_get_activity 是 pg_stat_activity 视图的底层函数，返回一组记录，其中包含有关每个后端进程的全部可用信息。有时只获取其中一部分信息会更方便。在这种情况下，可以使用另一组针对每个后端的统计信息访问函数，见表 27.40。这些访问函数使用会话的后端 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.40. 按后端统计函数

函数描述
`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_overflowed`（指示该后端进程的子事务缓存是否已溢出）。
`pg_stat_get_backend_userid` ( `integer` ) → `oid` 返回登录到此后端的用户的 OID。
`pg_stat_get_backend_wait_event` ( `integer` ) → `text` 如果后端当前正在等待，则返回等待事件名称，否则为空值。请参阅表 27.5 到表 27.13。
`pg_stat_get_backend_wait_event_type` ( `integer` ) → `text` 如果后端当前正在等待，则返回等待事件类型名称，否则返回空值。请参阅表 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_overflowed（指示该后端进程的子事务缓存是否已溢出）。

pg_stat_get_backend_userid ( integer ) → oid

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

pg_stat_get_backend_wait_event ( integer ) → text

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

pg_stat_get_backend_wait_event_type ( integer ) → text

如果后端当前正在等待，则返回等待事件类型名称，否则返回空值。请参阅表 27.4。

pg_stat_get_backend_xact_start ( integer ) → timestamp with time zone

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