{"Entry":{"collection":"metric","key":"pg_stat_progress_vacuum-heap_blks_scanned","name":"pg_stat_progress_vacuum.heap_blks_scanned","aliases":["heap_blks_scanned","pg_stat_progress_vacuum"],"metadata":{"aliases":["heap_blks_scanned","pg_stat_progress_vacuum"],"category":"pg_stat_progress_vacuum","content_hash":"4dc2558b3a11ea1b003519ced3474de638ab7e9192c08c81b02dff662d373f30","derived_content_hash":"f5b99b53070f5f5aa13cc65bcad09fea4f744c1aac45b747db8d01f34321c8f2","imported_at":"2026-09-30T00:40:45.967856+08:00","name":"pg_stat_progress_vacuum.heap_blks_scanned","name_zh":"","slug":"pg_stat_progress_vacuum-heap_blks_scanned","summary":"Number of heap blocks scanned. Because the visibility map is used to optimize scans, some blocks will be skipped without inspection; skipped blocks are included in this total, so that this number will eventually become equal to heap_blks_total when the vacuum is complete. This counter only advances when the phase is scanning heap."}},"Definition":{"Collection":"metric","Key":"pg_stat_progress_vacuum-heap_blks_scanned","SourceDatabase":"center","Version":"18","SourceTable":"statistics_metric","SourceKey":"pg_stat_progress_vacuum-heap_blks_scanned","SourceRevision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","Facts":{"comparison_data":{"field":"heap_blks_scanned","sql_type":"bigint","units_mentioned":["blocks"],"view":"pg_stat_progress_vacuum"},"comparison_hash":"55ebf3eb71701700d4a2fcb1d1cc7ca0efebd7fe0ab3470f44f04a037a4eb1a4","description":["Number of heap blocks scanned. Because the visibility map is used to optimize scans, some blocks will be skipped without inspection; skipped blocks are included in this total, so that this number will eventually become equal to heap_blks_total when the vacuum is complete. This counter only advances when the phase is scanning heap."],"description_zh":"被扫描的堆块数量。由于可见性映射被用来优化扫描，一些块将被跳过而不做检查，被跳过的块会被包括在这个总数中，因此当清理完成时这个数字最终将会等于 heap_blks_total。仅当处于 scanning heap 阶段时这个计数器才会前进。","description_zh_html":"\u003cp\u003epg_stat_progress_vacuum.heap_blks_scanned 统计字段。\u003c/p\u003e\u003cdl\u003e\u003cdt\u003e视图\u003c/dt\u003e\u003cdd\u003e\u003ccode\u003epg_stat_progress_vacuum\u003c/code\u003e\u003c/dd\u003e\u003cdt\u003e字段\u003c/dt\u003e\u003cdd\u003e\u003ccode\u003eheap_blks_scanned\u003c/code\u003e\u003c/dd\u003e\u003cdt\u003eSQL 类型\u003c/dt\u003e\u003cdd\u003e\u003ccode\u003ebigint\u003c/code\u003e\u003c/dd\u003e\u003c/dl\u003e\u003ch3\u003e同版本中文手册定义\u003c/h3\u003e\u003cp\u003e被扫描的堆块数量。由于可见性映射被用来优化扫描，一些块将被跳过而不做检查，被跳过的块会被包括在这个总数中，因此当清理完成时这个数字最终将会等于 heap_blks_total。仅当处于 scanning heap 阶段时这个计数器才会前进。\u003c/p\u003e\u003cp\u003e\u003ca href=\"/zh/docs/18/progress-reporting.html#\"\u003e查看完整中文手册与上下文\u003c/a\u003e。\u003c/p\u003e","documented":true,"facts":[{"label":"View","value":"pg_stat_progress_vacuum"},{"label":"Field","value":"heap_blks_scanned"},{"label":"SQL type","value":"bigint"},{"label":"Units named in the field definition","value":"blocks"},{"label":"Reset observation","value":"No stats_reset field is documented for this view"}],"facts_zh":[{"label":"视图","value":"pg_stat_progress_vacuum"},{"label":"字段","value":"heap_blks_scanned"},{"label":"SQL 类型","value":"bigint"},{"label":"字段定义记载的单位","value":"blocks"},{"label":"重置条件","value":"手册未为此视图记载 stats_reset 字段"}],"field":"heap_blks_scanned","manual_html":"","manual_path":"/docs/18/progress-reporting.html","related":[{"label":"pg_stat_progress_vacuum columns","url":"/wiki/catalog/pg_stat_progress_vacuum/?v=18"},{"label":"Statistics collection and reset functions","url":"/docs/18/monitoring-stats.html"}],"release":{"channel":"stable","label":"18.6","major":"18","ref":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2","revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"},"sections":[{"paragraphs":["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."],"title":"View semantics"},{"paragraphs":["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."],"title":"Collection and reset context"},{"code":"SELECT heap_blks_scanned FROM pg_catalog.pg_stat_progress_vacuum;","paragraphs":["Example query; no execution result or measured value is asserted."],"title":"Inspect this field"}],"sections_zh":[{"paragraphs":["运行 VACUUM 时，pg_stat_progress_vacuum 视图会为当前执行清理的每个后端（包括 autovacuum 工作进程）提供一行。下列表格说明所报告的信息及其解读方式。VACUUM FULL 的进度通过 pg_stat_progress_cluster 报告，因为 VACUUM FULL 和 CLUSTER 都会重写表，而普通 VACUUM 只进行原地修改。见第 27.4.2 节。"],"title":"视图语义"},{"paragraphs":["重置范围和可见性请参阅下方同版本的统计信息收集与视图文档。不根据字段名称推断各字段的重置规则。"],"title":"采集与重置语义"},{"code":"SELECT heap_blks_scanned FROM pg_catalog.pg_stat_progress_vacuum;","paragraphs":["示例查询；不表示已执行，也不提供实测值。"],"title":"查看此字段"}],"signature":"SELECT heap_blks_scanned FROM pg_catalog.pg_stat_progress_vacuum;","source_only":false,"sources":[{"label":"PostgreSQL 18 English manual","path":"progress-reporting.html","sha256":"a1f46d2b670502bfe75f1cf5192050ef2ef68202a8f928c4915abea0f4f71ae6","url":"/docs/18/progress-reporting.html#PG-STAT-PROGRESS-VACUUM-VIEW"}],"sql_type":"bigint","tables":[],"tables_zh":[],"units_mentioned":["blocks"],"view":"pg_stat_progress_vacuum","zh_from":{"authored_translation":"source-derived-structured-summary","body_sha256":"e949701e11e1179b0516544c51c99abd2a7ca3bcd2924b498be2a3ed4a6d0d73","kind":"same-version-chinese-manual-with-source-derived-structured-summary","manual":{"anchor":"","build_id":107,"column":"heap_blks_scanned","extraction":"exact-catalog-field","locale":"zh-Hans","page_key":"progress-reporting.html","source_hash":"59d508f5be60d650bf0ed9ec10531162651c9eb030752aec3874544e10c879e2","source_revision":"unknown:rendered-translation-baseline","translation_revision":"git:b1b500221dbe5437cfca004d6b04d3f6e422765d;html-sha256:08e987a66af27b98444a8057c256314eafa13611a3fb9e888214fc436824244b","url":"/zh/docs/18/progress-reporting.html#","version":"18"},"runtime_rerun":false,"source_facts_revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}},"ManualEvidence":{"manual_path":"/docs/18/progress-reporting.html","release":{"channel":"stable","label":"18.6","major":"18","ref":"https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2","revision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"},"sources":[{"label":"PostgreSQL 18 English manual","path":"progress-reporting.html","sha256":"a1f46d2b670502bfe75f1cf5192050ef2ef68202a8f928c4915abea0f4f71ae6","url":"/docs/18/progress-reporting.html#PG-STAT-PROGRESS-VACUUM-VIEW"}]},"MeasuredEvidence":{}},"Text":{"Collection":"metric","Key":"pg_stat_progress_vacuum-heap_blks_scanned","SourceDatabase":"center","Version":"18","Locale":"en","Title":"pg_stat_progress_vacuum.heap_blks_scanned","Summary":"Number of heap blocks scanned. Because the visibility map is used to optimize scans, some blocks will be skipped without inspection; skipped blocks are included in this total, so that this number will eventually become equal to heap_blks_total when the vacuum is complete. This counter only advances when the phase is scanning heap.","BodyHTML":"\u003cp\u003eNumber of heap blocks scanned. Because the visibility map is used to optimize scans, some blocks will be skipped without inspection; skipped blocks are included in this total, so that this number will eventually become equal to heap_blks_total when the vacuum is complete. This counter only advances when the phase is scanning heap.\u003c/p\u003e","SourceRevision":"555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f","ContentHash":"8322d9c298f312199c203d5ea5765cbb9739bd4518e54bd941e1da7a4b59dfd7","Payload":{"description":["Number of heap blocks scanned. Because the visibility map is used to optimize scans, some blocks will be skipped without inspection; skipped blocks are included in this total, so that this number will eventually become equal to heap_blks_total when the vacuum is complete. This counter only advances when the phase is scanning heap."],"manual_html":"","related":[{"label":"pg_stat_progress_vacuum columns","url":"/wiki/catalog/pg_stat_progress_vacuum/?v=18"},{"label":"Statistics collection and reset functions","url":"/docs/18/monitoring-stats.html"}],"sections":[{"paragraphs":["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."],"title":"View semantics"},{"paragraphs":["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."],"title":"Collection and reset context"},{"code":"SELECT heap_blks_scanned FROM pg_catalog.pg_stat_progress_vacuum;","paragraphs":["Example query; no execution result or measured value is asserted."],"title":"Inspect this field"}],"tables":[]}},"RequestedLocale":"en","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}