REINDEX

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运行期间，search_path会临时改为pg_catalog, pg_temp。

对单个索引或表重新索引，需要在相应表上具有 MAINTAIN 权限。注意，对分区索引或分区表执行REINDEX时，需要在该分区表上具有 MAINTAIN 权限，但在处理各个分区时会跳过权限检查。对模式或数据库重新索引，则需要是该模式或数据库的拥有者，或者具有pg_maintain角色的权限。特别要注意，这意味着非超级用户也可能重建其他用户拥有的表的索引。不过，作为一个特殊例外，REINDEX DATABASE、REINDEX SCHEMA和REINDEX SYSTEM 会跳过共享系统目录上的索引，除非用户对该目录具有 MAINTAIN权限。

分别可使用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命令。