最新动态
功能总览
服务公告
- 产品公告
- 版本支持公告
- 集群版本公告
产品介绍
- 图解数据仓库服务
- 什么是数据仓库服务
- 数据仓库类型
- 数据仓库规格
- 产品优势
- 应用场景
- 产品功能
- 基本概念
- 与其他云服务的关系
- 安全
- DWS权限管理
- 如何访问DWS
- 使用限制
- 技术支持
- 配额说明
- DWS技术指标
计费说明
- DWS计费概述
- 计费模式
- 计费项
- 计费样例
- 变更计费模式
- 续费
- 费用账单
- 欠费说明
- 停止计费
- 成本管理
- 计费FAQ
快速入门
- 免费体验DWS
- 快速创建DWS集群并导入数据进行查询
- DWS数据开发SQL入门操作
- DWS入门实践
用户指南
- DWS使用流程
- 准备工作
- 创建DWS集群
- 连接DWS集群
- 创建DWS数据库和用户
- 迁移业务数据至DWS集群
  - 使用GDS-Kafka工具迁移数据至DWS集群
  - 管理数据源
- DWS集群数据安全与加密
- DWS集群管理
- DWS集群运维
最佳实践
- DWS最佳实践汇总
- 导入导出
- 数据迁移
- 数据分析
- 存算分离
  - DWS 3.0 存算分离使用建议及性能优化
- 数据开发
- 数据库管理
- 性能调优
- 集群管理及资源负载监控
  - 为两种作业绑定不同资源池以实现DWS资源负载能力
  - DWS存算一体架构弹性伸缩系统性介绍
- 安全管理
  - DWS安全最佳实践
数据迁移与同步
- 迁移数据到DWS
- 导入数据
- 整库迁移
  - 使用CDM迁移数据到DWS
  - 使用DSC工具迁移SQL脚本
- 实时入库
  - Kafka实时入库到DWS
- 元数据迁移
  - 使用gs_dump和gs_dumpall命令导出元数据
  - 使用gs_restore导入数据
- 导出数据
- 其他操作
开发指南
- 开发指南(9.1.0.x)
- 开发指南(9.1.1.x)
- 历史版本
SQL语法参考
- SQL语法参考(9.1.0.x)
- SQL语法参考(9.1.1.x)
- 历史版本
工具指南
- 工具简介
- 工具下载
- gsql
- GDS
- DSC
- DataCheck
- DWS-Connector
- 服务端工具
  - gs_dump
  - gs_dumpall
  - gs_restore
  - gds_check
  - gds_install
  - gds_uninstall
  - gds_ctl
API参考
- 使用前必读
- API概述
- 如何调用API
- 快速入门
- API说明
- 应用示例
  - 使用Postman调用创建集群接口
  - 使用Postman调用创建快照接口
- 权限及授权项说明
- 附录
SDK参考
- SDK概述
场景代码示例
错误码参考
- 控制台错误码
  - 管理控制台错误码
- 错误码(8.2.0及以下版本)
- 8.2.1及以上版本
  - 错误码命名规范
  - 行列存
    - 行存
    - 列存
    - GIN索引
    - Btree索引
    - 行存vacuum
    - SP-GiST索引
    - Hash索引
  - 事务
    - 锁
    - GTM
    - xlog
    - checkpoint
  - HA
  - SQL on Anywhere
    - SQL on hudi
    - OBS / HDFS / DLI
  - GDS/Copy
    - 公共机制（选项参数、任务分配、压缩）
    - 导入
  - 解析器
    - 词法分析
    - 语法分析
    - DDL
    - DML
    - 表达式
    - 元数据
  - 优化器
  - 执行器
  - 安全
    - 授权
    - 脱敏
  - 通信
  - WLM
  - 逻辑集群
  - 其他
常见问题
- Top问题汇总
- 产品咨询
- 数据库连接
- 数据迁移
- 数据库使用
- 集群管理
- 账户与权限
- 数据库性能
- 备份恢复
  1. 为什么DWS自动快照创建很慢，很长时间都没有创建好？
  2. DWS快照是否与EVS快照功能相同？
故障排除
- 数据库连接管理
- JDBC/ODBC类
- 数据导入/导出
- 数据库参数修改
- 账号/权限/密码
- 集群性能
- 集群异常
  - 磁盘监控告警阈值太低，告警频繁
- 数据库使用
视频帮助
性能白皮书
- 性能白皮书(9.1.1.x)
- 性能白皮书(9.1.0.x)
- 性能白皮书(8.1.3.x)
文档下载
通用参考
- 产品术语
- 云服务等级协议（SLA）
- 白皮书资源
- 支持区域
- 系统权限

本文导读

展开导读

文档首页/ 数据仓库服务 DWS/ SQL语法参考/ SQL语法参考(9.1.0.x)/ DDL语法/ ALTER INDEX

ALTER INDEX

更新时间：2025-07-08 GMT+08:00

查看PDF

功能描述

ALTER INDEX用于修改索引的定义。

注意事项

只有索引的所有者有权限执行此命令，系统管理员默认拥有此权限。

语法格式

重命名表索引的名称，支持新的索引名称前带有原索引所在的schema名，但是不支持同时修改schema名。

       
          ALTER INDEX [ IF EXISTS ] index_name 
    RENAME TO new_name;
ALTER INDEX [ IF EXISTS ] index_name 
    RENAME TO schema.new_name;

修改表索引的存储参数。

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

修改索引的状态标记。

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

重置表索引的存储参数。

1 2	ALTER INDEX [ IF EXISTS ] index_name RESET ( storage_parameter [, ... ] ) ;

设置表索引或索引分区不可用。列存表不支持该语法。

       
          ALTER INDEX [ IF EXISTS ] index_name 
    [ MODIFY PARTITION index_partition_name ] UNUSABLE;

重建表索引或索引分区。

       
          ALTER INDEX index_name 
    REBUILD [ PARTITION index_partition_name ] [WITHOUT UNUSABLE];

重命名索引分区。PG_OBJECT系统表记录索引的最后修改时间时，暂不支持对该语法的记录。

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

添加，修改索引的注释。

      
         ALTER INDEX [ IF EXISTS ] index_name 
    COMMENT 'text';

删除索引的注释。

      
         ALTER INDEX [ IF EXISTS ] index_name 
    COMMENT '';
ALTER INDEX [ IF EXISTS ] index_name
    COMMENT NULL;

参数说明

表1 ALTER INDEX参数说明
参数	描述	取值范围
IF EXISTS	如果指定的索引不存在时，返回一个提示而不是错误。	-
RENAME TO	修改索引的名称，对存储的数据本身没有任何影响。	-
SET ( { STORAGE_PARAMETER = value } [, ...] )	修改索引的一个或多个索引方法特定的存储参数。此命令不会立即修改索引内容，根据参数的不同，可能需要使用REINDEX重建索引来获得所需的效果。	取值范围和详细用法参见表2。
RESET ( { storage_parameter } [, ...] )	重置索引的一个或多个索引方法特定的存储参数为默认值。与SET一样，可能需要使用REINDEX来完全更新索引。	-
[ MODIFY PARTITION index_partition_name ] UNUSABLE	用于设置表或者索引分区上的索引不可用。	-
REBUILD [ PARTITION index_partition_name ]	用于重建表或者索引分区上的索引。	-
WITHOUT UNUSABLE	重建表或者索引分区上的索引时不重建状态为UNUSABLE的索引。	-
RENAME PARTITION	用于重命名索引分区。	-
COMMENT comment_text	用于添加，修改或删除索引的注释。	-
index_name	需要修改的索引名。	已存在的索引名。
new_name	新的索引名。	字符串，需符合标识符命名规范。
storage_parameter	索引方法特定的参数名。	-
invisible	控制优化器是否生成索引扫描相关计划。默认值：OFF。	ON或OFF。 ON表示不生成索引扫描相关计划。 OFF表示生成索引扫描相关计划。
value	索引方法特定的存储参数的新值。根据参数的不同，这可能是一个数字或单词。	-
new_index_partition_name	新索引分区名。	字符串，需符合标识符命名规范。
index_partition_name	索引分区名。	字符串，需符合标识符命名规范。
comment_text	索引的注释信息。	-

表2 WITH ( {storage_parameter = value} [, ... ] )指定索引方法的存储参数

存储参数

描述

示例

FILLFACTOR

GIN和PSORT索引不支持该参数，表示一个索引的填充因子（fillfactor），取值范围是一个介于10和100之间的百分比值，用于指定索引页初始填充的百分比，剩余的空间可以用于后续的插入和更新操作，从而减少页面分裂和提高性能。

该参数的作用是控制索引页的填充程度，从而影响数据库的性能和存储空间的利用效率，通过调整FILLFACTOR的值，可以减少后续更新或插入操作导致的页分裂，优化索引的存储和性能。

FILLFACTOR对索引性能的影响：

性能：当索引页填满后，新的数据插入会导致页面分裂，这会消耗更多的I/O资源和时间。较低的 fillfactor可以减少页面分裂，提高插入和更新性能，但会增加存储空间的使用。较高的 fillfactor可以提高存储空间的利用率，但可能会导致更多的页面分裂，降低插入和更新性能。
存储空间：较低的fillfactor会增加每个数据页面的空闲空间，导致更多的磁盘空间使用。较高的fillfactor会更紧凑地存储数据，减少磁盘空间使用。

如何选择合适的FILLFACTOR值：

对于更新频繁的表，选择较小fillfactor值如60~80，预留空间，减少页分裂。
对于更新较少的表，选择较大fillfactor值如90~100，以提高存储空间利用率。

修改索引的填充因子FILLFACTOR为60%。

          
             ALTER INDEX tpcds.ds_ship_mode_t1_index7 SET (FILLFACTOR = 60);

INVISIBLE

控制优化器是否生成索引扫描相关计划。

适用场景：维护期间临时禁用索引，或测试索引对性能的影响。

取值范围：

ON表示不生成索引扫描相关计划。
OFF表示生成索引扫描相关计划。

默认值：OFF

设置优化器不生成索引的扫描相关计划。

          
             ALTER INDEX tpcds.ds_ship_mode_t1_index9 SET (INVISIBLE = ON);

FASTUPDATE

仅GIN索引支持该参数，GIN索引是否使用快速更新，当启用后，数据变更会暂存到待处理列表（Pending List）。

取值范围：ON，OFF

默认值：ON

打开快速更新参数FASTUPDATE，设置该索引Pending List容量的最大值为8MB。

          
             ALTER INDEX tpcds.ds_ship_mode_t1_index10 SET (FASTUPDATE = ON, GIN_PENDING_LIST_LIMIT = 8192);

GIN_PENDING_LIST_LIMIT

仅GIN索引支持该参数，当GIN索引启用fastupdate时，设置该索引Pending List容量的最大值。

Pending List是GIN索引特有的数据结构，用于临时存储索引更新操作。当GIN索引启用FASTUPDATE参数时，新的索引项不会直接写入主索引结构，而是先存入Pending List，待满足特定条件时再批量合并到主索引中。

取值范围：64~INT_MAX，单位KB。

默认值：由GUC参数gin_pending_list_limit的值决定（默认为4MB）。

示例

创建示例表tpcds.ship_mode_t1。

      
         DROP TABLE IF EXISTS tpcds.ship_mode_t1;
CREATE TABLE tpcds.ship_mode_t1
(
    SM_SHIP_MODE_SK           INTEGER               NOT NULL,
    SM_SHIP_MODE_ID           CHAR(16)              NOT NULL,
    SM_TYPE                   CHAR(30)                      ,
    SM_CODE                   CHAR(10)                      ,
    SM_CARRIER                CHAR(20)                      ,
    SM_CONTRACT               CHAR(20)
) 
DISTRIBUTE BY HASH(SM_SHIP_MODE_SK);

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建唯一索引。

     
        DROP INDEX IF EXISTS ds_ship_mode_t1_index1;
CREATE UNIQUE INDEX ds_ship_mode_t1_index1 ON tpcds.ship_mode_t1(SM_SHIP_MODE_SK);

在表tpcds.ship_mode_t1上SM_CODE字段上创建表达式索引。

     
        DROP INDEX IF EXISTS ds_ship_mode_t1_index2;
CREATE INDEX ds_ship_mode_t1_index2 ON tpcds.ship_mode_t1(SUBSTR(SM_CODE,1 ,4));

重命名现有的索引ds_ship_mode_t1_index1为ds_ship_mode_t1_index5。

1	ALTER INDEX tpcds.ds_ship_mode_t1_index1 RENAME TO ds_ship_mode_t1_index5;

设置索引ds_ship_mode_t1_index2不可用。

1	ALTER INDEX tpcds.ds_ship_mode_t1_index2 UNUSABLE;

重建索引ds_ship_mode_t1_index2。

1	ALTER INDEX tpcds.ds_ship_mode_t1_index2 REBUILD;

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问