PostgreSQL底层分析工具：类似Oracle BBED的工具探索
概述
Oracle BBED（Block Browser and EDitor）是Oracle数据库强大的底层数据块分析工具。PostgreSQL虽然没有完全等价的工具，但提供了丰富的扩展和命令行工具来实现类似功能。本文详细介绍PostgreSQL的底层分析工具及其使用方法。
一、PostgreSQL数据文件概述
1.1 数据目录结构
/var/lib/postgresql/16/main/
├── base/ # 数据库文件
│ ├── 1/ # template1
│ ├── 4/ # template0
│ ├── 5/ # postgres
│ └── 16448/ # 用户数据库
├── global/ # 共享系统表
├── pg_wal/ # WAL日志
├── pg_tblspc/ # 表空间链接
└── pg_xact/ # 事务提交状态
1.2 关键参数
data_directory = /var/lib/postgresql/16/main
block_size = 8192 (8KB)
segment_size = 1GB
wal_block_size = 8192
wal_segment_size = 16MB
二、PostgreSQL页面结构
2.1 页面结构总览
┌─────────────────────────────────────────────────────────────────────────────┐
│ PostgreSQL 页面结构 (8KB) │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Page Header (24字节) │ │
│ │ - pd_lsn: 最后修改的WAL位置 │ │
│ │ - pd_checksum: 页面校验和 │ │
│ │ - pd_lower/pd_upper: 空闲空间边界 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Item Pointers (变长) │ │
│ │ - 指向元组的指针数组 │ │
│ │ - 从页头向下增长 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Free Space (变长) │ │
│ │ - 空闲空间 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Items/Tuples (变长) │ │
│ │ - 实际数据元组 │ │
│ │ - 从页尾向上增长 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ Special Space (变长) │ │
│ │ - 索引页特有数据 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
| 偏移 |
字段名 |
大小 |
说明 |
| 0-7 |
pd_lsn |
8字节 |
最后修改的WAL位置 |
| 8-9 |
pd_checksum |
2字节 |
页面校验和 |
| 10-11 |
pd_flags |
2字节 |
标志位 |
| 12-13 |
pd_lower |
2字节 |
空闲空间起始位置 |
| 14-15 |
pd_upper |
2字节 |
空闲空间结束位置 |
| 16-17 |
pd_special |
2字节 |
特殊空间起始位置 |
| 18-19 |
pd_pagesize_version |
2字节 |
页面大小和版本 |
| 20-23 |
pd_prune_xid |
4字节 |
最老的可能需要剪枝的XID |
三、pageinspect扩展：核心分析工具
3.1 安装扩展
CREATE EXTENSION IF NOT EXISTS pageinspect;
3.2 主要函数
| 函数 |
说明 |
get_raw_page(relname, blkno) |
获取原始页面内容 |
page_header(page) |
解析页面头 |
heap_page_items(page) |
查看堆页元组 |
bt_page_stats(relname, blkno) |
B-tree索引页统计 |
bt_page_items(relname, blkno) |
B-tree索引页项 |
fsm_page_contents(page) |
FSM页内容 |
page_checksum(page, blkno) |
计算页面校验和 |
3.3 使用示例
-- 获取表的文件路径
SELECT pg_relation_filepath('test_table'::regclass);
-- 结果: base/16448/16450
-- 分析页面头
SELECT * FROM page_header(get_raw_page('test_table', 0));
输出示例：
lsn | checksum | flags | lower | upper | special | pagesize | version | prune_xid
-----------+----------+-------+-------+-------+---------+----------+---------+-----------
0/6BE4758 | 0 | 0 | 44 | 7952 | 8192 | 8192 | 4 | 0
-- 查看页面中的元组
SELECT
lp as line_pointer,
lp_off as offset,
lp_len as length,
t_xmin as xmin,
t_xmax as xmax,
t_ctid as ctid
FROM heap_page_items(get_raw_page('test_table', 0));
输出示例：
line_pointer | offset | length | xmin | xmax | ctid
--------------+--------+--------+------+------+-------
1 | 8144 | 48 | 791 | 0 | (0,1)
2 | 8096 | 48 | 791 | 0 | (0,2)
3 | 8048 | 48 | 791 | 0 | (0,3)
4 | 8000 | 48 | 791 | 0 | (0,4)
5 | 7952 | 48 | 791 | 0 | (0,5)
3.4 分析B-tree索引
-- 创建索引
CREATE INDEX idx_test_name ON test_table(name);
-- 查看索引页统计
SELECT * FROM bt_page_stats('idx_test_name', 1);
输出示例：
blkno | type | live_items | dead_items | avg_item_size | page_size | free_size | btpo_prev | btpo_next | btpo_level | btpo_flags
-------+------+------------+------------+---------------+-----------+-----------+-----------+-----------+------------+------------
1 | l | 5 | 0 | 16 | 8192 | 8048 | 0 | 0 | 0 | 3
-- 查看索引页项
SELECT * FROM bt_page_items('idx_test_name', 1);
输出示例：
itemoffset | ctid | itemlen | nulls | vars | data
------------+-------+---------+-------+------+-------------------------
1 | (0,1) | 16 | f | t | 11 52 65 63 6f 72 64 31
2 | (0,2) | 16 | f | t | 11 52 65 63 6f 72 64 32
3 | (0,3) | 16 | f | t | 11 52 65 63 6f 72 64 33
四、pg_waldump：WAL日志分析
4.1 工具位置
/usr/lib/postgresql/16/bin/pg_waldump
4.2 使用方法
# 查看WAL文件内容
pg_waldump /var/lib/postgresql/16/main/pg_wal/000000010000000000000006
# 指定时间范围
pg_waldump -s 0/6BE4758 -e 0/6BE4800 /path/to/wal
# 指定关系文件
pg_waldump -r 1663/16448/16450 /path/to/wal
4.3 输出示例
rmgr: XLOG len (rec/tot): 49/ 7441, tx: 783, lsn: 0/060001E0, prev 0/05FFE4A0, desc: FPI , blkref #0: rel 1663/16431/16443 blk 257 FPW
rmgr: Heap len (rec/tot): 54/ 54, tx: 791, lsn: 0/06BE4758, prev 0/06BE4720, desc: INSERT off 1 flags 0x00, blkref #0: rel 1663/16448/16450 blk 0
4.4 关键字段说明
| 字段 |
说明 |
| rmgr |
资源管理器（Heap, Btree, XLOG等） |
| len |
记录长度 |
| tx |
事务ID |
| lsn |
日志序列号 |
| desc |
操作描述 |
| blkref |
块引用 |
五、pgstattuple扩展：表统计信息
5.1 安装扩展
CREATE EXTENSION IF NOT EXISTS pgstattuple;
5.2 主要函数
| 函数 |
说明 |
pgstattuple(relname) |
表的物理统计 |
pgstatindex(relname) |
索引统计 |
pgstatginindex(relname) |
GIN索引统计 |
pg_relpages(relname) |
表的页面数 |
5.3 使用示例
-- 查看表统计
SELECT * FROM pgstattuple('test_table');
输出示例：
table_len | tuple_count | tuple_len | tuple_percent | dead_tuple_count | dead_tuple_len | dead_tuple_percent | free_space | free_percent
-----------+-------------+-----------+---------------+------------------+----------------+--------------------+------------+-------------
8192 | 5 | 240 | 2.93 | 0 | 0 | 0 | 7904 | 96.48
六、hexdump：原始数据查看
6.1 查看数据文件
# 查看文件头
sudo hexdump -C /var/lib/postgresql/16/main/base/16448/16450 | head -40
输出示例：
00000000 00 00 00 00 58 47 be 06 00 00 00 00 2c 00 10 1f |....XG......,...|
│─────────│ │─────────│ │─────────│ │─────────│
pd_lsn checksum pd_flags pd_lower/pd_upper
00001f20 05 00 04 00 02 09 18 00 05 00 00 00 11 52 65 63 |.............Rec|
│─ Record ─│
6.2 解析页面头
# 提取pd_lsn（前8字节）
sudo od -A x -t x1 -N 8 /var/lib/postgresql/16/main/base/16448/16450
# 输出: 00 00 00 00 58 47 be 06
# 提取pd_lower和pd_upper（偏移12-15）
sudo od -A x -j 12 -t x1 -N 4 /var/lib/postgresql/16/main/base/16448/16450
# 输出: 2c 00 10 1f (pd_lower=0x002c=44, pd_upper=0x1f10=7952)
七、与Oracle BBED对比
7.1 功能对比
| 功能 |
Oracle BBED |
PostgreSQL工具 |
| 查看数据块 |
SET BLOCK |
page_header(get_raw_page()) |
| 查看块头 |
MAP |
page_header() |
| 查看元组 |
DUMP |
heap_page_items() |
| 查看索引 |
有限支持 |
bt_page_items() |
| 分析WAL |
LogMiner |
pg_waldump |
| 修改数据 |
MODIFY |
⚠️ 不推荐 |
| 校验和验证 |
SUM APPLY |
page_checksum() |
| 交互模式 |
✅ 支持 |
❌ SQL/命令行 |
| 安全模式 |
✅ 只读模式 |
⚠️ 无保护 |
7.2 工具对比
| Oracle工具 |
PostgreSQL等价工具 |
说明 |
| BBED |
pageinspect扩展 |
页面分析 |
| LogMiner |
pg_waldump |
WAL分析 |
| DBMS_ROWID |
pg_relation_filepath() |
定位数据 |
| DBMS_SPACE |
pgstattuple扩展 |
空间统计 |
| DUMP |
hexdump/od |
原始数据查看 |
| ALTER SYSTEM |
pg_resetwal |
重置WAL |
7.3 命令对比
| 操作 |
Oracle BBED |
PostgreSQL |
| 查看块 |
SET BLOCK 10 |
SELECT * FROM page_header(get_raw_page('t', 10)); |
| 查看偏移 |
SET OFFSET 100 |
SELECT substring(get_raw_page('t', 0) from 101 for 16); |
| 转储块 |
DUMP |
SELECT encode(get_raw_page('t', 0), 'hex'); |
| 查找值 |
FIND /x 1234 |
grep -boa |
| 修改值 |
MODIFY /x 5678 |
⚠️ 不推荐 |
| 计算校验 |
SUM APPLY |
SELECT page_checksum(get_raw_page('t', 0), 0); |
八、PostgreSQL工具汇总
8.1 内置命令行工具
| 工具 |
说明 |
| pg_waldump |
WAL日志分析 |
| pg_controldata |
控制文件信息 |
| pg_checksums |
数据校验和 |
| pg_resetwal |
重置WAL |
| pg_verifybackup |
备份验证 |
| pg_basebackup |
基础备份 |
| pg_rewind |
时间线重置 |
8.2 内置扩展
| 扩展 |
说明 |
| pageinspect |
页面内容分析 |
| pgstattuple |
表统计信息 |
| pg_walinspect |
WAL内容分析(PG15+) |
| pg_filedump |
文件转储(需单独安装) |
8.3 第三方工具
| 工具 |
说明 |
| pg_filedump |
独立的文件转储工具 |
| pg_rman |
备份恢复管理 |
| wal-g |
WAL归档管理 |
九、安全警告
9.1 直接修改数据文件风险
| 风险 |
说明 |
| 数据损坏 |
直接修改可能导致数据不一致 |
| 校验失败 |
PostgreSQL有严格的校验机制 |
| WAL不一致 |
修改不会记录到WAL |
| 无法恢复 |
没有回滚机制 |
9.2 推荐做法
1. 只读分析：使用pageinspect、pg_waldump等只读工具
2. 官方扩展：使用PostgreSQL提供的扩展
3. 备份优先：任何操作前先备份
4. 测试环境：在测试环境验证后再操作生产
十、总结
10.1 PostgreSQL vs Oracle BBED
| 方面 |
Oracle BBED |
PostgreSQL工具集 |
| 功能完整性 |
⭐⭐⭐⭐⭐ |
⭐⭐⭐⭐ |
| 安全性 |
⭐⭐⭐⭐ |
⭐⭐⭐ |
| 易用性 |
⭐⭐⭐ |
⭐⭐⭐⭐ |
| 文档支持 |
⭐⭐⭐⭐ |
⭐⭐⭐⭐ |
| 扩展性 |
⭐⭐ |
⭐⭐⭐⭐⭐ |
10.2 工具选择建议
| 场景 |
推荐工具 |
| 页面分析 |
pageinspect扩展 |
| WAL分析 |
pg_waldump |
| 空间统计 |
pgstattuple扩展 |
| 原始数据查看 |
hexdump + pageinspect |
| 数据恢复 |
专业恢复工具/服务 |
10.3 核心结论
PostgreSQL没有完全等价于Oracle BBED的单一工具，但通过以下组合可以实现类似功能：
pageinspect扩展 → 页面内容分析（类似BBED的DUMP）
pg_waldump → WAL日志分析（类似LogMiner）
pgstattuple扩展 → 表统计信息（类似DBMS_SPACE）
hexdump/od → 原始数据查看（类似BBED的原始转储）
优势：
- PostgreSQL的工具更安全（只读分析）
- 通过SQL接口使用更方便
- 扩展性强，可自定义函数
劣势：
- 没有交互式界面
- 不支持直接修改数据
- 需要多个工具组合使用
浙公网安备 33010602011771号