PostgreSQL特性矩阵解析系列29之Visibility Map for Vacuuming

postgres=# create table test(id int);
CREATE TABLE
postgres=# insert into test(id) values(1);
INSERT 0 1
postgres=# insert into test(id) values(1);
INSERT 0 1
postgres=# insert into test(id) values(1);
INSERT 0 1
postgres=# insert into test(id) values(1);
INSERT 0 1
postgres=# insert into test(id) values(1);
INSERT 0 1
postgres=# select pg_relation_filenode('test');
 pg_relation_filenode 
----------------------
                16384
(1 row)


postgres=# select pg_relation_filepath('test');
 pg_relation_filepath 
----------------------
 base/13214/16384
(1 row)


postgres=# vacuum test;
VACUUM
postgres@pgexp1-> ll 13214/16384*     
-rw-------. 1 postgres postgres 8.0K Dec  5 20:29 13214/16384
-rw-------. 1 postgres postgres  24K Dec  5 20:31 13214/16384_fsm
-rw-------. 1 postgres postgres 8.0K Dec  5 20:31 13214/16384_vm


postgres=# create extension pg_visibility;
CREATE EXTENSION
postgres=# \dx
                                     List of installed extensions
     Name      | Version |   Schema   |                          Description                           
---------------+---------+------------+----------------------------------------------------------------
 pg_visibility | 1.2     | public     | examine the visibility map (VM) and page-level visibility info
 plpgsql       | 1.0     | pg_catalog | PL/pgSQL procedural language
(2 rows)


1.pg_visibility_map(relation regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean) returns record
为给定关系的给定块返回其在可见性映射中的“全部可见”和“全部冻结”位。
postgres=# select pg_visibility_map('test'::regclass, 0);
 pg_visibility_map 
-------------------
 (t,f)
(1 row)
t表示所有可见。


2.pg_visibility(relation regclass, blkno bigint, all_visible OUT boolean, all_frozen OUT boolean, pd_all_visible OUT boolean) returns record
为给定关系的给定块返回其在可见性映射中的“全部可见”和“全部冻结”位，外加块的PD_ALL_VISIBLE位。
postgres=# select pg_visibility('test'::regclass, 0);           
 pg_visibility 
---------------
 (t,f,t)
 
3.pg_visibility_map(relation regclass, blkno OUT bigint, all_visible OUT boolean, all_frozen OUT boolean) returns setof record
为给定关系的每一块返回其在可见性映射中的“全部可见”和“全部冻结”位。


4.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位。


5.pg_visibility_map_summary(relation regclass, all_visible OUT bigint, all_frozen OUT bigint) returns record
根据可见性映射返回关系中“全部可见”页面和“全部冻结”页面的数量。
postgres=# select pg_visibility_map_summary('test'::regclass);              
 pg_visibility_map_summary 
---------------------------
 (1,0)
(1 row)


6.pg_check_frozen(relation regclass, t_ctid OUT tid) returns setof tid
返回存储在可见性映射中被标为“全部冻结”的页面中的非冻结元组的 TID。如果这个函数返回一个非空的 TID 集合，则可见性映射已经损坏。
postgres=# select pg_check_frozen('test'::regclass);                     
 pg_check_frozen 
-----------------
(0 rows)


7.pg_check_visible(relation regclass, t_ctid OUT tid) returns setof tid
返回存储在可见性映射中标记为全部可见的页面中的非全部可见元组的TID。如果此函数返回非空的一组TID，则可见性映射已损坏。


8.pg_truncate_visibility_map(relation regclass) returns void
为给定关系截断可见性映射。如果您认为该关系的可见性映射已损坏并希望强制重建它， 则该函数非常有用。在这个函数被执行后，在给定关系上进行的第一次VACUUM 将会扫描关系中的每一个页面并且重建可见性映射。（在完成之前， 查询会将可见性映射看做包含的全是零。）