F.29. pgstattuple

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-21中描述。

pgstattuple只要求在关系上的一个读锁。 因此结果不能反映一个即时快照，并发更新将影响结果。

如果HeapTupleSatisfiesDirty返回假， 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

输出字段是：

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-22中描述。

pgstattuple总是执行全表扫描并返回活的和死的元组 （及其大小）和可用空间的精确计数，pgstattuple_approx 尝试避免全表扫描并返回精确的死元组统计数据以及活元组和自由空间的数量和大小的近似值。

它通过根据可见性映射跳过仅具有可见元组的页面（如果页面具有相应的VM位集， 则假定其不包含死元组）实现这点。对于这样的页面， 它从自由空间映射中导出可用空间值，并假设页面上的其余空间由活的元组占用。

对于不能跳过的页面，它会扫描每个元组，在适当的计数器中记录其存在和大小， 并加上页面上的可用空间。最后，它基于扫描的页面和元组的数量估计活的元组的总数 （以与VACUUM估计pg_class.reltuples相同的方式）。

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