pg_stat_progress_vacuum.dead_tuple_bytes

Description

Amount of dead tuple data collected since the last index vacuum cycle.

View

pg_stat_progress_vacuum

Field

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 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 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": "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.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.max_dead_tuple_bytes
• pg_stat_progress_vacuum.num_dead_item_ids
• pg_stat_progress_vacuum.phase