reindexdb

reindexdb —重新索引 PostgreSQL 数据库

Synopsis

reindexdb [ connection-option ...] [ option ...] [ --schema | -S schema ] ... [ --table | -t table ] ... [ --index | -i index ] ... [ dbname ]

reindexdb [ connection-option ...] [ option ...] --all | -a

reindexdb [ connection-option ...] [ option ...] --system | -s [ dbname ]

Description

reindexdb 是用于在 PostgreSQL 数据库中重建索引的 Util。

reindexdb 是 SQL 命令REINDEX的包装。通过此 Util 和通过其他访问服务器的方法为数据库重新索引之间没有有效的区别。

Options

reindexdb 接受以下命令行参数:

  • -a
    --all

    • 重新索引所有数据库。
  • [-d] dbname
    [--dbname=]dbname

    • 指定要重新构建索引的数据库的名称。如果未指定此参数并且未使用-a(或--all),则将从环境变量PGDATABASE中读取数据库名称。如果未设置,则使用为连接指定的用户名。
  • -e
    --echo

    • 回显 reindexdb 生成并发送到服务器的命令。
  • -i index
    --index=index

    • 仅重新创建* index *。可以通过写入多个-i开关来重新创建多个索引。
  • -q
    --quiet

    • 不显示进度消息。
  • -s
    --system

    • 重新索引数据库的系统目录。
  • -S schema
    --schema=schema

    • 仅重新索引* schema *。可以通过编写多个-S开关来为多个架构重新编制索引。
  • -t table
    --table=table

    • 仅重新索引* table *。可以通过写入多个-t开关来重新索引多个表。
  • -v
    --verbose

    • 在处理过程中打印详细信息。
  • -V
    --version

    • 打印 reindexdb 版本并退出。
  • -?
    --help

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

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

  • -h host
    --host=host

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

    • 指定服务器正在侦听连接的 TCP 端口或本地 Unix 域套接字文件 extensions。
  • -U username
    --username=username

    • 连接的用户名。
  • -w
    --no-password

    • 切勿发出密码提示。如果服务器要求密码验证,而其他方式(例如.pgpass文件)无法使用密码,则连接尝试将失败。该选项在没有用户 Importing 密码的批处理作业和脚本中很有用。
  • -W
    --password

    • 强制 reindexdb 在连接数据库之前提示 Importing 密码。

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

  • --maintenance-db=dbname

    • 指定要连接以发现应重新索引哪些其他数据库的数据库的名称。如果未指定,将使用postgres数据库,如果不存在,将使用template1

Environment

  • PGDATABASE
    PGHOST
    PGPORT
    PGUSER

    • 默认连接参数

与大多数其他 PostgreSQLUtil 一样,该 Util 也使用 libpq 支持的环境变量(请参见Section 34.14)。

Diagnostics

万一遇到困难,请参见REINDEXpsql以获取有关潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。同样,libpq 前端库使用的任何默认连接设置和环境变量都将适用。

Notes

reindexdb 可能需要多次连接到 PostgreSQL 服务器,每次都要求 Importing 密码。在这种情况下,拥有~/.pgpass文件很方便。有关更多信息,请参见Section 34.15

Examples

重新索引数据库test

$ reindexdb test

要在名为abcd的数据库中为表foo和索引bar重新编制索引:

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

See Also

REINDEX