F.30. pgstattuple
pgstattuple模块提供多种函数来获得元组层的统计信息。
F.30.1. 函数
-
pgstattuple(regclass) 返回 record -
pgstattuple返回一个关系的物理长度、"死亡"元组的百分比以及其他信息。这可以帮助用户决定是否需要清理。参数是目标关系的名称（可以有选择地用模式限定）或者 OID。例如：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-23中描述了输出列。
表 F-23.
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只要求在关系上的一个读锁。因此结果不能反映一个即时快照，并发更新将影响结果。如果
HeapTupleSatisfiesDirty返回假，pgstattuple就判定一个元组是"死亡的"。 pgstattuple(text) 返回 record与
pgstattuple(regclass)相同，只不过通过 TEXT 指定目标关系。这个函数只是为了向后兼容而保留，在未来的发布中将会被废除。-
pgstatindex(regclass) 返回 record -
pgstatindex返回一个记录显示有关一个 B-树索引的信息。例如：test=> SELECT * FROM pgstatindex('pg_cast_oid_index'); -[ RECORD 1 ]------+------ version | 2 tree_level | 0 index_size | 16384 root_block_no | 1 internal_pages | 0 leaf_pages | 1 empty_pages | 0 deleted_pages | 0 avg_leaf_density | 54.27 leaf_fragmentation | 0输出列是：
列 类型 描述 version integer B-树 版本号 tree_level integer 根页的树层次 index_size bigint 以字节计的索引总尺寸 root_block_no bigint 根页的位置（如果没有则为零） internal_pages bigint "内部"（上层）页面的数量 leaf_pages bigint 叶子页的数量 empty_pages bigint 空页的数量 deleted_pages bigint 删除页的数量 avg_leaf_density float8 叶子页的平均密度 leaf_fragmentation float8 叶子页碎片 报告的index_size通常对应于internal_pages + leaf_pages + empty_pages + deleted_pages加一，因为它还包括索引的元页。
对于
pgstattuple，结果是一页一页累计的并且不要期望结果会表示整个索引的一个即时快照。 pgstatindex(text) returns record与
pgstatindex(regclass)相同，只不过通过 TEXT 指定目标索引。这个函数只是为了向后兼容而保留，在未来的某个发布中将会被废除。-
pgstatginindex(regclass) 返回 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(regclass) 返回 bigint pg_relpages返回关系中的页面数。pg_relpages(text) returns bigint与
pg_relpages(regclass)相同，只不过用 TEXT 来 指定目标关系。这个函数只是为了向后兼容而保留，在未来的某个发布中将会被废除。-
pgstattuple_approx(regclass) returns record -
pgstattuple_approx是pgstattuple的一个更加快速的替代品，它返回近似的结果。参数是目标关系的 OID 或者名称。例如：test=> SELECT * FROM pgstattuple_approx('pg_catalog.pg_proc'::regclass); -[ RECORD 1 ]--------+------- table_len | 573440 scanned_percent | 2 approx_tuple_count | 2740 approx_tuple_len | 561210 approx_tuple_percent | 97.87 dead_tuple_count | 0 dead_tuple_len | 0 dead_tuple_percent | 0 approx_free_space | 11996 approx_free_percent | 2.09输出列在表 F-24中描述。
鉴于
pgstattuple总是执行全表扫描并且返回存活和死亡元组的准确计数、尺寸和空闲空间，pgstattuple_approx尝试避免全表扫描并且返回死亡元组的准确统计信息，以及存活元组和空闲空间的近似数量及尺寸。这个函数通过根据可见性映射跳过只包含可见元组的页面来实现这一目的（如果一个页面对应的 VM 位被设置，那么就说明它不含有死亡元组）。对于这样的额页面，它会从空闲空间映射中得到空闲空间值，并且假定该页面上的剩余空间由存活元组占据。
对于不能被跳过的页面，它会扫描每个元组，在合适的计数器中记录它的存在以及尺寸，并且统计该页面上的空闲空间。最后，它会基于已扫描的页面和元组数量来估计存活元组的总数（采用与 VACUUM 估计 pg_class.reltuples 时相同的方法）。
表 F-24.
pgstattuple_approx输出列列 类型 描述 table_len bigint 以字节计的物理关系长度（准确） scanned_percent float8 已扫描表的百分比 approx_tuple_count bigint 存活元组的数量（估计） approx_tuple_len bigint 以字节计的存活元组总长度（估计） approx_tuple_percent float8 存活元组的百分比 dead_tuple_count bigint 死亡元组的数量（准确） dead_tuple_len bigint 以字节计的死亡元组总长度（准确） dead_tuple_percent float8 死亡元组的百分比 approx_free_space bigint 以字节计的总空闲空间（估计） approx_free_percent float8 空闲空间的百分比 在上述的输出中，空闲空间数字可能不完全匹配
pgstattuple的输出，这是因为空闲空间映射会给出一个准确的数字，但是这个数字不能保证是一个准确的字节数。
F.30.2. 作者
Tatsuo Ishii, Satoshi Nagayasu 和 Abhijit Menon-Sen