pg_stat_progress_cluster.heap_blks_total

Description

Total number of heap blocks in the table. This number is reported as of the beginning of seq scanning heap.

View

pg_stat_progress_cluster

Field

heap_blks_total

SQL type

bigint

Units named in the field definition

blocks

Reset observation

No stats_reset field is documented for this view

Usage

SELECT heap_blks_total FROM pg_catalog.pg_stat_progress_cluster;

View semantics

Whenever CLUSTER or VACUUM FULL is running, the pg_stat_progress_cluster view will contain a row for each backend that is currently running either command. The tables below describe the information that will be reported and provide information about how to interpret it.

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 heap_blks_total FROM pg_catalog.pg_stat_progress_cluster;

Related entries

• pg_stat_progress_cluster columns
• Statistics collection and reset functions

Documentation and source

• PostgreSQL 18 English manual

Compare versions

PostgreSQL 11 → 12: added.

--- PostgreSQL 11
+++ PostgreSQL 12
@@ -1 +1,8 @@
-Not recorded in this version
+{
+  "field": "heap_blks_total",
+  "sql_type": "bigint",
+  "units_mentioned": [
+    "blocks"
+  ],
+  "view": "pg_stat_progress_cluster"
+}

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_cluster.cluster_index_relid
• pg_stat_progress_cluster.command
• pg_stat_progress_cluster.datid
• pg_stat_progress_cluster.datname
• pg_stat_progress_cluster.heap_blks_scanned
• pg_stat_progress_cluster.heap_tuples_scanned
• pg_stat_progress_cluster.heap_tuples_written
• pg_stat_progress_cluster.index_rebuild_count
• pg_stat_progress_cluster.phase
• pg_stat_progress_cluster.pid
• pg_stat_progress_cluster.relid