diff options
author | Andrew Dunstan <andrew@dunslane.net> | 2016-12-27 11:23:46 -0500 |
---|---|---|
committer | Andrew Dunstan <andrew@dunslane.net> | 2016-12-27 11:28:23 -0500 |
commit | 3ba8beda0004742ead13eeeb7d9d17c226746326 (patch) | |
tree | 202efb1136d3b23fcf349cb784216ae4745eff96 | |
parent | 607d0cd14872aeabcd98bd168a50efa595ea7844 (diff) | |
download | postgresql-3ba8beda0004742ead13eeeb7d9d17c226746326.tar.gz |
Explain unaccounted for space in pgstattuple.
In addition to space accounted for by tuple_len, dead_tuple_len and
free_space, the table_len includes page overhead, the item pointers
table and padding bytes.
Backpatch to live branches.
-rw-r--r-- | doc/src/sgml/pgstattuple.sgml | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/src/sgml/pgstattuple.sgml b/doc/src/sgml/pgstattuple.sgml index 7f1ae8d304..acd2185396 100644 --- a/doc/src/sgml/pgstattuple.sgml +++ b/doc/src/sgml/pgstattuple.sgml @@ -106,6 +106,16 @@ free_percent | 1.95 </tgroup> </table> + <note> + <para> + The <literal>table_len</literal> will always be greater than the sum + of the <literal>tuple_len</literal>, <literal>dead_tuple_len</literal> + and <literal>free_space</literal>. The difference is accounted for by + fixed page overhead, the per-page table of pointers to tuples, and + padding to ensure that tuples are correctly aligned. + </para> + </note> + <para> <function>pgstattuple</function> acquires only a read lock on the relation. So the results do not reflect an instantaneous snapshot; |