PostgreSQL 14 pageinspect 新增 gist 索引支持
pageinspect插件可以用来查看表和索引的内部结构，但并不是所有的索引类型都支持，PG14中增加了三个函数用来支持对gist索引的支持。
function gist_page_items(bytea,regclass)
function gist_page_items_bytea(bytea)
function gist_page_opaque_info(bytea)
例子：
创建测试表和索引：
bill@bill=>CREATE TABLE test_gist AS SELECT point(i,i) p, i::text t FROM
bill-# generate_series(1,1000) i;
SELECT 1000
bill@bill=> CREATE INDEX test_gist_idx ON test_gist USING gist (p);
CREATE INDEX
使用pageinspect观察gist索引结构：
bill@bill=> SELECT * FROM gist_page_opaque_info(get_raw_page('test_gist_idx', 0));
lsn | nsn | rightlink | flags
-----+-----+------------+-------
0/1 | 0/0 | 4294967295 | {}
(1 row)
bill@bill=> SELECT * FROM gist_page_opaque_info(get_raw_page('test_gist_idx', 1));
lsn | nsn | rightlink | flags
-----+-----+------------+--------
0/1 | 0/0 | 4294967295 | {leaf}
(1 row)
bill@bill=> SELECT * FROM gist_page_opaque_info(get_raw_page('test_gist_idx', 2));
lsn | nsn | rightlink | flags
-----+-----+-----------+--------
0/1 | 0/0 | 1 | {leaf}
(1 row)
bill@bill=> SELECT * FROM gist_page_items(get_raw_page('test_gist_idx', 0), 'test_gist_idx');
itemoffset | ctid | itemlen | dead | keys
------------+-----------+---------+------+-------------------
1 | (1,65535) | 40 | f | (p)=((166,166))
2 | (2,65535) | 40 | f | (p)=((332,332))
3 | (3,65535) | 40 | f | (p)=((498,498))
4 | (4,65535) | 40 | f | (p)=((664,664))
5 | (5,65535) | 40 | f | (p)=((830,830))
6 | (6,65535) | 40 | f | (p)=((996,996))
7 | (7,65535) | 40 | f | (p)=((1000,1000))
(7 rows)
bill@bill=> SELECT * FROM gist_page_items(get_raw_page('test_gist_idx', 1), 'test_gist_idx') LIMIT 5;
itemoffset | ctid | itemlen | dead | keys
------------+-------+---------+------+-------------
1 | (0,1) | 40 | f | (p)=((1,1))
2 | (0,2) | 40 | f | (p)=((2,2))
3 | (0,3) | 40 | f | (p)=((3,3))
4 | (0,4) | 40 | f | (p)=((4,4))
5 | (0,5) | 40 | f | (p)=((5,5))
(5 rows)
bill@bill=> SELECT * FROM gist_page_items(get_raw_page('test_gist_idx', 2), 'test_gist_idx') LIMIT 5;
itemoffset | ctid | itemlen | dead | keys
------------+--------+---------+------+-----------------
1 | (1,10) | 40 | f | (p)=((167,167))
2 | (1,11) | 40 | f | (p)=((168,168))
3 | (1,12) | 40 | f | (p)=((169,169))
4 | (1,13) | 40 | f | (p)=((170,170))
5 | (1,14) | 40 | f | (p)=((171,171))
(5 rows)
bill@bill=> SELECT * FROM gist_page_items_bytea(get_raw_page('test_gist_idx', 0));
itemoffset | ctid | itemlen | dead | key_data
------------+-----------+---------+------+------------------------------------------------------------------------------------
1 | (1,65535) | 40 | f | \x00000100ffff28000000000000c064400000000000c06440000000000000f03f000000000000f03f
2 | (2,65535) | 40 | f | \x00000200ffff28000000000000c074400000000000c074400000000000e064400000000000e06440
3 | (3,65535) | 40 | f | \x00000300ffff28000000000000207f400000000000207f400000000000d074400000000000d07440
4 | (4,65535) | 40 | f | \x00000400ffff28000000000000c084400000000000c084400000000000307f400000000000307f40
5 | (5,65535) | 40 | f | \x00000500ffff28000000000000f089400000000000f089400000000000c884400000000000c88440
6 | (6,65535) | 40 | f | \x00000600ffff28000000000000208f400000000000208f400000000000f889400000000000f88940
7 | (7,65535) | 40 | f | \x00000700ffff28000000000000408f400000000000408f400000000000288f400000000000288f40
(7 rows)
bill@bill=> SELECT * FROM gist_page_items_bytea(get_raw_page('test_gist_idx', 1)) LIMIT 5;
itemoffset | ctid | itemlen | dead | key_data
------------+-------+---------+------+------------------------------------------------------------------------------------
1 | (0,1) | 40 | f | \x0000000001002800000000000000f03f000000000000f03f000000000000f03f000000000000f03f
2 | (0,2) | 40 | f | \x00000000020028000000000000000040000000000000004000000000000000400000000000000040
3 | (0,3) | 40 | f | \x00000000030028000000000000000840000000000000084000000000000008400000000000000840
4 | (0,4) | 40 | f | \x00000000040028000000000000001040000000000000104000000000000010400000000000001040
5 | (0,5) | 40 | f | \x00000000050028000000000000001440000000000000144000000000000014400000000000001440
(5 rows)
bill@bill=> SELECT * FROM gist_page_items_bytea(get_raw_page('test_gist_idx', 2)) LIMIT 5;
itemoffset | ctid | itemlen | dead | key_data
------------+--------+---------+------+------------------------------------------------------------------------------------
1 | (1,10) | 40 | f | \x000001000a0028000000000000e064400000000000e064400000000000e064400000000000e06440
2 | (1,11) | 40 | f | \x000001000b0028000000000000006540000000000000654000000000000065400000000000006540
3 | (1,12) | 40 | f | \x000001000c0028000000000000206540000000000020654000000000002065400000000000206540
4 | (1,13) | 40 | f | \x000001000d0028000000000000406540000000000040654000000000004065400000000000406540
5 | (1,14) | 40 | f | \x000001000e0028000000000000606540000000000060654000000000006065400000000000606540
(5 rows)
