pageinspect
模块提供函数让你从低层次观察数据库页面的内容,这对于调试目的很有用。所有这些函数只能被超级用户使用。
get_raw_page(relname text, fork text, blkno int) 返回 bytea
get_raw_page
读取提及的关系中的指定块并且以一个bytea
值的形式返回一个拷贝。这允许得到该块的一个单一的时间一致的拷贝。对于主数据分叉,fork
应该是'main'
,对于空闲空间映射应该是'fsm'
,对于可见性映射应该是'vm'
,对于初始化分叉应该是'init'
。
get_raw_page(relname text, blkno int) 返回 bytea
一个简写版的get_raw_page
,用于读取主分叉。等效于get_raw_page(relname, 'main', blkno)
page_header(page bytea) 返回 record
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 | 0 | 1 | 232 | 368 | 8192 | 8192 | 4 | 0
返回的列对应于PageHeaderData
结构中的域。详见src/include/storage/bufpage.h
。
checksum
域是存放在页面中的校验和,如果页面被损坏它可能是不正确的。如果对这个实例没有启用数据校验和,则存储的这个值没有意义。
page_checksum(page bytea, blkno int4) returns smallint
page_checksum
为页面计算校验和,就像它被放置在给定块上一样。
应该将get_raw_page
得到的页面映像作为参数传入。例如:
test=# SELECT page_checksum(get_raw_page('pg_class', 0), 0); page_checksum --------------- 13443
注意校验和取决于块号,因此应该将匹配的块号传入(除非在做调试)。
用这个函数计算的校验和可以拿来和函数page_header
的结果域checksum
进行比较。如果为这个实例启用了数据校验和,则两个值应该相等。
heap_page_items(page bytea) 返回 setof record
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
。
tuple_data_split(rel_oid, t_data bytea, t_infomask integer, t_infomask2 integer, t_bits text [, do_detoast bool]) returns bytea[]
tuple_data_split
以后端内部的相同方式将元组数据拆解成属性。
test=# SELECT tuple_data_split('pg_class'::regclass, t_data, t_infomask, t_infomask2, t_bits) FROM heap_page_items(get_raw_page('pg_class', 0));
应该用与heap_page_items
的返回属性相同的参数来调用这个函数。
如果do_detoast
是true
,则根据需要将把属性解除TOAST。默认值为false
。
heap_page_item_attrs(rel_oid, t_data bytea, [, do_detoast bool]) returns bytea[]
heap_page_item_attrs
等效于
heap_page_items
,不过它会把元组原始数据
返回为属性的数组,如果do_detoast
为真(
默认为false
),这些属性会被反 TOAST。
应该把用get_raw_page
得到的一个堆页面映像
作为参数传入。例如:
test=# SELECT * FROM heap_page_item_attrs(get_raw_page('pg_class', 0), 'pg_class'::regclass);
fsm_page_contents(page bytea) returns text
fsm_page_contents
展示一个FSM页面的内部节点结构。输出是一个多行字符串,每一行对应于页面中二叉树的每一个节点。只有非零节点才会被打印。所谓的“next”指针(指向页面中下一个要返回的槽)也会被打印。
更多有关FSM页面结构的信息请见src/backend/storage/freespace/README
。
bt_metap(relname text) 返回 record
bt_metap
返回关于一个B树索引元页的信息。例如:
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(relname text, blkno int) 返回 record
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(relname text, blkno int) 返回 setof record
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
域中有非零
值)上的第一个项是该页的“high key”,表示它的
data
是作为该页面上所有项的一个上界存在,而它的
ctid
域没有意义。还有,在非叶子页面上,第一个真正
的数据项(第一个不是 high key 的项)是一个“负无穷”
项,它的data
域中没有实际值。不过,这样一个项确实
在其有ctid
域中有向下的链接。
bt_page_items(page bytea) returns setof record
还可以把一个页面以bytea
值的形式传递给bt_page_items
。应该将get_raw_page
得到的页面映像作为参数传入。因此,上一个例子可以被重写成这样:
test=# SELECT * FROM bt_page_items(get_raw_page('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
所有其他细节和前一项中的解释相同。
brin_page_type(page bytea) returns text
brin_page_type
返回一个给定的
BRIN索引页面的页面类型,如果该页面不是
一个合法的BRIN页面则抛出错误。例如:
test=# SELECT brin_page_type(get_raw_page('brinidx', 0)); brin_page_type ---------------- meta
brin_metapage_info(page bytea) returns record
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(page bytea) returns setof tid
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(page bytea, index oid) returns setof record
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(page bytea) returns record
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(page bytea) returns record
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(page bytea) returns setof record
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)
hash_page_type(page bytea) returns text
hash_page_type
返回给定的HASH索引页面的页面类型。例如:
test=# SELECT hash_page_type(get_raw_page('con_hash_index', 0)); hash_page_type ---------------- metapage
hash_page_stats(page bytea) returns setof record
hash_page_stats
返回有关一个HASH索引的桶页或者溢出页的信息。例如:
test=# SELECT * FROM hash_page_stats(get_raw_page('con_hash_index', 1)); -[ RECORD 1 ]---+----------- live_items | 407 dead_items | 0 page_size | 8192 free_size | 8 hasho_prevblkno | 4096 hasho_nextblkno | 8474 hasho_bucket | 0 hasho_flag | 66 hasho_page_id | 65408
hash_page_items(page bytea) returns setof record
hash_page_items
返回有关一个HASH索引的桶页或者溢出页中存储的数据的信息。例如:
test=# SELECT * FROM hash_page_items(get_raw_page('con_hash_index', 1)) LIMIT 5; itemoffset | ctid | data ------------+-----------+------------ 1 | (899,77) | 1053474816 2 | (897,29) | 1053474816 3 | (894,207) | 1053474816 4 | (892,159) | 1053474816 5 | (890,111) | 1053474816
hash_bitmap_info(index oid, blkno int) returns record
hash_bitmap_info
返回HASH索引一个特定溢出页在位图页中的位的状态。例如:
test=# SELECT * FROM hash_bitmap_info('con_hash_index', 2052); bitmapblkno | bitmapbit | bitstatus -------------+-----------+----------- 65 | 3 | t
hash_metapage_info(page bytea) returns record
hash_metapage_info
返回一个HASH索引的元页中存放的信息。例如:
test=# SELECT magic, version, ntuples, ffactor, bsize, bmsize, bmshift, test-# maxbucket, highmask, lowmask, ovflpoint, firstfree, nmaps, procid, test-# regexp_replace(spares::text, '(,0)*}', '}') as spares, test-# regexp_replace(mapp::text, '(,0)*}', '}') as mapp test-# FROM hash_metapage_info(get_raw_page('con_hash_index', 0)); -[ RECORD 1 ]------------------------------------------------------------------------------- magic | 105121344 version | 4 ntuples | 500500 ffactor | 40 bsize | 8152 bmsize | 4096 bmshift | 15 maxbucket | 12512 highmask | 16383 lowmask | 8191 ovflpoint | 28 firstfree | 1204 nmaps | 1 procid | 450 spares | {0,0,0,0,0,0,1,1,1,1,1,1,1,1,3,4,4,4,45,55,58,59,508,567,628,704,1193,1202,1204} mapp | {65}