pg_stat_progress_vacuum.max_dead_tuple_bytes

Description

Amount of dead tuple data that we can store before needing to perform an index vacuum cycle, based on maintenance_work_mem.

View

pg_stat_progress_vacuum

Field

max_dead_tuple_bytes

SQL type

bigint

Units named in the field definition

Not specified

Reset observation

No stats_reset field is documented for this view

Usage

SELECT max_dead_tuple_bytes FROM pg_catalog.pg_stat_progress_vacuum;

View semantics

Whenever VACUUM is running, the pg_stat_progress_vacuum view will contain one row for each backend (including autovacuum worker processes) that is currently vacuuming. The tables below describe the information that will be reported and provide information about how to interpret it. Progress for VACUUM FULL commands is reported via pg_stat_progress_cluster because both VACUUM FULL and CLUSTER rewrite the table, while regular VACUUM only modifies it in place. See Section 27.4.2.

Collection and reset context

Read the same-version statistics collection and view documentation below for reset scope and visibility. No per-field reset rule is inferred from the field name.

Inspect this field

Example query; no execution result or measured value is asserted.

SELECT max_dead_tuple_bytes FROM pg_catalog.pg_stat_progress_vacuum;

Related entries

• pg_stat_progress_vacuum columns
• Statistics collection and reset functions

Documentation and source

• PostgreSQL 18 English manual

Compare versions

PostgreSQL 16 → 17: added.

--- PostgreSQL 16
+++ PostgreSQL 17
@@ -1 +1,6 @@
-Not recorded in this version
+{
+  "field": "max_dead_tuple_bytes",
+  "sql_type": "bigint",
+  "units_mentioned": [],
+  "view": "pg_stat_progress_vacuum"
+}

Compares recorded interfaces and attributes. Source fingerprints and build metadata are excluded; an absent sample is not proof of the introduction or removal release.

Related entries

• pg_stat_progress_vacuum.datid
• pg_stat_progress_vacuum.datname
• pg_stat_progress_vacuum.dead_tuple_bytes
• pg_stat_progress_vacuum.delay_time
• pg_stat_progress_vacuum.heap_blks_scanned
• pg_stat_progress_vacuum.heap_blks_total
• pg_stat_progress_vacuum.heap_blks_vacuumed
• pg_stat_progress_vacuum.index_vacuum_count
• pg_stat_progress_vacuum.indexes_processed
• pg_stat_progress_vacuum.indexes_total
• pg_stat_progress_vacuum.num_dead_item_ids
• pg_stat_progress_vacuum.phase