2024年9月26日: PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本:11 / 10 / 9.6

F.34. pg_visibility — 可见性映射信息和实用程序 #

pg_visibility 模块提供了一种检查表的可视性映射 (VM) 和页面级可视性信息的方法。它还提供函数来检查可见性映射的完整性并强制重建它。

使用三个不同的位来存储有关页面级可见性的信息。可见性映射中的全可见位指示关系对应页面的每个元组对当前和将来所有事务都可见。可见性映射中的全冻结位指示页面中的每个元组都被冻结;也就是说,在将元组插入、更新、删除或锁定到该页面之前,将来不会有 vacuum 需要修改该页面。页面头部的 PD_ALL_VISIBLE 位与可见性映射中的全可见位具有相同的含义,但存储在数据页面本身中,而不是存储在单独的数据结构中。这两个位通常会一致,但在崩溃恢复后,有时可能会设置页面的全可见位,而可见性映射位却未设置。由于在 pg_visibility 检查可见性映射之后以及检查数据页面之前发生的更改,报告的值也可能不一致。任何导致数据损坏的事件也可能导致这些位不一致。

显示有关 PD_ALL_VISIBLE 位的信息的函数比仅查询可见性映射的函数成本高得多,因为它们必须读取关系的数据块,而不仅仅是(更小的)可见性映射。检查关系数据块的函数同样昂贵。

F.34.1. 函数 #

pg_visibility_map(relation regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean) returns record

返回给定关系的给定块在可见性映射中的全可见位和全冻结位。

pg_visibility(relation regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) returns record

返回给定关系的给定块在可见性映射中的全可见位和全冻结位,以及该块的 PD_ALL_VISIBLE 位。

pg_visibility_map(relation regclass, blkno OUT bigint, all_visible OUT boolean, all_frozen OUT boolean) returns setof record

返回给定关系的每个块在可见性映射中的全可见位和全冻结位。

pg_visibility(relation 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(relation regclass, all_visible OUT bigint, all_frozen OUT bigint) returns record

根据可见性映射返回关系中全可见页面的数量和全冻结页面的数量。

pg_check_frozen(relation regclass, t_ctid OUT tid) returns setof tid

返回存储在可见性映射中标记为全冻结的页面中的非冻结元组的 TID。如果此函数返回非空的 TID 集,则可见性映射已损坏。

pg_check_visible(relation regclass, t_ctid OUT tid) returns setof tid

返回存储在可见性映射中标记为全可见的页面中的非全可见元组的 TID。如果此函数返回非空的 TID 集,则可见性映射已损坏。

pg_truncate_visibility_map(relation regclass) returns void

截断给定关系的可见性映射。如果您认为关系的可见性映射已损坏并希望强制重建它,则此函数很有用。在此函数执行后在给定关系上执行的第一个 VACUUM 将扫描关系中的每个页面并重建可见性映射。(在此之前,查询将把可见性映射视为包含全零。)

默认情况下,这些函数仅可由超级用户和具有 pg_stat_scan_tables 角色权限的角色执行,除了 pg_truncate_visibility_map(relation regclass) 只能由超级用户执行。

F.34.2. 作者 #

Robert Haas

提交更正

如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符或需要进一步澄清,请使用 此表单 报告文档问题。