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 ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ]
  SET TABLESPACE new_tablespace [ NOWAIT ]

描述

ALTER INDEX 更改存在的一个索引的定义。 有下列的一些子形式:

  • RENAME — 修改索引的名字,对存储的数据无影响。
  • SET TABLESPACE — 修改索引的表空间到指定的表空间,然后将分配给这个 索引的数据文件也移到新的表空间。要修改索引的表空间,你必须在新的表空间有 CREATE 的权限。在当前数据库中一个表空间下所有的索引可以用 ALL IN TABLESPACE 形式移动, 这会锁住所有的要移动的索引,然后移动每一个索引。这种方式也在 OWNED BY 形式中支持, 这只会移动指定角色所拥有的索引。指定了 NOWAIT 选项的话,如果不能立即获取到需要的锁, 命令将会失败。注意系统目录不会被这个命令移动,如果需要,请使用 ALTER DATABASE 或者显式调用调用 ALTER INDEX。另见 CREATE TABLESPACE.
  • IF EXISTS — 如果索引不存在不会抛出错误,而会触发一个提醒。
  • SET — 更改索引的特定于索引方法的存储参数。 内置索引方法都接受一个参数: fillfactor。 索引的fillfactor 是一个百分比,用于确定索引方法尝试打包索引页的程度。 此命令不会立即修改索引内容。 使用 REINDEX 重建索引以获得所需的效果。
  • RESET — 将索引的存储参数重置为其默认值。 内置索引方法都接受一个参数: fillfactor。与 SET 一样,可能需要 REINDEX 来完全更新索引。

参数

name

  • 要修改的现有索引的名称(可选方案限定)。

new_name

  • 索引的新名称。

tablespace_name

  • 要移动索引的表空间。

storage_parameter

  • index-method-specific 指定的存储参数名称。

value

  • index-method-specific 指定的存储参数值,这可能是基于参数的数字或者词

示例

修改一个索引的名字:

ALTER INDEX distributors RENAME TO suppliers;

移动索引到另外一个表空间:

ALTER INDEX distributors SET TABLESPACE fasttablespace;

要更改索引的填充因子(假设索引方法支持它):

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

兼容性

ALTER INDEX 是 YMatrix 数据库的扩展。

另见

CREATE INDEXDROP INDEX