vacuumdb — 对一个PostgreSQL数据库进行垃圾收集和分析
vacuumdb [connection-option...] [option...]
[
-t | --table
table
[( column [,...] )]
]
... [dbname]
vacuumdb [connection-option...] [option...] -a | --all
vacuumdb是用于清理一个PostgreSQL数据库的工具。vacuumdb也将产生由PostgreSQL查询优化器所使用的内部统计信息。
vacuumdb是 SQL 命令VACUUM的一个包装器。
在通过这个工具和其他方法访问服务器来清理和分析数据库之间没有实质性的区别。
vacuumdb接受以下命令行参数:
-a--all清空所有数据库。
[-d] dbname[--dbname=]dbname
指定要清理或分析的数据库名称，当未使用-a/--all时。
如果未指定，则从环境变量PGDATABASE中读取数据库名称。
如果未设置该变量，则使用连接指定的用户名。
dbname可以是一个连接字符串。
如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。
--disable-page-skipping禁用根据可见性图内容跳过页面。
该选项仅适用于运行PostgreSQL 9.6及更高版本的服务器。
-e--echo回显vacuumdb生成并发送到服务器的命令。
-f--full执行“完全”清洁。
-F--freeze“Aggressively”冻结元组。
--force-index-cleanup始终删除指向无效元组的索引条目。
该选项仅适用于运行PostgreSQL 12及更高版本的服务器。
-j njobs--jobs=njobs
并行运行njobs命令来执行vacuum或analyze命令。
这个选项可能会减少处理时间，但也会增加数据库服务器的负载。
vacuumdb将打开njobs个连接到数据库，
因此请确保您的max_connections设置足够高，以容纳所有连接。
请注意，如果将此模式与-f（FULL）选项一起使用，
在处理某些系统目录时可能会导致死锁故障。
--min-mxid-age mxid_age
只对具有至少mxid_age的多重事务ID年龄的表执行vacuum或analyze命令。
此设置对于优先处理表格以防止多重事务ID环绕（参见第 25.1.5.1 节）非常有用。
对于此选项，关系的多重事务ID年龄是主关系及其关联的TOAST表的年龄中的最大值，如果存在的话。 由于vacuumdb发出的命令也将在必要时处理关系的TOAST表，因此不需要单独考虑。
该选项仅适用于运行PostgreSQL 9.6及更高版本的服务器。
--min-xid-age xid_age
只对事务ID年龄至少为xid_age的表执行vacuum或analyze命令。
这个设置对于优先处理表格以防止事务ID环绕很有用（参见第 25.1.5 节）。
对于此选项而言，关系的事务ID年龄是主关系及其关联的TOAST表的年龄中的最大值，如果存在的话。 由于vacuumdb发出的命令也会在必要时处理关系的TOAST表，因此不需要单独考虑。
该选项仅适用于运行PostgreSQL 9.6及更高版本的服务器。
--no-index-cleanup不要删除指向无效元组的索引条目。
该选项仅适用于运行PostgreSQL 12及更高版本的服务器。
--no-process-toast跳过与要清理的表相关联的TOAST表，如果有的话。
该选项仅适用于运行PostgreSQL 14及更高版本的服务器。
--no-truncate不要在表格末尾截断空白页。
该选项仅适用于运行PostgreSQL 12及更高版本的服务器。
-P parallel_workers--parallel=parallel_workers指定并行清理的并行工作者数量。 这允许清理利用多个CPU来处理索引。 参见VACUUM。
此选项仅适用于运行PostgreSQL 13及更高版本的服务器。
-q--quiet不显示进度消息。
--skip-locked跳过无法立即锁定进行处理的关系。
该选项仅适用于运行PostgreSQL 12及更高版本的服务器。
-t table [ (column [,...]) ]--table=table [ (column [,...]) ]
仅清理或分析表。
列名只能与--analyze或--analyze-only选项一起指定。
通过写多个-t开关，可以对多个表进行清理。
如果您指定了列，可能需要从shell中转义括号。(请参见下面的示例。)
-v--verbose在处理过程中打印详细信息。
-V--version打印vacuumdb的版本并退出。
-z--analyze也计算用于优化器的统计信息。
-Z--analyze-only仅为优化器计算统计信息（不执行vacuum）。
--analyze-in-stages
仅为优化器计算统计信息（不执行vacuum），类似于--analyze-only。
运行三个分析阶段；第一个阶段使用最低可能的统计目标（参见default_statistics_target）
更快地生成可用的统计信息，随后的阶段构建完整的统计信息。
此选项仅在分析当前没有统计信息或完全不正确的数据库时才有用，例如如果它是从恢复的转储文件或通过pg_upgrade新填充的。
请注意，在具有现有统计信息的数据库中运行此选项可能会导致查询优化器选择在早期阶段的低统计目标下变得短暂更差。
-?--help显示关于vacuumdb命令行参数的帮助信息，并退出。
vacuumdb也接受下列命令行参数用于连接参数：
-h host--host=host指定运行服务器的机器的主机名。如果该值以一个斜线开始，它被用作 Unix 域套接字的目录。
-p port--port=port指定服务器正在监听连接的 TCP 端口或本地 Unix 域套接字文件扩展。
-U username--username=username要作为哪个用户连接。
-w--no-password
从不发出一个口令提示。如果服务器要求口令认证并且没有其他方式提供口令（例如一个.pgpass文件），那儿连接尝试将失败。这个选项对于批处理任务和脚本有用，因为在其中没有一个用户来输入口令。
-W--password强制vacuumdb在连接到一个数据库之前提示要求一个口令。
这个选项不是必不可少的，因为如果服务器要求口令认证，vacuumdb将自动提示要求一个口令。但是，vacuumdb将浪费一次连接尝试来发现服务器想要一个口令。在某些情况下值得用-W来避免额外的连接尝试。
--maintenance-db=dbname
当使用-a/--all时，指定要连接到的数据库名称以发现应该清理的数据库。
如果未指定，将使用postgres数据库，如果不存在，将使用template1。
这可以是connection string。
如果是这样，连接字符串参数将覆盖任何冲突的命令行选项。
此外，在连接到其他数据库时，将重新使用除数据库名称本身之外的连接字符串参数。
PGDATABASEPGHOSTPGPORTPGUSER默认连接参数
PG_COLOR
规定在诊断消息中是否使用颜色。可能的值为always、 auto和never。
和大部分其他PostgreSQL工具相似，这个工具也使用libpq（见第 34.15 节）支持的环境变量。
vacuumdb可能需要多次连接到PostgreSQL服务器，每次都询问一个口令。在这种情况下有一个~/.pgpass文件会很方便。详见第 34.16 节。
要清理数据库test：
$vacuumdb test
要清理和为优化器分析一个名为bigdb的数据库：
$vacuumdb --analyze bigdb
要清理在名为xyzzy的数据库中的一个表foo，并且为优化器分析该表的bar列：
$vacuumdb --analyze --verbose --table='foo(bar)' xyzzy