pginspect几个函数

pageinspect作为插件，查看数据库中页内容。

这个插件具有的函数功能：

get_raw_page

get_raw_page(relname text, fork text, blkno int) returns bytea

读取表文件指定页号的内容。Fork：main,fsm,vm和init:initialization fork。

可以调用get_raw_page(relname text,blkno int)读取main主表内容。

page_header

page_header(page bytea) returns record

给定页地址，返回页头信息（heap和index页）。页地址可以通过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 | 0 | 1 | 232 | 368 | 8192 | 8192 | 4 | 0

page_checksum

page_checksum(page bytea,blkno int4) return smallint

计算给定页的checksum，页地址可以通过get_raw_page函数获取，checksum依赖于页号，所以页号必须作为入参传入：

test=# SELECT page_checksum(get_raw_page('pg_class', 0), 0);

page_checksum

---------------

13443

fsm_page_contents

fsm_page_contents显示fsm页的内部结构：

test=# SELECT fsm_page_contents(get_raw_page('pg_class', 'fsm', 0));

输出多行字符串，页中Btree的一个节点一行。只有非零节点才会打印。指向next slot的“next”指针也会打印。

heap_page_items

heap_page_items(page bytea) returns setof record

显示heap页中多有line指针。会显示所有tuple。

Select count(*) from heap_page_items(get_raw_page(‘t’,1));

第一页中有几个记录

tuple_data_split

tuple_data_split(rel_oid oid, t_data bytea, t_infomask integer, t_infomask2 integer, t_bits text [, do_detoast bool]) returns bytea[]

将tuple的数据以16进制按列显示。

heap_page_item_attrs

heap_page_item_attrs(page bytea, rel_oid regclass [, do_detoast bool]) returns setof record

和heap_page_item_attrs和heap_page_items类似。

bt_metap

bt_metap(relname text) returns record

返回Btree索引的元数据信息：

test=# SELECT * FROM bt_metap('pg_cast_oid_index');

-[ RECORD 1 ]-----------+-------

magic | 340322

version | 3

root | 1

level | 0

fastroot | 1

fastlevel | 0

oldest_xact | 582

last_cleanup_num_tuples | 1000

bt_page_stats

bt_page_stats(relname text, blkno int) returns record

返回btree索引单页信息：

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

bt_page_items(relname text, blkno int) returns setof record

Btree索引页中所有items的详细信息：

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

Btree的叶子页，ctid指向heap tuple。内部页，ctid的页号部分指向索引的其他页。offset部分通常被忽略，设置为1

也可以使用函数bt_page_items(page bytea）

gin_metapage_info：gin索引元数据信息

gin_page_opaque_info：gin索引的opaque域

gin_leafpage_items：gin 叶子页的数据

hash_page_type：hash索引页页类型

hash_page_stats：hash索引的溢出页或者bucket的信息

hash_page_items：

hash_bitmap_info

hash_metapage_info