F.21. pageinspect

get_raw_page读取命名关系的指定块并且以一个bytea 值的形式返回一个拷贝。这允许获得该块的一个单个时间一致的拷贝。 对于主数据分叉，fork应该是'main'， 对于空闲空间映射应该是'fsm'，对于可见性映射应该是 'vm'，对于初始化分叉应该是'init'。

一个简写版的get_raw_page，用于读取主分叉。 等效于get_raw_page(relname, 'main', blkno)

page_header显示所有PostgreSQL堆和索引页面的公共域。

用get_raw_page获得的页面映像应该作为参数传递。例如：

test=# SELECT * FROM page_header(get_raw_page('pg_class', 0));
    lsn    | checksum | flags  | lower | upper | special | pagesize | version | prune_xid
-----------+----------+--------+-------+-------+---------+----------+---------+-----------
 0/24A1B50 |        1 |      1 |   232 |   368 |    8192 |     8192 |       4 |         0

返回的列对应于PageHeaderData结构中的字段。 详见src/include/storage/bufpage.h。

heap_page_items显示一个堆页面上所有的行指针。 对那些使用中的行指针，也会显示元组头部。不管元组对于拷贝原始页面时的 MVCC 快照是否可见，它们都会被显示。

用get_raw_page获得的堆页面映像应该作为参数传递。例如：

test=# SELECT * FROM heap_page_items(get_raw_page('pg_class', 0));

参阅src/include/storage/itemid.h和 src/include/access/htup_details.h获取返回的字段的解释。

bt_metap返回关于一个B-树索引的元页的信息。例如：

test=# SELECT * FROM bt_metap('pg_cast_oid_index');
-[ RECORD 1 ]-----
magic     | 340322
version   | 2
root      | 1
level     | 0
fastroot  | 1
fastlevel | 0

bt_page_stats返回关于B-树索引单一页面的摘要信息。例如：

test=# SELECT * FROM bt_page_stats('pg_cast_oid_index', 1);
-[ RECORD 1 ]-+-----
blkno         | 1
type          | l
live_items    | 256
dead_items    | 0
avg_item_size | 12
page_size     | 8192
free_size     | 4056
btpo_prev     | 0
btpo_next     | 0
btpo          | 0
btpo_flags    | 3

bt_page_items返回关于B-树索引页面上所有项的详细信息。例如：

test=# SELECT * FROM bt_page_items('pg_cast_oid_index', 1);
 itemoffset |  ctid   | itemlen | nulls | vars |    data
------------+---------+---------+-------+------+-------------
          1 | (0,1)   |      12 | f     | f    | 23 27 00 00
          2 | (0,2)   |      12 | f     | f    | 24 27 00 00
          3 | (0,3)   |      12 | f     | f    | 25 27 00 00
          4 | (0,4)   |      12 | f     | f    | 26 27 00 00
          5 | (0,5)   |      12 | f     | f    | 27 27 00 00
          6 | (0,6)   |      12 | f     | f    | 28 27 00 00
          7 | (0,7)   |      12 | f     | f    | 29 27 00 00
          8 | (0,8)   |      12 | f     | f    | 2a 27 00 00

在B树叶子页面中，ctid指向一个堆元组。 在内部页面中，ctid的块编号部分指向索引本身中的另一个页面， 忽略偏移部分（第二个数字），它通常是1。

注意，任何非最右边的页面（btpo_next 字段中的任何非零值的页面）的第一个项是页面的"高键"， 意味着它的data用作页面上显示的所有项的上限， 而其ctid字段是无意义的。此外，在非叶子页面上， 第一个真实数据项（不是高键的第一个项）是"负无穷"项， 在其data域没有真实值。然而，这样的项在其 ctid字段中具有有效的下行链路。

brin_page_type返回给定的BRIN 索引页面的页面类型，如果页面不是有效的BRIN页面， 则会抛出错误。例如：

test=# SELECT brin_page_type(get_raw_page('brinidx', 0));
 brin_page_type 
----------------
 meta

brin_metapage_info返回有关BRIN 索引元页的分类信息。例如：

test=# SELECT * FROM brin_metapage_info(get_raw_page('brinidx', 0));
   magic    | version | pagesperrange | lastrevmappage 
------------+---------+---------------+----------------
 0xA8109CFA |       1 |             4 |              2

brin_revmap_data返回BRIN 索引范围映射页面中的元组标识符列表。例如：

test=# SELECT * FROM brin_revmap_data(get_raw_page('brinidx', 2)) limit 5;
  pages  
---------
 (6,137)
 (6,138)
 (6,139)
 (6,140)
 (6,141)

brin_page_items返回存储在BRIN 数据页面中的数据。例如：

test=# SELECT * FROM brin_page_items(get_raw_page('brinidx', 5),
                                     'brinidx')
       ORDER BY blknum, attnum LIMIT 6;
 itemoffset | blknum | attnum | allnulls | hasnulls | placeholder |    value     
------------+--------+--------+----------+----------+-------------+--------------
        137 |      0 |      1 | t        | f        | f           | 
        137 |      0 |      2 | f        | f        | f           | {1 .. 88}
        138 |      4 |      1 | t        | f        | f           | 
        138 |      4 |      2 | f        | f        | f           | {89 .. 176}
        139 |      8 |      1 | t        | f        | f           | 
        139 |      8 |      2 | f        | f        | f           | {177 .. 264}

返回的列对应于BrinMemTuple和BrinValues 结构中的字段。有关详细信息，请参见src/include/access/brin_tuple.h。

gin_metapage_info返回关于GIN 索引元页的信息。例如：

test=# SELECT * FROM gin_metapage_info(get_raw_page('gin_index', 0));
-[ RECORD 1 ]----+-----------
pending_head     | 4294967295
pending_tail     | 4294967295
tail_free_size   | 0
n_pending_pages  | 0
n_pending_tuples | 0
n_total_pages    | 7
n_entry_pages    | 6
n_data_pages     | 0
n_entries        | 693
version          | 2

gin_page_opaque_info返回关于GIN 索引不透明区域的信息，像页面类型。例如：

test=# SELECT * FROM gin_page_opaque_info(get_raw_page('gin_index', 2));
 rightlink | maxoff |         flags
-----------+--------+------------------------
         5 |      0 | {data,leaf,compressed}
(1 row)

gin_leafpage_items返回关于存储在GIN 叶子页面中的数据的信息。例如：

test=# SELECT first_tid, nbytes, tids[0:5] as some_tids
        FROM gin_leafpage_items(get_raw_page('gin_test_idx', 2));
 first_tid | nbytes |                        some_tids
-----------+--------+----------------------------------------------------------
 (8,41)    |    244 | {"(8,41)","(8,43)","(8,44)","(8,45)","(8,46)"}
 (10,45)   |    248 | {"(10,45)","(10,46)","(10,47)","(10,48)","(10,49)"}
 (12,52)   |    248 | {"(12,52)","(12,53)","(12,54)","(12,55)","(12,56)"}
 (14,59)   |    320 | {"(14,59)","(14,60)","(14,61)","(14,62)","(14,63)"}
 (167,16)  |    376 | {"(167,16)","(167,17)","(167,18)","(167,19)","(167,20)"}
 (170,30)  |    376 | {"(170,30)","(170,31)","(170,32)","(170,33)","(170,34)"}
 (173,44)  |    197 | {"(173,44)","(173,45)","(173,46)","(173,47)","(173,48)"}
(7 rows)

fsm_page_contents显示了 FSM 页面的内部结点结构。 输出是一个多行字符串，每一行对应页面中二叉树的一个结点。 只有非零节点会被打印。所谓的“next”指针也会被打印， 它指向页面中下一个要被返回的槽。

参阅src/backend/storage/freespace/README 获取更多关于FSM页面的结构的信息。