是否存在适用于通用查询的pg_stat_progress_vacuum等效工具？

API 探路者

2026-6-23

针对通用查询的进度跟踪工具（类似pg_stat_progress_vacuum()）

PostgreSQL 没有像 pg_stat_progress_vacuum() 那样专门针对所有通用查询的内置进度跟踪工具，但针对你提到的顺序扫描（seq_scan）场景，有几种可行的方式来估算执行进度：

利用系统视图结合统计信息估算
1. 先通过 pg_stat_activity 定位目标查询的进程ID（pid），确认它正在扫描的表名：
```
SELECT pid, query, relname FROM pg_stat_activity JOIN pg_class ON query LIKE '%' || relname || '%' WHERE state = 'active';
```
2. 获取目标表的总行数（近似值）：
```
SELECT reltuples AS total_rows FROM pg_class WHERE relname = 'your_target_table';
```
3. 若需要实时估算已扫描行数，可以在查询开始前记录 pg_stat_user_tables 中该表的 seq_tup_read 值，查询执行中再次查询该值，两者的差值即为当前已扫描行数，用这个差值除以总行数就能得到大致进度。
借助第三方扩展
- pg_stat_monitor：这个扩展可以更细致地跟踪查询执行的各个阶段，包括顺序扫描的I/O耗时、已处理行数等指标，能辅助你更精准地判断进度。
- auto_explain：虽然无法实时查看进度，但它会记录查询的执行计划和各阶段耗时，能帮你优化查询，或为后续同类查询的进度估算提供参考依据。

手动添加进度逻辑（自定义查询场景）
如果是你自己编写的大表顺序扫描查询，可以拆分查询为批次执行，每完成一批就通过 RAISE NOTICE 输出当前进度。例如：

DO $$
DECLARE
    total_rows BIGINT;
    batch_size INT := 10000;
    processed_rows BIGINT := 0;
BEGIN
    SELECT reltuples INTO total_rows FROM pg_class WHERE relname = 'your_target_table';
    WHILE processed_rows < total_rows LOOP
        -- 执行批次扫描逻辑
        SELECT * FROM your_target_table LIMIT batch_size OFFSET processed_rows;
        processed_rows := processed_rows + batch_size;
        RAISE NOTICE 'Progress: %/% (%.2f%%)', processed_rows, total_rows, (processed_rows::FLOAT / total_rows) * 100;
    END LOOP;
END $$;

需要说明的是，PostgreSQL 核心中没有通用查询进度跟踪的原因是不同查询的执行计划差异极大，很难统一划分阶段和统计进度。但针对顺序扫描这类操作，上述方法足以满足基本的进度监控需求。

内容的提问来源于stack exchange，提问作者yeger