F.29. pgstattuple · PostgreSQL 中文文檔 9.3

# F.29\. pgstattuple `pgstattuple`模塊提供各種函數以獲得元組級別的狀態。 ## F.29.1\. 函數 `pgstattuple(text) returns record` `pgstattuple`返回一個關系的實際長度，"死的" 元組的百分比，和其他信息。這幫助用戶確定是否需要vacuum。該參數是目標關系的名字（可以有模式限定）。例如： ``` test=> SELECT * FROM pgstattuple('pg_catalog.pg_proc'); -[ RECORD 1 ]------+------- table_len | 458752 tuple_count | 1470 tuple_len | 438896 tuple_percent | 95.67 dead_tuple_count | 11 dead_tuple_len | 3157 dead_tuple_percent | 0.69 free_space | 8932 free_percent | 1.95 ``` 輸出字段在[Table F-21](#calibre_link-1548)中描述。 **Table F-21\. `pgstattuple` 輸出字段** | 字段 | 類型 | 描述 | | --- | --- | --- | | `table_len` | `bigint` | 實際關系長度以字節計 | | `tuple_count` | `bigint` | 活的元組的數量 | | `tuple_len` | `bigint` | 活的元組的總長度，以字節計 | | `tuple_percent` | `float8` | 活的元組的百分比 | | `dead_tuple_count` | `bigint` | 死的元組的數量 | | `dead_tuple_len` | `bigint` | 死的元組的總長度，以字節計 | | `dead_tuple_percent` | `float8` | 死的元組的百分比 | | `free_space` | `bigint` | 總的空閑空間，以字節計 | | `free_percent` | `float8` | 空閑空間的百分比 | `pgstattuple`只獲取關系中的讀鎖。所以結果并不反映一個瞬間的快照；并發的更新將影響它們。如果`HeapTupleSatisfiesNow`返回假，那么`pgstattuple` 判斷一個元組是否是"死的"。 `pgstattuple(oid) returns record` 這和`pgstattuple(text)`一樣，除了目標關系是通過OID指定之外。 `pgstatindex(text) returns record` `pgstatindex`返回一個顯示關于B-tree索引信息的記錄。例如： ``` test=> SELECT * FROM pgstatindex('pg_cast_oid_index'); -[ RECORD 1 ]------+------ version | 2 tree_level | 0 index_size | 8192 root_block_no | 1 internal_pages | 0 leaf_pages | 1 empty_pages | 0 deleted_pages | 0 avg_leaf_density | 50.27 leaf_fragmentation | 0 ``` 輸出字段是： | 字段 | 類型 | 描述 | | --- | --- | --- | | `version` | `integer` | B-tree 版本號 | | `tree_level` | `integer` | 根頁面的樹級別 | | `index_size` | `bigint` | 索引中頁面的總數量 | | `root_block_no` | `bigint` | 根塊的位置 | | `internal_pages` | `bigint` | "internal" (上一級) 頁面的數量 | | `leaf_pages` | `bigint` | 葉子頁面的數量 | | `empty_pages` | `bigint` | 空白頁面的數量 | | `deleted_pages` | `bigint` | 已刪除頁面的數量 | | `avg_leaf_density` | `float8` | 葉子頁面的平均密度 | | `leaf_fragmentation` | `float8` | 葉子頁面碎片 | 與`pgstattuple`一樣，結果是一頁一頁的累積的，不應該期望代表整個索引的一個瞬間快照。 `pgstatginindex(regclass) returns record` `pgstatginindex`返回一個顯示關于GIN索引信息的記錄。例如： ``` test=> SELECT * FROM pgstatginindex('test_gin_index'); -[ RECORD 1 ]--+-- version | 1 pending_pages | 0 pending_tuples | 0 ``` 輸出字段是： | 字段 | 類型 | 描述 | | --- | --- | --- | | `version` | `integer` | GIN 版本號 | | `pending_pages` | `integer` | 等待列表中頁面的數量 | | `pending_tuples` | `bigint` | 等待列表中元組的數量 | `pg_relpages(text) returns bigint` `pg_relpages`返回關系中頁面的數量。 ## F.29.2\. 作者 Tatsuo Ishii 和 Satoshi Nagayasu