PostgreSQL具有在命令执行过程中报告某些命令进度的能力。
目前,支持进度报告的命令只有ANALYZE
,CLUSTER
,CREATE INDEX
, VACUUM
,COPY
,
和 BASE_BACKUP(例如 pg_basebackup 发出的进行基础备份的复制命令)。
未来可能还会扩展。
每当ANALYZE
运行时,pg_stat_progress_analyze
视图将包含当前运行该命令的每个后端的一行。
下面的表描述了将要报告的信息,并提供了关于如何解释它们的信息。
表 28.34. pg_stat_progress_analyze
视图
列类型 描述 |
---|
后端的进程ID。 |
后端连接到的数据库的OID。 |
后端连接到的数据库的名称。 |
被分析的表的OID。 |
当前处理阶段。参见 表 28.35。 |
将被采样的堆块的总数。 |
扫描的堆块数量。 |
扩展统计信息的数量。 |
已经计算的扩展统计的数量. 此计数器仅在 |
子表的数量。 |
扫描的子表数。此计数器只有在 |
当前正在扫描的子表的OID。此字段仅在 |
表 28.35. ANALYZE phases
阶段 | 描述 |
---|---|
initializing | 命令正在准备开始扫描堆。这个阶段预计会非常短暂。 |
acquiring sample rows |
该命令当前正在扫描relid 给出的表以获得示例行。
|
acquiring inherited sample rows |
该命令当前正在扫描子表以获得示例行。列child_tables_total ,child_tables_done ,
和current_child_table_relid 包含此阶段的进度信息。
|
computing statistics | 该命令从表扫描期间获得的样例行计算统计信息。 |
computing extended statistics | 该命令从表扫描期间获得的样例行计算扩展统计信息。 |
finalizing analyze |
该命令在更新pg_class 。当此阶段完成时,ANALYZE 将结束。
|
注意当在分区表上运行ANALYZE
时,它的所有分区也会被递归分析。
在这种情况下,首先报告父表的ANALYZE
进度,收集它的继承统计信息,然后是每个分区的(继承统计信息)。
每当运行CREATE INDEX
或REINDEX
时,pg_stat_progress_create_index
视图将包含当前正在创建索引的每个后端的一行。
下面的表描述了将要报告的信息,并提供了关于如何解释它的信息。
表 28.36. pg_stat_progress_create_index
视图
列类型 描述 |
---|
后端的进程ID。 |
后端连接到的数据库的OID。 |
后端连接到的数据库的名称。 |
正在创建索引的表的OID。 |
正在创建或重建索引的OID。在非并发 |
在运行的命令: |
索引创建的当前处理阶段。 参见 表 28.37。 |
在适用的情况下,需要等待的储物柜总数 |
已经等待的储物柜数量。 |
目前正在等待的储物柜的进程ID。 |
本阶段要处理的区块总数。 |
当前阶段已经处理的区块数量。 |
当前阶段要处理的元组总数。 |
在当前阶段已经处理的元组数量。 |
在分区表上创建索引时,该列被设置为要在其上创建索引的分区总数。
在 |
当在分区表上创建索引时,该列被设置为在其上建立索引的分区数。
在 |
表 28.37. CREATE INDEX 的阶段
阶段 | 描述 |
---|---|
初始化 |
CREATE INDEX 或REINDEX 正在准备创建索引。 这个阶段预计会非常短暂。
|
构建前等待读写器 |
CREATE INDEX CONCURRENTLY 或REINDEX CONCURRENTLY 正在等待有可能看到表的写锁的事务完成。 当不在并发模式时,这个阶段会被跳过。lockers_total 、 lockers_done 和 current_locker_pid 列包含了这个阶段的进度信息。
|
新建索引 |
索引是由访问方法专用代码建立的。 在这一阶段,支持进度报告的访问方法填写自己的进度数据,子阶段在这一栏中表示。 通常情况下,blocks_total 和blocks_done 将包含进度数据,也可能包含tuples_total 和tuples_done 。
|
在验证前等待读写器 |
CREATE INDEX CONCURRENTLY 或REINDEX CONCURRENTLY 正在等待有可能写入表的事务完成写锁的事务。当不在并发模式时,这个阶段会被跳过。lockers_total 、 lockers_done 和 current_locker_pid 列包含了这个阶段的进度信息。
|
索引验证:扫描索引 |
CREATE INDEX CONCURRENTLY 正在扫描索引,搜索需要验证的图元组。如果不是在并发模式下,这个阶段会被跳过。列 blocks_total (设置为索引的总大小)和 blocks_done 包含了这个阶段的进度信息。
|
指数验证:排序元组 |
CREATE INDEX CONCURRENTLY 正在对索引扫描阶段的输出进行排序。
|
索引验证:扫描表 |
CREATE INDEX CONCURRENTLY 正在扫描表,以验证前两个阶段收集的索引图元。当不在并发模式时,这个阶段被跳过。blocks_total 列(设置为表的总大小)和blocks_done 列包含这个阶段的进度信息。
|
等待旧照 |
CREATE INDEX CONCURRENTLY 或REINDEX CONCURRENTLY 正在等待可能看到表的事务释放快照。 当不处于并发模式时,这个阶段会被跳过。 lockers_total 、lockers_done 和 current_locker_pid 列包含了这个阶段的进度信息。
|
标记 dead之前等待readers |
REINDEX CONCURRENTLY 等待表上有读锁的事务完成后,再将旧索引标记为死索引。当不在并发模式时,这个阶段被跳过。lockers_total 、lockers_done 和 current_locker_pid 列包含了这个阶段的进度信息。
|
在 dropping之前等待readers |
REINDEX CONCURRENTLY 等待表上有读锁的事务完成后,再丢弃旧索引。当不在并发模式时,这个阶段被跳过。列 lockers_total 、lockers_done 和 current_locker_pid 包含了这个阶段的进度信息。
|
只要VACUUM
正在运行,每一个当前正在清理的后端(包括autovacuum工作者进程)在pg_stat_progress_vacuum
视图中都会有一行。下面的表描述了将被报告的信息并且提供了如何解释它们的信息。VACUUM FULL
命令的进度是通过pg_stat_progress_cluster
报告的,因为VACUUM FULL
和CLUSTER
都是重写表,而普通的VACUUM
只是原地修改表。见第 28.4.4 节.
表 28.38. pg_stat_progress_vacuum
视图
列类型 描述 |
---|
后端的进程ID。 |
这个后端连接的数据库的OID。 |
这个后端连接的数据库的名称。 |
被vacuum的表的OID。 |
vacuum的当前处理阶段。参见 表 28.39。 |
该表中堆块的总数。这个数字在扫描开始时报告,之后增加的块将不会(并且不需要)被这个 |
被扫描的堆块数量。由于visibility map被用来优化扫描,一些块将被跳过而不做检查,
被跳过的块会被包括在这个总数中,因此当清理完成时这个数字最终将会等于 |
被清理的堆块数量。除非表没有索引,这个计数器仅在处于 |
已完成的索引清理周期数。 |
在需要执行一个索引清理周期之前我们可以存储的死亡元组数,取决于maintenance_work_mem。 |
从上一个索引清理周期以来收集的死亡元组数。 |
表 28.39. VACUUM的阶段
阶段 | 描述 |
---|---|
初始化 |
VACUUM 正在准备开始扫描堆。这个阶段应该很简短。
|
扫描堆 |
VACUUM 正在扫描堆。如果需要,它将会对每个页面进行修建以及碎片整理,并且可能会执行冻结动作。heap_blks_scanned 列可以用来监控扫描的进度。
|
清理索引 |
VACUUM 当前正在清理索引。
如果一个表拥有索引,那么每次清理时这个阶段会在堆扫描完成后至少发生一次。
如果maintenance_work_mem不足以存放找到的死亡元组(或者, 在autovacuum情况下,如果设置了autovacuum_work_mem) ,则每次清理时会多次清理索引。
|
清理堆 |
VACUUM 当前正在清理堆。清理堆与扫描堆不是同一个概念,清理堆发生在每一次清理索引的实例之后。如果heap_blks_scanned 小于heap_blks_total ,系统将在这个阶段完成之后回去扫描堆;否则,系统将在这个阶段完成后开始清理索引。
|
清除索引 |
VACUUM 当前正在清除索引。这个阶段发生在堆被完全扫描并且对堆和索引的所有清理都已经完成以后。
|
截断堆 |
VACUUM 正在截断堆,以便把关系尾部的空页面返还给操作系统。这个阶段发生在清除完索引之后。
|
执行最后的清除 |
VACUUM 在执行最终的清除。在这个阶段中,VACUUM 将清理空闲空间映射、更新pg_class 中的统计信息并且将统计信息报告给统计收集器。当这个阶段完成时,VACUUM 也就结束了。
|
每当CLUSTER
或VACUUM FULL
运行时,pg_stat_progress_cluster
视图将包含当前正在运行的每一个后台的记录。下面的表格描述了将被报告的信息,并提供了关于如何解释这些信息的信息。
表 28.40. pg_stat_progress_cluster
视图
列类型 描述 |
---|
后台的进程ID。 |
该后端连接的数据库的OID。 |
与此后端连接的数据库的名称。 |
被集群的表的OID。 |
正在运行的命令。 |
当前处理阶段。参见表 28.41。 |
如果正在使用索引对表进行扫描,这就是正在使用的索引的OID;否则为0。 |
扫描的堆元组数。
这个计数器只有在阶段为 |
写入的堆元组的数量。这个计数器只有在阶段为 |
表中的堆块总数。 这个数字是在 |
扫描的堆块数量。 这个计数器只有在阶段为 |
重建的索引数。 该计数器仅在 |
表 28.41. CLUSTER 和 VACUUM FULL 阶段
阶段 | 描述 |
---|---|
初始化 | 该命令准备开始扫描堆栈。 这个阶段预计会非常短暂。 |
seq扫描堆 | 该命令目前采用顺序扫描的方式对表进行扫描。 |
索引扫描堆 |
CLUSTER 目前正在使用索引扫描表。
|
元组排序 |
CLUSTER 目前正在对元组进行排序。
|
新写入堆 |
CLUSTER 目前正在编写新的堆。
|
交换关系文件 | 目前,该命令正在将新建立的文件调换到位。 |
重建索引 | 该命令目前正在重建一个索引。 |
清理 |
该命令正在执行最后的清理工作。 当此阶段完成后,CLUSTER 或VACUUM FULL 将结束。
|
每当像pg_basebackup这样的应用程序进行基本备份时,
pg_stat_progress_basebackup
视图将包含当前运行BASE_BACKUP
复制命令和流备份的每个WAL发送进程的一行。
下面的表描述了将要报告的信息,并提供了关于如何解释它的信息。
表 28.42. pg_stat_progress_basebackup
视图
列类型 描述 |
---|
WAL发送方进程ID。 |
目前的处理阶段。 参见 表 28.43。 |
将被流输送的数据总量。这是在 |
数据流的总量。这个计数器只在 |
要流输送的表空间总数。 |
流输送的表空间数。此计数器仅在 |
表 28.43. 基础备份阶段
阶段 | 描述 |
---|---|
initializing | WAL发送器进程正在准备开始备份。这个阶段预计会非常短暂。 |
waiting for checkpoint to finish |
WAL发送器进程目前正在执行pg_start_backup 以准备进行基础备份,并等待启动备份检查点完成。
|
estimating backup size | WAL发送程序目前正在估计将作为基础备份流传输的数据库文件的总量。 |
streaming database files | WAL发送器当前正在流数据库文件作为基础备份。 |
waiting for wal archiving to finish |
WAL发送方进程目前正在执行pg_stop_backup 以完成备份,并等待基础备份所需的所有WAL文件成功存档。
如果在pg_basebackup中指定了--wal-method=none 或--wal-method=stream ,则备份将在此阶段完成后结束。
|
transferring wal files |
WAL发送器进程正在传输备份过程中产生的所有WAL日志。
如果pg_basebackup中指定了--wal-method=fetch ,
则该阶段发生在waiting for wal archiving to finish 阶段之后。当此阶段完成时备份将结束。
|
当COPY
正在运行时,pg_stat_progress_copy
视图将包含一行,为了当前正在运行COPY
命令的每个后端。
下表描述了将被报告的信息,并提供了如何解释它的信息。
表 28.44. pg_stat_progress_copy
View
列类型 描述 |
---|
后端的进程ID。 |
此后端所连接的数据库的OID。 |
此后端所连接的数据库的名称。 |
执行 |
正在运行的命令: |
数据被读取或写入的io类型: |
已经被 |
|
已经被 |
没有处理的元组数,因为它们被 |