F.32. pg_visibility
pg_visibility模块提供了一种方式来检查可见性映射（VM）以及页级别的可见性信息。它还提供了函数来检查可见性映射的完整性以及强制重建可见性映射。
有三个不同的位被用来存储有关页级别可见性的信息。可见性映射中的“全部可见”位表示一个关系的给定页面上的所有元组对每一个当前事务都可见。可见性映射中的“全部冻结”位表示该页上的每一个元组都被冻结，也就是说直到在那个页面上对一个元组进行插入、更新、删除或者锁定之前都不需要用 vacuum 对该页面进行修改。页面级别的PD_ALL_VISIBLE位具有和可见性映射中“全部可见”位相同的含义，但是它存储在数据页面本身中而不是存储在单独的数据结构中。这些位通常是相互一致的，但是有时在崩溃恢复后会出现页级别位被设置而可见性映射位被清除的情况，还有一种不一致的情况是在pg_visibility检查了可见性映射之后且在它检查数据页面之前发生了修改。任何导致数据损坏的时间也可能导致这些位不一致。
显示有关PD_ALL_VISIBLE的信息的函数代价比那些查看可见性映射的函数要高很多，因为它们必须读取关系的数据块而不是只读取（小很多的）可见性映射。类似地，检查关系的数据块的函数也很昂贵。
F.32.1. 函数
pg_visibility_map(regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean) returns record为给定关系的给定块返回其在可见性映射中的“全部可见”和“全部冻结”位。
pg_visibility(regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) returns record为给定关系的给定块返回其在可见性映射中的“全部可见”和“全部冻结”位，外加块的PD_ALL_VISIBLE位。
pg_visibility_map(regclass, blkno OUT bigint, all_visible OUT boolean, all_frozen OUT boolean) returns setof record为给定关系的每一块返回其在可见性映射中的“全部可见”和“全部冻结”位。
pg_visibility(regclass, blkno OUT bigint, all_visible OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) returns setof record为给定关系的每一块返回其在可见性映射中的“全部可见”和“全部冻结”位，外加每一块的PD_ALL_VISIBLE位。
pg_visibility_map_summary(regclass, all_visible OUT bigint, all_frozen OUT bigint) returns record根据可见性映射返回关系中“全部可见”页面和“全部冻结”页面的数量。
pg_check_frozen(regclass, t_ctid OUT tid) returns setof tid返回在可见性映射中被标为“全部冻结”的页面中非冻结元组的 TID。如果这个函数返回一个非空的 TID 集合，则数据库已经损坏。
pg_check_visible(regclass, t_ctid OUT tid) returns setof tid返回页面中不是全部可见的元组的 TID，而不管包含它们的页面在可见性映射中被标为“全部可见”。如果这个函数返回一个非空的 TID 集合，则数据库已经损坏。
pg_truncate_visibility_map(regclass) returns void为给定关系截断可见性映射。只有当怀疑一个关系的可见性映射被损坏并且想要重建它时，这个函数才有用。在这个函数被执行后，在给定关系上进行的第一次VACUUM将会扫描关系中的每一个页面并且重建可见性映射。
默认情况下，这些函数不是谁都能执行。
F.32.2. 作者
Robert Haas <[email protected]>