如何查看PostgreSQL堆文件？教育用途下解析数据存储结构

为什么记事本打开会乱码？ #

PostgreSQL的堆文件是二进制格式，并非纯文本文件，记事本这类文本编辑器会把二进制字节强行解析为字符，自然会显示乱码或“结构损坏”，这是正常现象。

正确查看方式 #

要得到你展示的标准页面结构，优先使用PostgreSQL官方配套工具或内置函数：

方法1：用pg_filedump工具（推荐）

这是专门用于解析PostgreSQL数据文件（堆、索引、WAL等）的工具，能直接输出页面的结构化信息。

• 安装方式：
  • Debian/Ubuntu：sudo apt install pg-filedump
  • RHEL/CentOS：sudo yum install pg_filedump
  • 源码编译：从PostgreSQL社区仓库下载源码后编译安装
• 找到目标表的堆文件：
  1. 查询数据库OID：SELECT oid FROM pg_database WHERE datname='你的数据库名';
  2. 查询表OID：SELECT oid FROM pg_class WHERE relname='你的表名';
  3. 堆文件路径：PostgreSQL数据目录下的base/数据库OID/表OID（例如/var/lib/postgresql/14/main/base/1234/5678）
• 解析文件：
  执行命令 pg_filedump -d 你的堆文件路径，就能看到包含页面头部、行指针、元组的完整结构，和你想要的格式一致。

方法2：用PostgreSQL内置函数（无需额外工具）

如果不想安装外部工具，可以用内置函数查看单个页面的头部和内容：

• 查看页面头部：SELECT pg_page_header(get_raw_page('你的表名', 0));（0是要查看的页面编号，可按需替换）
• 查看页面原始二进制：SELECT get_raw_page('你的表名', 0);（结合其他二进制解析工具查看更直观）

你展示的页面结构翻译如下： #

• +----------------+---------------------------------+
• | 页面头部数据(PageHeaderData) | 行指针1 行指针2 行指针3 ... |
• +-----------+----+---------------------------------+
• | ... 行指针N | |
• +-----------+--------------------------------------+
• | ^ pd_lower（行指针区末尾标记） |
• | |
• | v pd_upper（元组区起始标记） |
• +-------------+------------------------------------+
• | | 元组N ... |
• +-------------+------------------+-----------------+
• | ... 元组3 元组2 元组1 | "特殊空间" |
• +--------------------------------+-----------------+

内容的提问来源于stack exchange，提问作者theUnbrakableDiamond