postgres.git / summary / log / commit / refs

commit    da9a888da22c66764a2f97099c8f6c9462dbcbb7
Author:   Fujii Masao <fujii@postgresql.org>
Date:     Tue Jul 15 23:03:36 2025 +0000
First released in: 18.0

    doc: Clarify that total_vacuum_time excludes VACUUM FULL.
    
    The last_vacuum and vacuum_count fields in pg_stat_all_tables already
    state that they do not include VACUUM FULL. However, total_vacuum_time,
    which also excludes VACUUM FULL, did not mention this. This could
    mislead users into thinking VACUUM FULL time is included.
    
    To address this, this commit updates the documentation for
    pg_stat_all_tables to explicitly state that total_vacuum_time does not
    count VACUUM FULL.
    
    Back-patched to v18, where total_vacuum_time was introduced.
    
    Additionally, this commit clarifies that n_ins_since_vacuum also
    excludes VACUUM FULL. Although n_ins_since_vacuum was added in v13,
    we are not back-patching this change to stable branches, as it is
    a documentation improvement, not a bug fix.
    
    Author: Fujii Masao <masao.fujii@gmail.com>
    Reviewed-by: Robert Treat <rob@xzilla.net>
    Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
    Reviewed-by: Laurenz Albe <laurenz.albe@cybertec.at>
    Discussion: https://postgr.es/m/2ac375d1-591b-4f1b-a2af-f24335567866@oss.nttdata.com
    Backpatch-through: 18


 doc/src/sgml/monitoring.sgml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index 4265a22d4de..823afe1b30b 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -3980,6 +3980,7 @@ description | Waiting for a newly initialized WAL file to reach durable storage
       </para>
       <para>
        Estimated number of rows inserted since this table was last vacuumed
+       (not counting <command>VACUUM FULL</command>)
       </para></entry>
      </row>
 
@@ -4066,7 +4067,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
        <structfield>total_vacuum_time</structfield> <type>double precision</type>
       </para>
       <para>
-       Total time this table has been manually vacuumed, in milliseconds.
+       Total time this table has been manually vacuumed, in milliseconds
+       (not counting <command>VACUUM FULL</command>).
        (This includes the time spent sleeping due to cost-based delays.)
       </para></entry>
      </row>


[parent: f8ce5dea433c]