reindexdb — 重建一个PostgreSQL数据库中的索引
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可以是一个连接字符串。 如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。
-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。 这可以是一个连接字符串。 如果是这样,连接字符串参数将覆盖任何冲突的命令行选项。 此外,除数据库名称本身以外的连接字符串参数,在连接到其他数据库时也会被重复使用。
与大多数其他PostgreSQL工具一样,该工具也使用libpq支持的环境变量(见Section 32.15)。
要重建数据库test中的索引:
$reindexdb test
要重建名为abcd的数据库中表foo的索引和索引bar:
$reindexdb --table=foo --index=bar abcd
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。