PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

reindexdb

reindexdb — 重建一个 PostgreSQL 数据库的索引

Synopsis

reindexdb [connection-option...] [option...] [ -S | --schema schema ] ... [ -t | --table table ] ... [ -i | --index index ] ... [ -s | --system ] [ dbname | -a | --all ]

描述

reindexdb 是一个用于重建 PostgreSQL 数据库中索引的工具。

reindexdb 是 SQL 命令 REINDEX 的一个封装。通过这个工具重建索引与通过其他访问服务器的方法重建索引没有实质区别。

选项

reindexdb 接受下列命令行参数:

-a
--all

重建所有数据库的索引。

--concurrently

使用 CONCURRENTLY 选项。参见 REINDEX,其中详细解释了此选项的所有注意事项。

[-d] dbname
[--dbname=]dbname

在未使用 -a/--all 的情况下,指定要重建索引的数据库的名称。如果没有指定,将从环境变量 PGDATABASE 中读取数据库名。如果该变量也没有设置,则使用为连接指定的用户名。dbname 可以是一个 connection string。如果是这样,连接字符串参数将覆盖任何与之冲突的命令行选项。

-e
--echo

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

-i index
--index=index

只重建 index。可以通过书写多个 -i 开关来重建多个索引。

-j njobs
--jobs=njobs

通过同时运行 njobs 个命令来并行执行重建索引的命令。此选项也许能减少处理时间,但也会增加数据库服务器上的负载。

reindexdb 将会打开 njobs 个到数据库的连接,因此请确保你的 max_connections 设置足够高,以便容纳所有这些连接。

注意此选项与 --system 选项不兼容。

-q
--quiet

不显示进度消息。

-s
--system

只重建数据库的系统目录。

-S schema
--schema=schema

只重建 schema。可以通过书写多个 -S 开关来重建多个模式。

-t table
--table=table

只重建 table。可以通过书写多个 -t 开关来重建多个表。

--tablespace=tablespace

指定重建索引所使用的表空间。(此名称会被当作双引号括起的标识符来处理。)

-v
--verbose

在处理期间打印详细信息。

-V
--version

打印 reindexdb 的版本并退出。

-?
--help

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

reindexdb 还接受下列用于连接参数的命令行参数:

-h host
--host=host

指定服务器所在机器的主机名。如果值以斜杠开头,它将被用作 Unix 域套接字的目录。

-p port
--port=port

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

-U username
--username=username

用于连接的用户名。

-w
--no-password

从不发出密码提示。如果服务器要求密码认证,而密码无法通过 .pgpass 文件等其他途径获得,则连接尝试将会失败。此选项在没有人输入密码的批处理作业和脚本中很有用。

-W
--password

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

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

--maintenance-db=dbname

使用 -a/--all 时,将连接到此数据库以收集要重建索引的数据库的列表。如果未指定,将使用 postgres 数据库;如果该数据库不存在,则使用 template1。它可以是一个 connection string。如果是这样,连接字符串参数将覆盖任何与之冲突的命令行选项。此外,在连接到其他数据库时,除数据库名本身之外的连接字符串参数也会被重新使用。

环境

PGDATABASE
PGHOST
PGPORT
PGUSER

默认连接参数

PG_COLOR

指定是否在诊断消息中使用颜色。可能的取值是 always、auto 和 never。

与大多数其他 PostgreSQL 工具一样,此工具也使用 libpq 支持的环境变量(参见 Section 32.15)。

诊断

遇到困难时,请参见 REINDEX 和 psql 中对潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外,libpq 前端库所使用的任何默认连接设置和环境变量也都会生效。

示例

重建数据库 test 的索引:

$ reindexdb test

重建表 foo 和索引 bar(位于名为 abcd 的数据库中):

$ reindexdb --table=foo --index=bar abcd

另请参阅

REINDEX