↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

文档 / 系统目录 / 进度视图

PROGRESS REPORT进度视图

pg_stat_progress_basebackup

每个正在流式传输基础备份的 WAL 发送进程一行，显示当前进度。请参阅Section 27.4.5。

进度视图 引入 13 现存至 20 devel 1 次结构变更

类别
进度视图
关系 OID
12329
关系类型
v（视图）
字段数
6
引入版本
13
版本状态
当前稳定版
结构变更
1 次

PostgreSQL 18 手册 官方文档 源码定义

版本轨迹

相对 PostgreSQL 17 无变化。

每当像pg_basebackup这样的应用程序执行基础备份时， pg_stat_progress_basebackup视图将包含当前运行BASE_BACKUP复制命令和流式传输备份的每个WAL发送进程的一行。 下面的表描述了将要报告的信息，并提供了关于如何解释它的信息。

字段

PostgreSQL 18 的 6 个字段，按定义顺序排列。说明默认用本站手册的译文，没有译文的按英文原文显示。

字段 类型 说明
pid integer WAL 发送进程的进程 ID。
phase text 目前的处理阶段。 参见 Table 27.47。
backup_total bigint 将被流式传输的数据总量。该值在streaming database files阶段开始时进行估算并报告。 注意，这只是一个近似值，因为数据库可能会在streaming database files阶段期间发生变化，而 WAL 日志也可能在稍后的备份阶段被包含进来。 一旦流式传输的数据量超过了估计的总大小，该值始终与backup_streamed相同。 如果在pg_basebackup中禁用估算(也就是说，指定了--no-estimate-size选项)，这为NULL。
backup_streamed bigint 已流式传输的数据量。该计数器仅在streaming database files阶段或transferring wal files阶段递增。
tablespaces_total bigint 将要流式传输的表空间总数。
tablespaces_streamed bigint 已流式传输的表空间数量。此计数器仅在streaming database files阶段递增。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的字段表。

  1. PostgreSQL 19 ← 18 结构变更

    backup_type

    1 处描述更新
    • phase Current processing phase. See Table 27.48. Current processing phase. See Table 27.53.

  2. PostgreSQL 17 ← 16 仅描述更新

    1 处描述更新
    • phase Current processing phase. See Table 28.47. Current processing phase. See Table 27.48.

  3. PostgreSQL 16 ← 15 仅描述更新

    1 处描述更新
    • phase Current processing phase. See Table 28.45. Current processing phase. See Table 28.47.

  4. PostgreSQL 15 ← 14 仅描述更新

    1 处描述更新
    • phase Current processing phase. See Table 28.43. Current processing phase. See Table 28.45.

  5. PostgreSQL 14 ← 13 仅描述更新

    1 处描述更新
    • phase Current processing phase. See Table 27.41. Current processing phase. See Table 28.43.

  6. PostgreSQL 13 ← 12 新增此关系

    共 6 个字段

字段矩阵

每个字段在 8 个收录版本里的存在情况；方格指向该版的字段表。「有变」指类型、可空、隐式或数组维数与上一版不同。

存在 有变 已移除 不存在

字段 1314151617181920
pid 存在 存在 存在 存在 存在 存在 存在 存在
phase 存在 存在 存在 存在 存在 存在 存在 存在
backup_total 存在 存在 存在 存在 存在 存在 存在 存在
backup_streamed 存在 存在 存在 存在 存在 存在 存在 存在
tablespaces_total 存在 存在 存在 存在 存在 存在 存在 存在
tablespaces_streamed 存在 存在 存在 存在 存在 存在 存在 存在
backup_type 不存在 不存在 不存在 不存在 不存在 不存在 存在 存在

同类关系

关系 引入 字段 版本变动 最近变更
PROGRESS REPORT 进度视图 8 个 ↗
pg_stat_progress_analyze 13 14 192 次
每个正在运行ANALYZE的后端（包括自动清理工作进程）一行，显示当前进度。请参阅Section 27.4.1。 现存
pg_stat_progress_basebackup 13 7 191 次
每个正在流式传输基础备份的 WAL 发送进程一行，显示当前进度。请参阅Section 27.4.5。 现存
pg_stat_progress_cluster 12 12 —
每个正在运行CLUSTER或VACUUM FULL的后端一行，显示当前进度。请参阅Section 27.4.4。 现存
pg_stat_progress_copy 14 11 171 次
每个正在运行COPY的后端一行，显示当前进度。请参阅Section 27.4.6。 现存
pg_stat_progress_create_index 12 16 —
每个正在运行CREATE INDEX或REINDEX的后端一行，显示当前进度。请参阅Section 27.4.2。 现存
pg_stat_progress_data_checksums 19 10 —
启用或禁用数据校验和时，数据校验和启动器进程占一行。启用数据校验和时， 该视图还会为每个工作进程提供一行，显示当前进度。 详见Section 27.4.8。 现存
pg_stat_progress_repack 19 14 —
每个正在运行REPACK、CLUSTER或VACUUM FULL的后端一行，显示当前进度。请参阅Section 27.4.3。 现存
pg_stat_progress_vacuum 9.6 17 193 次
每个正在运行VACUUM的后端（包括自动清理工作进程）一行，显示当前进度。请参阅Section 27.4.3。 现存