ALTER INDEX

功能描述

用于修改已有索引的定义。

注意事项

• 索引的所有者、拥有索引所在表的INDEX权限的用户或者被授予了ALTER ANY INDEX权限的用户有权限执行此命令，当三权分立开关关闭时，系统管理员默认拥有此权限。
• 请勿在同一基表上保持大量的不可见索引，否则可能会对INSERT、UPDATE、DELETE等DML操作的性能产生影响。

语法格式

• 重命名表索引的名称。

  ALTER INDEX [ IF EXISTS ] index_name 
      RENAME TO new_name;

  

• 设置表索引不可用。

  ALTER INDEX [ IF EXISTS ] index_name UNUSABLE;

• 重命名索引分区。

  ALTER INDEX [ IF EXISTS ] index_name 
      RENAME PARTITION index_partition_name TO new_index_partition_name;

  

• 修改表索引的存储参数。

  1 2	ALTER INDEX [ IF EXISTS ] index_name SET ( {storage_parameter = value} [, ... ] );

参数说明

• index_name

  要修改的索引名称。

• IF EXISTS

  如果指定的索引不存在，则发出一个notice而不是error。

• RENAME TO new_name

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

  new_name

  新的索引名。

  取值范围：字符串，且符合标识符说明。

• RENAME PARTITION index_partition_name TO new_index_partition_name

  用于重命名索引分区。

• new_index_partition_name

  新索引分区名。

• index_partition_name

  索引分区名。

• SET ( {storage_parameter = value} [, ... ] )

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

  • storage_parameter

    索引方法特定的参数名。ACTIVE_PAGES表示索引的页面数量，可能比实际的物理文件页面少，可以用于优化器调优。目前只对ustore的分区表local索引生效，且会被vacuum、analyze更新（包括auto vacuum）。不建议用户手动设置该参数，该参数在分布式下无效。对GSI执行ALTER时，对INTERNAL_MASK、APPEND_MODE_INTERNAL、WAIT_CLEAN_GPI、PARTITION_DDL_FLAG、COLLATE、CROSSBUCKET和DEDUPLICATION参数不支持，行为同UBtree，支持FILLFACTOR、INDEXSPLIT参数，ACTIVE_PAGES和WAIT_CLEAN_CBI 不适用于GSI。

  • value

    索引方法特定的存储参数的新值。根据参数的不同，这可能是一个数字或单词。

• RESET ( { storage_parameter } [, ...] )

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

示例

• 重命名索引。

  --创建test1表并为其创建索引。
  m_db=# CREATE TABLE test1(col1 INT, col2 INT);
  m_db=# CREATE INDEX aa ON test1(col1);
  
  --将索引aa重命名为idx_test1_col1。
  m_db=# ALTER INDEX aa RENAME TO idx_test1_col1;
  
  --查询test1表上的索引信息。
  m_db=# SELECT tablename,indexname,tablespace FROM pg_indexes WHERE tablename = 'test1';
   tablename |   indexname    | tablespace 
  -----------+----------------+------------
   test1     | idx_test1_col1 | 
  (1 row)

• 重命名索引分区。

  --创建分区表test2。
  m_db=# CREATE TABLE test2(col1 int, col2 int) PARTITION BY RANGE (col1)(
      PARTITION p1 VALUES LESS THAN (100),
      PARTITION p2 VALUES LESS THAN (200)
  );
  
  --创建分区索引。
  m_db=# CREATE INDEX idx_test2_col1 ON test2(col1) LOCAL(
      PARTITION p1,
      PARTITION p2
  );
  --重命名索引分区。
  m_db=# ALTER INDEX idx_test2_col1 RENAME PARTITION p1 TO p1_test2_idx;
  m_db=# ALTER INDEX idx_test2_col1 RENAME PARTITION p2 TO p2_test2_idx;
  
  --查询索引idx_test2_col1分区的名称。
  m_db=# SELECT relname FROM pg_partition WHERE parentid = 'idx_test2_col1'::regclass;
     relname    
  --------------
   p1_test2_idx
   p2_test2_idx
  (2 rows)

相关链接

CREATE INDEX，DROP INDEX，REINDEX