The <filename>pg_visibility</filename> module provides a means for examining the visibility map (VM) and page-level visibility information of a table. It also provides functions to check the integrity of a visibility map and to force it to be rebuilt. pg_visibilityモジュールは可視性マップ(Visibility Map, VM)およびテーブルのページレベルでの可視性情報を検査する手段を提供します。 このモジュールはまた、可視性マップの整合性を検査し、強制的に再構築する機能も提供します。

Three different bits are used to store information about page-level visibility. The all-visible bit in the visibility map indicates that every tuple in the corresponding page of the relation is visible to every current and future transaction. The all-frozen bit in the visibility map indicates that every tuple in the page is frozen; that is, no future vacuum will need to modify the page until such time as a tuple is inserted, updated, deleted, or locked on that page. The page header's <literal>PD_ALL_VISIBLE</literal> bit has the same meaning as the all-visible bit in the visibility map, but is stored within the data page itself rather than in a separate data structure. These two bits will normally agree, but the page's all-visible bit can sometimes be set while the visibility map bit is clear after a crash recovery. The reported values can also disagree because of a change that occurs after <literal>pg_visibility</literal> examines the visibility map and before it examines the data page. Any event that causes data corruption can also cause these bits to disagree. ページレベルの可視性についての情報を格納するために、3つの異なるビットが使用されます。 可視性マップの全可視ビットは、対応するリレーションのページの全タプルがすべての現在および将来のトランザクションに対して可視であることを示します。 可視性マップの全凍結ビットは、そのページのすべてのタプルが凍結されていることを示します。 これはすなわち、そのページに対してタプルの挿入、更新、削除、ロックなどが発生しない限り、将来もバキュームによる修正が必要ないことを意味します。 ページヘッダのPD_ALL_VISIBLEビットは、可視性マップの全可視ビットと同じ意味ですが、別のデータ構造ではなく、データページ自体の中に格納されています。 これら2つのビットは通常は同じ値になりますが、クラッシュリカバリの後は、ページの全可視ビットがセットされているのに、可視性マップの全可視ビットはクリアされているということもあります。 また、pg_visibilityが可視性マップを検査した後、データページを検査する前に更新が行われたために、これらについて報告される値が一致しないということもあり得ます。 データ破壊を起こすような何らかのイベントの後も、これらのビットが異なることがあり得ます。

Functions that display information about <literal>PD_ALL_VISIBLE</literal> bits are much more costly than those that only consult the visibility map, because they must read the relation's data blocks rather than only the (much smaller) visibility map. Functions that check the relation's data blocks are similarly expensive. PD_ALL_VISIBLEビットに関する情報を表示する関数は、可視性マップのみを参照する関数に比べるとずっと高価です。 これは、可視性マップだけではなく、（それよりずっと大きな）リレーションのデータブロックを読む必要があるからです。 リレーションのデータブロックを検査する関数は、同様に高価です。