pgstattuple 返回关系表的物理长度、“死亡” 元组的百分比以及其他信息。这可以帮助用户确定是否需要 vacuum。参数是目标关系表的名称（可以选择使用模式限定）或 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 中描述。

pgstattuple 仅在关系表上获取读取锁。因此，结果不反映瞬时快照；并发更新将影响它们。

如果 HeapTupleSatisfiesDirty 返回 false，pgstattuple 会将元组判断为 “死亡”。

这与 pgstattuple(regclass) 相同，只是目标关系表被指定为 TEXT。保留此函数是为了向后兼容，在未来的某个版本中将会被弃用。

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

输出列为

报告的 index_size 通常会比 internal_pages + leaf_pages + empty_pages + deleted_pages 计数的页面多一个，因为它还包括索引的元页。

与 pgstattuple 一样，结果是逐页累积的，不应期望代表整个索引的瞬时快照。

这与 pgstatindex(regclass) 相同，只是目标索引被指定为 TEXT。保留此函数是为了向后兼容，在未来的某个版本中将会被弃用。

pgstatginindex 返回一条记录，显示有关 GIN 索引的信息。例如

test=> SELECT * FROM pgstatginindex('test_gin_index');
-[ RECORD 1 ]--+--
version        | 1
pending_pages  | 0
pending_tuples | 0

输出列为

pgstathashindex 返回一条记录，显示有关 HASH 索引的信息。例如

test=> select * from pgstathashindex('con_hash_index');
-[ RECORD 1 ]--+-----------------
version        | 4
bucket_pages   | 33081
overflow_pages | 0
bitmap_pages   | 1
unused_pages   | 32455
live_items     | 10204006
dead_items     | 0
free_percent   | 61.8005949100872

输出列为

pg_relpages 返回关系表中的页数。

这与 pg_relpages(regclass) 相同，只是目标关系表被指定为 TEXT。保留此函数是为了向后兼容，在未来的某个版本中将会被弃用。

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 的方式相同）。

在上面的输出中，可用空间数据可能与 pgstattuple 的输出不完全匹配，因为可用空间映射为我们提供了精确的数据，但不能保证精确到字节。