Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14

ALTER INDEX

名称

ALTER INDEX -- 改变一个索引的定义

大纲

ALTER INDEX [ IF EXISTS ] name RENAME TO new_name
ALTER INDEX [ IF EXISTS ] name SET TABLESPACE tablespace_name
ALTER INDEX [ IF EXISTS ] name SET ( storage_parameter = value [, ... ] )
ALTER INDEX [ IF EXISTS ] name RESET ( storage_parameter [, ... ] )

描述

ALTER INDEX 改变一个现有索引的定义。 它有几种子形式:

IF EXISTS

使用此选项,当索引不存在时不会抛出错误,只会有一个通知。

RENAME

RENAME只改变索引的名字。对存储的数据没有影响。

SET TABLESPACE

这个选项会改变索引的表空间为指定表空间,并且把索引相关的数据文件移动到新的表空间里。 参见CREATE TABLESPACE

SET ( storage_parameter = value [, ... ] )

这个选项会改变索引的一个或多个索引方法特定的存储参数。参见CREATE INDEX获取可用参数的细节。 需要注意的是索引内容不会被这个命令立即修改,根据参数的不同, 你可能需要使用REINDEX重建索引来获得期望的效果。

RESET ( storage_parameter [, ... ] )

这个选项重置索引的一个或多个索引方法特定的存储参数为缺省值。 与SET一样,可能需要使用REINDEX来完全更新索引。

参数

name

要修改的索引的名字(可以有模式修饰)。

new_name

索引的新名字。

tablespace_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;

改变索引的占位因数(假定该索引方法支持它):

ALTER INDEX distributors SET (fillfactor = 75);
REINDEX INDEX distributors;

兼容性

ALTER INDEXPostgreSQL扩展。

参见

CREATE INDEX, REINDEX