版本历史
寻求帮助

关于 YMatrix

立即体验

部署数据库

使用数据库

管理集群

安全配置

最佳实践

技术原理

高级功能

管理手册

SQL 参考

常见问题

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 INDEX，DROP INDEX

← 上一篇
ALTER_GROUP
下一篇 →
ALTER_LANGUAGE