pg_walinspect
用于检查 PostgreSQL WAL 日志内容的函数
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_walinspect | 1.1 | STAT | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 6940 | pg_walinspect | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | basic_archive pglogical pg_failover_slots wal2json basebackup_to_shell decoderbufs test_decoding pg_profile |
|---|
版本
| PG18 | PG17 | PG16 | PG15 | PG14 |
|---|---|---|---|---|
| 1.1 | 1.1 | 1.1 | 1.1 | ✗ |
安装
提示：这是 PostgreSQL 内核自带的 contrib 扩展
CREATE EXTENSION pg_walinspect;
用法
pg_walinspect 提供 SQL 函数来检查运行中服务器上的预写日志（WAL）内容。类似于 pg_waldump，但可通过 SQL 访问。
函数
pg_get_wal_record_info(in_lsn pg_lsn) – 单条 WAL 记录详情：
SELECT * FROM pg_get_wal_record_info('0/E419E28');
start_lsn | 0/E419E28
end_lsn | 0/E419E68
prev_lsn | 0/E419D78
xid | 0
resource_manager | Heap2
record_type | VACUUM
record_length | 58
main_data_length | 2
fpi_length | 0
description | nunused: 5, unused: [1, 2, 3, 4, 5]
block_ref | blkref #0: rel 1663/16385/1249 fork main blk 364
pg_get_wal_records_info(start_lsn, end_lsn) – LSN 范围内的所有记录：
SELECT * FROM pg_get_wal_records_info('0/1E913618', '0/1E913740');
pg_get_wal_block_info(start_lsn, end_lsn, show_data) – WAL 记录中的块引用：
SELECT * FROM pg_get_wal_block_info('0/1230278', '0/12302B8');
每个块引用返回：start_lsn、end_lsn、block_id、reltablespace、reldatabase、relfilenode、relforknumber、relblocknumber、xid、fork_flags、block_data、block_fpi_data 等。
pg_get_wal_stats(start_lsn, end_lsn, per_record) – 聚合 WAL 统计：
SELECT * FROM pg_get_wal_stats('0/1E847D00', '0/1E84F500')
WHERE count > 0;
提示
- 使用
FFFFFFFF/FFFFFFFF作为end_lsn可读取到当前服务器 LSN - 如果
in_lsn不在记录边界上，则返回下一条有效记录 - 所有函数使用服务器当前的时间线 ID
访问权限
限制为超级用户和 pg_read_server_files 成员。