PostgreSQL的pageinspect插件B树函数输出结果详细说明文档在哪？

pg官方文档对pageinspect扩展的B树类函数说明偏简略，完整的参数、返回字段定义可参考PostgreSQL官方源码中pageinspect扩展的实现注释，以及B树索引存储结构的内核设计文档。

bt_page_stats函数说明 #

输入参数 #

• 第一个参数：目标B树索引的名称（也可传入索引的OID）
• 第二个参数：要查询的索引页面块号，编号从0开始计数

返回字段含义 #

• blkno：当前查询的索引页面块号，和输入的第二个参数值对应
• type：页面类型，常见取值：l为叶子节点页，i为内部节点页，m为B树元页（存储B树根节点信息的特殊页面）
• live_items：当前页面中存储的有效索引条目数量
• dead_items：当前页面中已经失效、尚未被VACUUM操作清理的索引条目数量
• avg_item_size：页面内所有索引条目的平均大小，单位为字节
• page_size：索引页面的总大小，默认和PostgreSQL实例的块大小一致，通常为8192字节
• free_size：当前页面剩余可用的空闲空间大小，单位为字节
• btpo_prev：同一B树层级下，当前页面的前一个相邻页面块号，取值为0代表无前置页面
• btpo_next：同一B树层级下，当前页面的后一个相邻页面块号，取值为0代表无后置页面
• btpo_level：当前页面在B树中的层级，0代表叶子节点，数值越大越靠近B树的根节点
• btpo_flags：页面标记位的整数编码，取值3代表页面同时具备「已初始化」「叶子节点」两个属性；其他常见取值：1代表页面已初始化，2代表是叶子节点，4代表页面已被标记为删除

其他B树相关函数（如bt_page_items）的参数和返回值说明，也可通过上述源码渠道查询对应的定义注释。

内容的提问来源于stack exchange，提问作者Cat-Lord