↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1
历史版本PostgreSQL 11 已于 2023 年 11 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

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

重建所有数据库的索引。

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

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

-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 域套接字文件扩展名。

-U username
--username=username

要作为其身份连接的用户名。

-w
--no-password

永远不发出密码提示。如果服务器要求密码认证,而又无法通过其他方式获取密码,例如通过.pgpass 文件,则连接尝试会失败。此选项可用于没有用户可输入密码的批处理作业和脚本。

-W
--password

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

该选项并非必需,因为如果服务器要求密码认证,reindexdb 会自动提示输入密码。不过,reindexdb 会先浪费一次连接尝试来确认服务器需要密码。在某些场景下,值得使用 -W,以避免这次额外的连接尝试。

--maintenance-db=dbname

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

环境

PGDATABASE
PGHOST
PGPORT
PGUSER

默认连接参数

与大多数其他 PostgreSQL 工具一样,该工具也使用 libpq 支持的环境变量(见第 34.14 节)。

诊断

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

注解

reindexdb 可能需要多次连接到 PostgreSQL 服务器,每次都要求输入密码。在这种情况下,使用 ~/.pgpass 文件会很方便。更多信息见第 34.15 节。

示例

要重建数据库 test 中的索引:

$ reindexdb test

要重建名为 abcd 的数据库中表 foo 的索引和索引 bar:

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

另见

REINDEX

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。