自动清理

系统自动清理线程（autovacuum）自动执行VACUUM和ANALYZE命令，回收被标识为删除状态的记录空间，并更新表的统计数据。

autovacuum

参数说明：控制数据库自动清理线程（autovacuum）的启动。自动清理线程运行的前提是将track_counts设置为on。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

说明：

• 如果希望系统在故障恢复后，具备自动清理两阶段事务的功能，请将autovacuum设置为on;
• 当设置autovacuum为on，autovacuum_max_workers为0时，表示系统不会自动进行autovacuum，只会在故障恢复后，自动清理两阶段事务；
• 当设置autovacuum为on，autovacuum_max_workers大于0时，表示系统不仅在故障恢复后，自动清理两阶段事务，并且还可以自动清理线程。
• autovacuum/autoanalyze不处理临时表/全局临时表。

须知：

即使此参数设置为off，当事务ID回绕即将发生时，数据库也会自动启动自动清理线程。对于create/drop database发生异常时，可能有的节点提交或回滚，有的节点未提交（prepared状态），此时系统不能自动修复，需要手动修复。

取值范围：布尔型

• on表示开启数据库自动清理线程。
• off表示关闭数据库自动清理线程。

默认值：on

autovacuum_mode

参数说明：该参数仅在autovacuum设置为on的场景下生效，它控制autoanalyze或autovacuum的打开情况。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：枚举类型

• analyze表示只做autoanalyze。
• vacuum表示只做autovacuum。
• mix表示autoanalyze和autovacuum都做。
• none表示二者都不做。

默认值：mix

autoanalyze_timeout

参数说明：设置autoanalyze的超时时间。在对某张表做autoanalyze时，如果该表的analyze时长超过了autoanalyze_timeout，则自动取消该表此次analyze。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，0~2147483，单位是秒。

默认值：5min（即300s）

autovacuum_io_limits

参数说明：控制autovacuum线程每秒触发IO的上限。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。

默认值：-1

log_autovacuum_min_duration

参数说明：当自动清理的执行时间大于或者等于某个特定的值时，向服务器日志中记录本次自动清理执行的概要信息。设置此选项有助于追踪自动清理的行为。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

举例如下:

将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。其相关日志表现如下:

    automatic vacuum of table x: index scans: x
    pages: x removed, x remain
    tuples: x removed, x remain
    buffer usage: x hits, x misses, x dirtied
    avg read rate: x MiB/s, avg write rate: x MiB/s
    system usage: x

取值范围：整型，最小值为-1，最大值为2147483647，单位为毫秒。

• 当参数设置为0时，表示所有的自动清理的概要信息都记录到日志中。
• 当参数设置为-1时，表示所有的自动清理的概要信息都不记录到日志中。
• 当参数设置为非-1、非0时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。

默认值：-1

autovacuum_max_workers

参数说明：设置能同时运行的自动清理线程的最大数量，该参数的取值上限与GUC参数max_connections和job_queue_processes大小有关。

该参数属于POSTMASTER类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - max_connections的值 - job_queue_processes的值 - 辅助线程数 – autovacuum的lancher线程数 - 1”，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。

默认值：3

autovacuum_naptime

参数说明：设置两次自动清理操作的时间间隔。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，单位为s，最小值为1，最大值为2147483。

默认值：10min（即600s）

autovacuum_vacuum_threshold

参数说明：设置触发VACUUM的阈值。当表上被删除或更新的记录数超过设定的阈值时才会对这个表执行VACUUM操作。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，最小值为0，最大值为2147483647。

默认值：50

autovacuum_analyze_threshold

参数说明：设置触发ANALYZE操作的阈值。当表上被删除、插入或更新的记录数超过设定的阈值时才会对这个表执行ANALYZE操作。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，最小值为0，最大值为2147483647。

默认值：50

autovacuum_vacuum_scale_factor

参数说明：设置触发一个VACUUM时增加到autovacuum_vacuum_threshold的表大小的缩放系数。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：浮点型，0.0～100.0

默认值：0.2

autovacuum_analyze_scale_factor

参数说明：设置触发一个ANALYZE时增加到autovacuum_analyze_threshold的表大小的缩放系数。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：浮点型，0.0～100.0

默认值：0.1

autovacuum_freeze_max_age

参数说明：设置事务内的最大时间，使得表的pg_class.relfrozenxid字段在VACUUM操作执行之前被写入。

• VACUUM也可以删除pg_clog/子目录中的旧文件。
• 即使自动清理线程被禁止，系统也会调用自动清理线程来防止循环重复。

该参数属于POSTMASTER类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：长整型，100 000～576 460 752 303 423 487

默认值：4000000000

autovacuum_vacuum_cost_delay

参数说明：设置在自动VACUUM操作里使用的开销延迟数值。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。

默认值：20ms

autovacuum_vacuum_cost_limit

参数说明：设置在自动VACUUM操作里使用的开销限制数值。

该参数属于SIGHUP类型参数，请参考表GUC参数分类中对应设置方法进行设置。

取值范围：整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。

默认值：-1

defer_csn_cleanup_time

参数说明：用来指定本地回收时间间隔。

该参数属于SIGHUP类型参数，请参考GUC参数分类中对应设置方法进行设置。

取值范围：整型，0~INT_MAX，单位为毫秒（ms）。

默认值：5s（即5000ms）

handle_toast_in_autovac

参数说明：用来指定自动VACUUM操作里是否需要对toast表进行处理。

该参数属于SIGHUP类型参数，请参考GUC参数分类中对应设置方法进行设置。

取值范围：布尔型

• on表示开启自动VACUUM操作对toast表的处理。
• off表示关闭自动VACUUM操作对toast表的处理。

默认值：off

autovacuum_vacuum_insert_threshold

参数说明：设置只插入表触发autovacuum的阈值。当表中新插入的记录数超过设定的阈值时，会触发对该表的autovacuum。

该参数属于SIGHUP类型参数，请参考GUC参数分类中对应设置方法进行设置。

取值范围：整型，最小值-1，最大值2147483647，-1表示禁用对只插入表的autovacuum。

默认值：1000

其他说明：该参数的优先级低于CREATE TABLE和ALTER TABLE的存储参数autovacuum_vacuum_insert_threshold。

autovacuum_vacuum_insert_scale_factor

参数说明：设置只插入表触发autovacuum时增加到autovacuum_vacuum_insert_threshold的表大小的缩放系数。

该参数属于SIGHUP类型参数，请参考GUC参数分类中对应设置方法进行设置。

取值范围：浮点型，最小值0，最大值100。

默认值：0.2

其他说明：该参数的优先级低于CREATE TABLE和ALTER TABLE的存储参数autovacuum_vacuum_insert_scale_factor。

说明：

触发对只插入表的autovacuum的判断依据为：n_insert_since_vacuum > autovacuum_vacuum_insert_threshold + reltuples * autovacuum_vacuum_insert_scale_factor，其中，n_insert_since_vacuum表示上次autovacuum之后，新插入的记录数；reltuples表示表中总的记录数，取自pg_class中的reltuples字段，非实时更新。