ALTER INDEX — 更改索引的定义
ALTER INDEX [ IF EXISTS ]nameRENAME TOnew_nameALTER INDEX [ IF EXISTS ]nameSET TABLESPACEtablespace_nameALTER INDEXnameATTACH PARTITIONindex_nameALTER INDEXname[ NO ] DEPENDS ON EXTENSIONextension_nameALTER INDEX [ IF EXISTS ]nameSET (storage_parameter[=value] [, ... ] ) ALTER INDEX [ IF EXISTS ]nameRESET (storage_parameter[, ... ] ) ALTER INDEX [ IF EXISTS ]nameALTER [ COLUMN ]column_numberSET STATISTICSintegerALTER INDEX ALL IN TABLESPACEname[ OWNED BYrole_name[, ... ] ] SET TABLESPACEnew_tablespace[ NOWAIT ]
ALTER INDEX更改现有索引的定义。下面描述了若干种子形式。 请注意，每种子形式所需的锁级别可能不同。除非另有明确说明，否则会持有 ACCESS EXCLUSIVE锁。若列出多个子命令，则持有的锁将是其中任一子命令所需的最严格锁。
RENAMERENAME形式更改该索引的名称。如果该索引与某个表约束（即 UNIQUE、PRIMARY KEY或 EXCLUDE）相关联，该约束也会一并重命名。这不会影响已存储的数据。
重命名索引会获取一个SHARE UPDATE EXCLUSIVE锁。
SET TABLESPACE这种形式将该索引的表空间改为指定表空间，并把与该索引关联的数据文件移动到新表空间中。 要更改索引的表空间，你必须拥有该索引，并且对新表空间具有 CREATE权限。使用ALL IN TABLESPACE 形式可以移动当前数据库中某个表空间内的全部索引；该形式会锁定所有待移动的索引，然后逐个移动。 该形式还支持OWNED BY，这时只会移动属于指定角色的索引。 如果指定了NOWAIT选项，则在命令无法立即获取所需全部锁时会失败。 注意，该命令不会移动系统目录；如果需要这样做，应改用ALTER DATABASE 或显式调用ALTER INDEX。另见 CREATE TABLESPACE。
ATTACH PARTITION index_name使指定名称的索引（可以带模式限定）附加到被修改的索引上。 该索引必须位于包含被修改索引之表的某个分区上，并且具有等价定义。 已附加的索引不能单独删除；如果其父索引被删除，它也会自动被删除。
DEPENDS ON EXTENSION extension_nameNO DEPENDS ON EXTENSION extension_name这种形式会将索引标记为依赖于该扩展；如果指定了NO，则表示不再依赖该扩展。 标记为依赖于扩展的索引会在扩展被删除时自动删除。
SET ( storage_parameter [= value] [, ... ] )这种形式更改该索引的一个或多个索引方法相关的存储参数。可用参数的详情请见 CREATE INDEX。 请注意，此命令不会立即修改索引内容；根据参数不同，你可能需要使用 REINDEX 重建索引，才能获得期望的效果。
RESET ( storage_parameter [, ... ] )这种形式将一个或多个索引方法相关的存储参数重置为默认值。与 SET一样，可能仍需要执行一次REINDEX 才能让该索引被完全更新。
ALTER [ COLUMN ] column_number SET STATISTICS integer这种形式为后续的ANALYZE操作设置每列的统计信息收集目标， 但只能用于定义为表达式的索引列。由于表达式没有唯一名称，我们通过索引列的顺序号来引用它们。 该目标可以设置为0到10000之间的值；或者设为-1，以恢复使用系统默认统计信息目标 （default_statistics_target）。关于 PostgreSQL查询规划器如何使用统计信息的更多信息，请参阅 Section 14.2。
IF EXISTS如果该索引不存在，则不要抛出错误。这种情况下会发出一条提示。
column_number该顺序号表示该索引列从左到右的位置。
name要修改的现有索引名称（可以是模式限定的）。
new_name该索引的新名称。
tablespace_name该索引将被移动到的表空间。
extension_name该索引所依赖的扩展的名称。
storage_parameter一个索引方法相关的存储参数的名称。
value一个索引方法相关的存储参数的新值。根据具体参数，它可能是数字或一个词。
这些操作同样可以使用 ALTER TABLE完成。 实际上，ALTER INDEX只是ALTER TABLE 中适用于索引的那些形式的别名。
以前曾有一种ALTER INDEX OWNER变体，但现在会被忽略 （同时发出警告）。索引的拥有者不能不同于其所属表的拥有者。更改表的拥有者时， 索引的拥有者也会自动更改。
不允许更改系统目录索引的任何部分。
要重命名现有索引：
ALTER INDEX distributors RENAME TO suppliers;
要将索引移到另一个表空间：
ALTER INDEX distributors SET TABLESPACE fasttablespace;
要更改索引的填充因子（假设该索引方法支持fillfactor参数）：
ALTER INDEX distributors SET (fillfactor = 75); REINDEX INDEX distributors;
要为表达式索引设置统计信息收集目标：
CREATE INDEX coord_idx ON measured (x, y, (z + t)); ALTER INDEX coord_idx ALTER COLUMN 3 SET STATISTICS 1000;
ALTER INDEX是一种 PostgreSQL扩展。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明，请使用此表单来报告文档问题。