历史版本。 PostgreSQL 8.4 已结束支持。 请参阅 当前版本手册.
F.28. pgstattuple — 获取元组级统计信息 #
pgstattuple 模块提供了多种用于获取元组级统计信息的函数。
F.28.1. 函数
-
pgstattuple(text) returns record pgstattuple返回一个关系的物理长度、“死”元组所占百分比以及其他信息。这可以帮助用户判断是否需要执行清理。参数是目标关系的名称（可选带模式限定）。例如：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输出列在表 F.25中描述。
表 F.25.
pgstattuple输出列列 类型 描述 table_lenbigint关系的物理长度（字节） tuple_countbigint活元组数量 tuple_lenbigint活元组总长度（字节） tuple_percentfloat8活元组百分比 dead_tuple_countbigint死元组数量 dead_tuple_lenbigint死元组总长度（字节） dead_tuple_percentfloat8死元组百分比 free_spacebigint总空闲空间（字节） free_percentfloat8空闲空间百分比 pgstattuple只会在该关系上获取读锁。因此，结果并不代表一个瞬时快照；并发更新会影响结果。当
HeapTupleSatisfiesNow返回假时，pgstattuple就判定该元组是“死的”。-
pgstattuple(oid) returns record 它与
pgstattuple(text)相同，区别在于目标是用 OID 指定的关系。-
pgstatindex(text) returns record pgstatindex返回一个记录，其中显示关于 btree 索引的信息。例如：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输出列为：
表 F.26.
pgstatindex输出列列 类型 描述 versionintegerBtree 版本号 tree_levelinteger根页所在的树层级 index_sizebigint索引中的总页数 root_block_nobigint根块的位置 internal_pagesbigint“内部”（上层）页数量 leaf_pagesbigint叶子页数量 empty_pagesbigint空页数量 deleted_pagesbigint已删除页数量 avg_leaf_densityfloat8叶子页平均密度 leaf_fragmentationfloat8叶子页碎片率 与
pgstattuple一样，结果是逐页累积得到的，因此不应期望它表示整个索引的瞬时快照。-
pg_relpages(text) returns bigint pg_relpages返回该关系中的页数。
F.28.2. 作者
Tatsuo Ishii 和 Satoshi Nagayasu