描述

REINDEX 使用索引所属表中存储的数据重建索引，并替换索引的旧副本。以下几种场景适合使用 REINDEX：

参数

注解

如果怀疑某个用户表上的索引已经损坏，可以使用 REINDEX INDEX 或 REINDEX TABLE 直接重建该索引，或者重建该表上的所有索引。

如果需要从系统表上的索引损坏中恢复，情况就更复杂了。在这种情况下，重要的是系统本身没有使用任何可疑索引。（事实上，在这种场景下，你可能会发现服务器进程在启动时立即崩溃，因为它依赖损坏的索引。）要安全恢复，必须用 -P 选项启动服务器，该选项会阻止服务器在查找系统目录时使用索引。

一种做法是关闭服务器，并在命令行中包含 -P 选项来启动单用户 PostgreSQL 服务器。然后可以根据希望重建的范围，执行 REINDEX DATABASE、REINDEX SYSTEM、REINDEX TABLE 或 REINDEX INDEX。如果拿不准，就使用 REINDEX SYSTEM 来重建该数据库中的所有系统索引。然后退出单用户服务器会话并重新启动常规服务器。关于如何与单用户服务器接口交互的更多信息，参见 postgres 参考页。

另一种方法是启动一个常规服务器会话，并在其命令行选项中包含 -P。具体做法因客户端而异，但对于所有基于 libpq 的客户端，都可以在启动客户端之前将环境变量 PGOPTIONS 设置为 -P。注意，尽管这种方法不需要阻止其他客户端，但在修复完成之前，阻止其他用户连接到受损数据库可能仍然更稳妥。

REINDEX 类似于删除并重新创建索引，因为索引内容都是从头重建的。不过，两者在锁方面的考量相当不同。REINDEX 会阻止该索引所属表上的写入，但不阻止读取。它还会对正在处理的特定索引获取 ACCESS EXCLUSIVE 锁，从而阻塞试图使用该索引的读取。尤其是，无论查询内容如何，查询规划器都会尝试对该表的每个索引获取 ACCESS SHARE 锁，因此 REINDEX 实际上会阻塞几乎所有查询，只有那些计划已缓存且不使用这个索引的某些预备查询除外。相比之下，DROP INDEX 会短暂地对父表获取 ACCESS EXCLUSIVE 锁，同时阻塞写入和读取。随后的 CREATE INDEX 会阻止写入但不阻止读取；由于索引不存在，读取不会尝试使用它，因此不会发生阻塞，但读取可能被迫使用代价高昂的顺序扫描。

对单个索引或表重新索引，要求用户是该索引或表的拥有者。对模式或数据库重新索引，则要求用户是该模式或数据库的拥有者。特别要注意，这意味着非超级用户也可能重建其他用户拥有的表的索引。不过，作为一个特殊例外，当非超级用户执行 REINDEX DATABASE、REINDEX SCHEMA 或 REINDEX SYSTEM 时，除非该用户拥有共享系统目录（而这通常并非如此），否则会跳过共享系统目录上的索引。当然，超级用户始终可以重新索引任何对象。

分别可使用 REINDEX INDEX 和 REINDEX TABLE 对分区索引和分区表重新索引。指定分区关系的每个分区都会在单独的事务中重新索引。在处理分区表或分区索引时，这些命令不能在事务块内使用。

当对分区索引或分区表执行带 TABLESPACE 子句的 REINDEX 时，只有叶分区的表空间引用会被更新。由于分区索引本身不会更新，建议另外对这些分区索引单独执行 ALTER TABLE ONLY，以便后续附加的任何新分区都继承新表空间。如果命令失败，可能不会把所有索引都移动到新表空间。重新运行该命令将重建所有叶分区，并把先前未处理的索引移动到新表空间。

如果 SCHEMA、DATABASE 或 SYSTEM 与 TABLESPACE 一起使用，则系统关系会被跳过，并生成一条 WARNING。TOAST 表上的索引会重建，但不会移动到新的表空间。

postgres=# \d tab
       Table "public.tab"
 Column |  Type   | Modifiers
--------+---------+-----------
 col    | integer |
Indexes:
    "idx" btree (col)
    "idx_ccnew" btree (col) INVALID

示例

重建单个索引：

REINDEX INDEX my_index;

重建表 my_table 上的所有索引：

REINDEX TABLE my_table;

在不假定系统索引已经有效的情况下，重建某个数据库中的所有索引：

$ export PGOPTIONS="-P"
$ psql broken_db
...
broken_db=> REINDEX DATABASE broken_db;
broken_db=> \q

重建某个表的索引，并在重建期间不阻塞对相关关系的读写操作：

REINDEX TABLE CONCURRENTLY my_broken_table;

兼容性

在 SQL 标准中没有 REINDEX 命令。

另见