# F.22\. pageinspect `pageinspect`模塊提供允許在一個低水平檢查數據庫頁面的內容的函數， 這對于調試目的很有用。所有這些函數只能是超級用戶使用。 ## F.22.1\. 函數 `get_raw_page(relname text, fork text, blkno int) returns bytea` `get_raw_page`讀取命名表指定的塊并返回一個拷貝作為`bytea`值。 這允許獲得一個該塊的時間一致的拷貝。`_fork_`應該是主數據派生的 `'main'`，或自由空間映射的`'fsm'`，或可見映射的`'vm'`。 `get_raw_page(relname text, blkno int) returns bytea` `get_raw_page`的短版本，從主分支上讀取。 等于`get_raw_page(relname, 'main', blkno)` `page_header(page bytea) returns 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 | 1 | 1 | 232 | 368 | 8192 | 8192 | 4 | 0 ``` 返回的列符合`PageHeaderData`結構中的字段。 參閱`src/include/storage/bufpage.h`獲取詳細信息。 `heap_page_items(page bytea) returns 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` 獲取返回的字段的解釋。 `bt_metap(relname text) returns record` `bt_metap`返回關于B-tree索引的元頁的信息。例如： ``` 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(relname text, blkno int) returns record` `bt_page_stats`返回關于B-tree索引的單個頁面的摘要信息。例如： ``` 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) returns setof record` `bt_page_items`返回關于B-tree索引頁中的所有條目的詳細信息。例如： ``` 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 ``` `fsm_page_contents(page bytea) returns text` `fsm_page_contents`顯示了FSM頁的內部節點結構。輸出是多行字符串， 在該頁中的二叉樹上每個節點一行。這些節點中只有不是零的才輸出。號稱"next"的指針， 指向下一個從頁面中返回的位置的指針，也輸出。 參閱`src/backend/storage/freespace/README`獲取更多關于FSM頁面的結構的信息。