reindexdb
reindexdb — 重建一个 PostgreSQL 数据库中的索引
大纲
reindexdb [connection-option...] [option...]
[
-S | --schema
schema
]
...
[
-t | --table
table
]
...
[
-i | --index
index
]
... [dbname]
reindexdb [connection-option...] [option...] -a | --all
reindexdb [connection-option...] [option...] -s | --system [dbname]
描述
reindexdb 是用于重建 PostgreSQL 数据库中索引的工具。
reindexdb 是 SQL 命令 REINDEX 的一个包装器。通过该工具重建索引与通过其他方法访问服务器来重建索引,在效果上没有区别。
选项
reindexdb 接受下列命令行参数:
-a--all#重建所有数据库的索引。
--concurrently#使用
CONCURRENTLY选项。参见 REINDEX,其中详细解释了该选项的所有注意事项。[-d]dbname[--dbname=]#dbname在未使用
-a/--all时,指定要重建索引的数据库名称。如果未指定该选项,则从环境变量PGDATABASE中读取数据库名称。如果该变量未设置,则使用为连接指定的用户名。dbname可以是一个连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。-e--echo#回显 reindexdb 生成并发送给服务器的命令。
-iindex--index=#index只重建
index。可以通过写多个-i开关来重建多个索引。-jnjobs--jobs=#njobs通过同时运行
njobs个命令来并行执行重建索引命令。此选项可能缩短处理时间,但也会增加数据库服务器上的负载。reindexdb 将打开
njobs个到数据库的连接,因此请确保 max_connections 设置足够高,能容纳所有连接。注意,该选项与
--index和--system选项不兼容。-q--quiet#不显示进度消息。
-s--system#仅重建数据库的系统目录上的索引。
-Sschema--schema=#schema只重建
schema中的索引。可以通过写多个-S开关来重建多个模式中的索引。-ttable--table=#table只重建
table上的索引。可以通过写多个-t开关来重建多个表上的索引。--tablespace=#tablespace指定重建索引所在的表空间。(该名称会按双引号标识符处理。)
-v--verbose#在处理过程中打印详细信息。
-V--version#打印 reindexdb 的版本并退出。
-?--help#显示关于 reindexdb 命令行参数的帮助信息,并退出。
reindexdb 也接受下列命令行参数作为连接参数:
-hhost--host=#host指定服务器所在机器的主机名。如果该值以斜杠开头,则它将被用作 Unix 域套接字的目录。
-pport--port=#port指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。
-Uusername--username=#username连接时所使用的用户名。
-w--no-password#永远不发出密码提示。如果服务器要求密码认证,而又无法通过其他方式获取密码,例如通过
.pgpass文件,则连接尝试会失败。此选项可用于没有用户可输入密码的批处理作业和脚本。-W--password#强制 reindexdb 在连接数据库前提示输入密码。
该选项并非必需,因为如果服务器要求密码认证,reindexdb 会自动提示输入密码。不过,reindexdb 会先浪费一次连接尝试来确认服务器需要密码。在某些场景下,值得使用
-W,以避免这次额外的连接尝试。--maintenance-db=#dbname当使用
-a/--all时,连接到该数据库以收集要重建索引的数据库列表。如果未指定,则使用postgres数据库;如果它不存在,则使用template1。这可以是一个连接字符串。如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。此外,除数据库名称本身以外的连接字符串参数,在连接到其他数据库时也会被重复使用。
环境
与大多数其他 PostgreSQL 工具一样,此工具也使用 libpq 支持的环境变量(见第 34.15 节)。
注解
reindexdb 可能需要多次连接到 PostgreSQL 服务器,每次都要求输入密码。在这种情况下,使用 ~/.pgpass 文件会很方便。更多信息见第 34.16 节。
示例
要重建数据库 test 中的索引:
$reindexdb test
要重建名为 abcd 的数据库中表 foo 的索引和索引 bar:
$reindexdb --table=foo --index=bar abcd
另见
REINDEX报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.