# 真空数据库

Vacuumdb — 垃圾收集和分析 PostgreSQL 数据库

# 概要

真空数据库 [连接选项...][option...][-t|- 桌子 桌子[(柱子 [……,...])] ] ...[数据库名称]

真空数据库 [连接选项...][option...] -一种|- 全部

# 描述

vacuumdb 是一个用于清理 PostgreSQL 数据库的实用程序。vacuumdb 还将生成 PostgreSQL 查询优化器使用的内部统计信息。

vacuumdb 是 SQL 命令的包装器真空.通过此实用程序和通过其他访问服务器的方法清理和分析数据库之间没有有效的区别。

# 选项

vacuumdb 接受以下命令行参数:

-一种
- 全部

清空所有数据库。

[-d] *数据库名称*
[--dbname=]*数据库名称*

指定要清理或分析的数据库的名称,当-一种/- 全部未使用。如果未指定,则从环境变量中读取数据库名称PG数据库.如果未设置,则使用为连接指定的用户名。这*数据库名称*可以是一个连接字符串.如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。

--禁用页面跳过

根据可见性地图的内容禁用跳过页面。

# 笔记

此选项仅适用于运行 PostgreSQL 9.6 及更高版本的服务器。

-e
- 回声

回显vacuumdb 生成并发送到服务器的命令。

-f
- 满的

执行“完全”吸尘。

-F
- 冻结

积极地“冻结”元组。

--force-index-cleanup

始终删除指向死元组的索引条目。

# 笔记

此选项仅适用于运行 PostgreSQL 12 及更高版本的服务器。

-j *njobs*
--工作=*njobs*

通过运行并行执行真空或分析命令*njobs*同时命令。此选项可能会减少处理时间,但也会增加数据库服务器的负载。

真空数据库将打开*njobs*与数据库的连接,因此请确保您的最大限度_连接设置足够高以容纳所有连接。

请注意,将此模式与-f(满的) 如果并行处理某些系统目录,选项可能会导致死锁失败。

--min-mxid-年龄 *mxid_age*

仅对 multixact ID 年龄至少为的表执行真空或分析命令*mxid_age*.此设置对于确定要处理的表的优先级以防止 multixact ID 回绕很有用(请参阅第 25.1.5.1 节)。

出于此选项的目的,关系的 multixact ID 年龄是主关系及其关联 TOAST 表(如果存在)的最大年龄。由于vacuumdb发出的命令在必要时也会处理关系的TOAST表,所以不需要单独考虑。

# 笔记

此选项仅适用于运行 PostgreSQL 9.6 及更高版本的服务器。

--min-xid-年龄 *xid_age*

仅对事务 ID 年龄至少为的表执行真空或分析命令*xid_age*.此设置对于确定要处理的表的优先级以防止事务 ID 回绕很有用(请参阅第 25.1.5 节)。

对于此选项,关系的事务 ID 年龄是主关系及其关联 TOAST 表(如果存在)的最大年龄。由于vacuumdb发出的命令在必要时也会处理关系的TOAST表,所以不需要单独考虑。

# 笔记

此选项仅适用于运行 PostgreSQL 9.6 及更高版本的服务器。

--no-index-cleanup

不要删除指向死元组的索引条目。

# 笔记

此选项仅适用于运行 PostgreSQL 12 及更高版本的服务器。

--no-process-toast

跳过与要清理的表关联的 TOAST 表(如果有)。

# 笔记

此选项仅适用于运行 PostgreSQL 14 及更高版本的服务器。

--不截断

不要截断表格末尾的空页。

# 笔记

此选项仅适用于运行 PostgreSQL 12 及更高版本的服务器。

-P *并行工作者*
--并行=*并行工作者*

指定并行工作者的数量平行真空.这允许真空利用多个 CPU 来处理索引。看真空.

# 笔记

此选项仅适用于运行 PostgreSQL 13 及更高版本的服务器。

-q
- 安静的

不显示进度消息。

--skip-locked

跳过无法立即锁定以进行处理的关系。

# 笔记

此选项仅适用于运行 PostgreSQL 12 及更高版本的服务器。

-t *桌子* [ (*柱子* [,...]) ]
--表=*桌子* [ (*柱子* [,...]) ]

清理或分析*桌子*只要。列名只能与- 分析要么--仅分析选项。可以通过写多个来清理多个表-t开关。

# 提示

如果指定列,则可能必须从 shell 中转义括号。(见下面的例子。)

-v
--详细

在处理过程中打印详细信息。

-V
- 版本

打印vacuumdb版本并退出。

-z
- 分析

还要计算供优化器使用的统计信息。

-Z
--仅分析

仅计算供优化器使用的统计信息(无真空)。

--分阶段分析

仅计算供优化器使用的统计信息(无真空),例如--仅分析.使用不同的配置设置运行几个(当前三个)分析阶段,以更快地生成可用的统计数据。

此选项对于分析从恢复的转储中新填充的数据库或通过pg_upgrade.此选项将尝试尽可能快地创建一些统计信息,以使数据库可用,然后在后续阶段生成完整的统​​计信息。

-?
- 帮助

显示有关 Vacuumdb 命令行参数的帮助,然后退出。

vacuumdb 还接受以下命令行参数作为连接参数:

-h *主持人*
--主机=*主持人*

指定运行服务器的机器的主机名。如果该值以斜杠开头,则将其用作 Unix 域套接字的目录。

-p *港口*
--端口=*港口*

指定服务器正在侦听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。

-U *用户名*
--用户名=*用户名*

要连接的用户名。

-w
--无密码

永远不要发出密码提示。如果服务器需要密码验证,而密码无法通过其他方式获得,例如.pgpass文件,连接尝试将失败。此选项在没有用户输入密码的批处理作业和脚本中很有用。

-W
- 密码

强制vacuumdb 在连接到数据库之前提示输入密码。

这个选项从来都不是必需的,因为如果服务器要求密码验证,vacuumdb 会自动提示输入密码。但是,vacuumdb 会浪费一次连接尝试来发现服务器需要密码。在某些情况下,值得输入-W以避免额外的连接尝试。

--维护数据库=*数据库名称*

指定要连接的数据库的名称,以发现应该清理哪些数据库,何时-一种/- 全部用来。如果未指定,则postgres将使用数据库,或者如果该数据库不存在,模板1将会被使用。这可以是一个连接字符串.如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。此外,在连接到其他数据库时,将重新使用数据库名称本身以外的连接字符串参数。

# 环境

PG数据库
PGHOST
PGPORT
PG用户

默认连接参数

PG_COLOR

指定是否在诊断消息中使用颜色。可能的值为总是,汽车绝不.

与大多数其他 PostgreSQL 实用程序一样,此实用程序也使用 libpq 支持的环境变量(请参阅第 34.15 节)。

# 诊断

如有困难,请参阅真空psql用于讨论潜在问题和错误消息。数据库服务器必须在目标主机上运行。此外,libpq 前端库使用的任何默认连接设置和环境变量都将适用。

# 笔记

vacuumdb 可能需要多次连接到 PostgreSQL 服务器,每次都要求输入密码。有一个很方便~/.pgpass在这种情况下归档。看第 34.16 节了解更多信息。

# 例子

清理数据库测试

$ vacuumdb test

为优化器清理和分析名为大数据库

$ vacuumdb --analyze bigdb

清理单个表在一个名为xyzzy,并分析单个列酒吧优化器的表:

$ vacuumdb --analyze --verbose --table='foo(bar)' xyzzy

# 也可以看看

真空