# ALTER INDEX
#### 功能描述
用于修改已有索引的定义。
#### 注意事项
- 索引的所有者、拥有索引所在表的INDEX权限的用户或者被授予了ALTER ANY INDEX权限的用户可以执行此命令，当三权分立开关关闭时，系统管理员默认拥有此权限。
- 请勿在同一基表上保持大量的不可见索引，否则可能会对INSERT、UPDATE、DELETE等DML操作的性能产生影响。
 
#### 语法格式
- 重命名表索引的名称。
  ```
  ALTER INDEX [ IF EXISTS ] index_name 
      RENAME TO new_name;
  ```
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002764301348.png "点击放大")
  

- 设置表索引不可用。
  ```
  ALTER INDEX [ IF EXISTS ] index_name UNUSABLE;
  ```
  

- 重命名索引分区。
  ```
  ALTER INDEX [ IF EXISTS ] index_name 
      RENAME PARTITION index_partition_name TO new_index_partition_name;
  ```
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002793699879.png "点击放大")
  
- 修改表索引的存储参数。
  ```
  ALTER INDEX [ IF EXISTS ] index_name 
      SET ( {storage_parameter = value} [, ... ] );
  ```
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002793699881.png)
  
- 重置表索引的存储参数。
  ```
  ALTER INDEX [ IF EXISTS ] index_name 
      RESET ( storage_parameter [, ... ] ) ;
  ```
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002764301350.png)
  
 
#### 参数说明
- **index_name**
  要修改的索引名称。
  
- **IF EXISTS**
  如果指定的索引不存在，则发出一个notice而不是error。
  
- **RENAME TO new_name**
  只改变索引的名称。对存储的数据没有影响。
  **new_name**
  新的索引名。
  取值范围：字符串，要符合[标识符说明](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0448.html)。
  
- **RENAME PARTITION index_partition_name TO new_index_partition_name**
  用于重命名索引分区。
  
- **new_index_partition_name**
  新索引分区名。
  
- **index_partition_name**
  索引分区名。
  
- **SET ( {storage_parameter = value} \[, ... \] )**
  修改索引的存储参数。当前支持修改的参数如下：
  - FILLFACTOR 定义索引页面的填充率（填充因子）。在高并发插入且键值分布密集的情况下，建议设置较低的填充因子以减少索引页竞争。
    取值范围：10\~100（百分比）。
    
  
  - ENABLE_TDE 是否将索引设置为加密索引。仅在GUC参数enable_tde开启透明加密功能，并通过GUC参数tde_key_info设置访问密钥服务的信息后支持将该选项设置为on。
    取值范围：on/off
    
  
  
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  使用该命令进行修改索引的存储参数时，不会对索引的内容进行立即更新。根据参数类型，可能需要通过REINDEX命令重建索引以实现预期效果。
  
- **RESET ( { storage_parameter } \[, ...\] )**
  重置索引的存储参数为默认值。
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  与SET ( {storage_parameter = value} \[, ... \] )操作相同，执行该命令进行重置索引的存储参数操作时，可能需要通过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](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0489.html)，[DROP INDEX](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0510.html)，[REINDEX](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0535.html)
