Bertrand Drouvot：欢迎使用pg_walviz：PostgreSQL WAL段可视化工具
内容提要
pg_walviz是一款用于可视化PostgreSQL WAL段文件的新工具，提供段概览、记录片段列表和记录检查器三种同步视图，展示物理布局和原始字节。用户可通过页面、记录、偏移或LSN导航。该工具为只读，需使用归档段，避免活跃WAL。目前为beta版，支持远程访问，但大输入加载较慢。
延伸解读
工具定位与适用场景
pg_walviz 定位为只读的可视化工具，与 pg_waldump 互补：后者提供人类可读的逻辑记录，而 pg_walviz 侧重物理布局，如 WAL 页面、记录片段、对齐填充和原始字节。它不需要运行中的 PostgreSQL 服务器或数据目录，适合分析归档的 WAL 段，尤其适合需要深入理解 WAL 物理结构的开发者或 DBA。
使用注意事项
工具明确警告不要用于正在写入的 WAL 段或运行中服务器的 pg_wal 目录，因为元数据在启动时解析，而原始字节稍后读取，文件变化会导致不一致。应使用已归档的段或不可变副本。此外，WAL 可能包含敏感数据，建议仅本地暴露，远程访问时使用 SSH 隧道。
当前限制与性能考量
作为 beta 版本，pg_walviz 尚未实现大输入的懒加载，浏览器需一次性接收完整元数据，因此大段或大量小记录可能导致加载缓慢和内存占用高。全页图像仅定位并报告压缩方法和空洞元数据，不进行解压或重建。这些限制提示用户在处理大型 WAL 文件时需谨慎。
Q&A
pg_walviz是什么工具？
pg_walviz是一个用于可视化PostgreSQL WAL段文件的新工具，它提供三种同步视图：段概览、WAL记录片段列表和记录检查器/物理字节面板，帮助用户理解WAL记录的物理存储方式。
pg_walviz与pg_waldump有什么区别？
pg_waldump用于显示WAL的可读文本渲染，而pg_walviz则侧重于展示WAL记录的物理存储，包括WAL页面、记录片段、续记录、对齐填充、块引用、全页镜像和原始字节。
pg_walviz提供哪些视图？它们如何同步？
pg_walviz提供段概览、WAL记录片段列表和记录检查器/物理字节面板三种视图。这些视图是同步的，例如在段概览中选择一个页面会更新记录片段列表和物理字节，选择一条记录也会同步其他视图。
如何使用pg_walviz查看WAL段？
使用命令行工具，指定pg_waldump路径和WAL段文件路径，例如：~/pg_walviz/bin/pg_walviz --pg-waldump /path/to/pg_waldump /archive/000000010000000000000042。工具会启动本地HTTP服务器并打开浏览器。
pg_walviz可以远程使用吗？
可以。在远程或headless服务器上，使用--no-open和--port选项启动工具，然后通过SSH隧道从本地访问，例如：ssh -N -L 8765:127.0.0.1:8765 user@server，然后在本地浏览器打开http://127.0.0.1:8765/。
使用pg_walviz时有哪些注意事项？
不要使用当前正在写入的WAL段或指向运行中服务器的pg_wal目录，应使用已归档的段或不可变副本。WAL可能包含敏感数据，因此查看器应仅本地暴露。大输入加载较慢，因为浏览器一次性接收所有元数据。
pg_walviz如何处理全页镜像？
pg_walviz能够定位全页镜像，并报告其压缩方法和空洞元数据，但不会解压或重建为PostgreSQL数据页。
