最新动态
功能总览
服务公告
- 产品公告
- 版本支持公告
- 集群版本公告
产品介绍
- 图解数据仓库服务
- 什么是数据仓库服务
- 数据仓库类型
- 数据仓库规格
- 产品优势
- 应用场景
- 产品功能
- 基本概念
- 与其他云服务的关系
- 安全
- GaussDB(DWS)权限管理
- 如何访问GaussDB(DWS)
- 使用限制
- 技术支持
- 配额说明
- GaussDB(DWS)技术指标
计费说明
- GaussDB(DWS)计费概述
- 计费模式
- 计费项
- 计费样例
- 变更计费模式
- 续费
  - 续费概述
  - 手动续费
- 费用账单
- 欠费说明
- 停止计费
- 成本管理
- 计费FAQ
快速入门
- 免费体验GaussDB(DWS)
- 快速创建GaussDB(DWS)集群并导入数据进行查询
- GaussDB(DWS)数据开发SQL入门操作
- GaussDB(DWS)入门实践
用户指南
- GaussDB(DWS)使用流程
- 准备工作
- 创建GaussDB(DWS)集群
- 连接GaussDB(DWS)集群
- 创建GaussDB(DWS)数据库和用户
- 迁移业务数据至GaussDB(DWS)集群
  - 使用GDS-Kafka工具迁移数据至GaussDB(DWS)集群
  - 管理数据源
- GaussDB(DWS)集群数据安全与加密
- GaussDB(DWS)集群管理
- GaussDB(DWS)集群运维
最佳实践
- DWS最佳实践汇总
- 导入导出
- 数据迁移
- 数据分析
- 存算分离
  - DWS 3.0 存算分离使用建议及性能优化
- 数据开发
- 数据库管理
- 性能调优
- 集群管理
  - 为两种作业绑定不同资源池以实现DWS资源负载能力
  - DWS存算一体架构弹性伸缩系统性介绍
- 安全管理
  - DWS安全最佳实践
数据迁移与同步
- 迁移数据到GaussDB(DWS)
- 导入数据
- 整库迁移
  - 使用CDM迁移数据到GaussDB(DWS)
  - 使用DSC工具迁移SQL脚本
- 实时入库
  - Kafka实时入库到GaussDB(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.0.x)
- 性能白皮书(8.1.3.x)
文档下载
通用参考
- 产品术语
- 云服务等级协议（SLA）
- 白皮书资源
- 支持区域
- 系统权限

本文导读

功能描述
注意事项
语法格式
参数说明
示例
关于NULLS DISTINCT、NULLS NOT DISTINCT、NULLS IGNORE使用上的场景差异
相关链接
常见问题

展开导读

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

CREATE INDEX

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

查看PDF

功能描述

在指定的表上创建索引。

GaussDB(DWS)索引支持的类型

GaussDB(DWS)支持创建的索引类型包括：

B-Tree：B-Tree索引使用一种类似于B+树的结构来存储数据的键值，通过这种结构能够快速的查找索引。B-Tree适合支持比较查询以及查询范围。
GIN：GIN索引是倒排索引，可以处理包含多个键的值（比如数组）。
GiST：GiST索引适用于几何和地理等多维数据类型和集合数据类型。
PSORT：PSORT索引是针对列存表进行局部排序索引。

其中，

行存表支持：B-Tree（行存表缺省值）、GIN、GiST。
列存表支持：PSORT（列存表缺省值）、B-Tree、GIN。

从分区表的角度分析，又分为本地索引（LOCAL INDEX），全局索引（GLOBAL INDEX）。

本地索引（LOCAL INDEX）：也叫分区索引，即在分区表的每个区上单独创建索引，本地索引与分区表的分区一一对应，具有与其表相同的分区数和相同的分区范围。当表分区发生变化时，只需维护对应的索引分区。
全局索引（GLOBAL INDEX）：全局索引是跨分区的全局索引，索引结构独立于基表的分区方式，覆盖整个表的所有分区数据。目前DWS不支持全局索引。

GaussDB(DWS)支持的索引方式

表1 索引方式
索引方式	描述
唯一索引	可用于约束索引属性值的唯一性，或者属性组合值的唯一性。如果一个表声明了唯一约束或者主键，则GaussDB(DWS)自动在组成主键或唯一约束的字段上创建唯一索引（可能是多字段索引），以实现这些约束。目前，GaussDB(DWS)只有B-Tree可以创建唯一索引。
多字段索引（或复合索引、联合索引）	一个索引可以定义在表中的多个属性上。目前，GaussDB(DWS)中的B-Tree支持多字段索引，且最多可在32个字段上创建索引。
部分索引	建立在一个表的子集上的索引，这种索引方式只包含满足条件表达式的元组。
表达式索引	索引建立在一个函数或者从表中一个或多个属性计算出来的表达式上。表达式索引只有在查询时使用与创建时相同的表达式才会起作用。

创建索引的原则

索引可以用来提高数据库查询性能，但是不恰当的使用将导致数据库性能下降。建议仅在匹配如下某条原则时创建索引：

经常执行查询的字段。
在连接条件上创建索引，对于存在多字段连接的查询，建议在这些字段上建立组合索引。例如，select * from t1 join t2 on t1.a=t2.a and t1.b=t2.b，可以在t1表上的a，b字段上建立组合索引。
where子句的过滤条件字段上（尤其是范围条件）。
在经常出现在order by、group by和distinct后的字段。
对于点查询场景，推荐建立B-Tree索引。

在分区表上创建索引与在普通表上创建索引的语法不太相同，使用时请注意，如分区表上不支持并行创建索引、不支持创建部分索引、不支持NULL FIRST特性。

注意事项

索引自身也占用存储空间、消耗计算资源，创建过多的索引将对数据库性能造成负面影响（尤其影响数据导入的性能，建议在数据导入后再建索引）。因此，仅在必要时创建索引。
索引定义里的所有函数和操作符都必须是immutable类型的，即结果必须依赖于其输入参数，而不受任何外部的影响（如另外一个表的内容或者当前时间），该限制可以确保该索引的行为是定义良好的。在一个索引上或WHERE语句中使用用户定义函数，请将其标记为immutable类型函数。
在分区表上创建索引时，索引项中必须包含分布列和所有分区键。
GaussDB(DWS)在分区表上创建索引时只支持本地索引（LOCAL INDEX），不支持全局索引（GLOBAL INDEX）。
列存表和HDFS表支持B-Tree索引，不支持创建表达式索引、部分索引。
列存表支持通过B-Tree索引建立唯一索引。
列存表和HDFS表支持的PSORT索引不支持创建表达式索引、部分索引和唯一索引。
列存表支持的GIN索引支持创建表达式索引，但表达式不能包含空分词、空列和多列，不支持创建部分索引和唯一索引。
列存索引不支持OR查询过滤条件及inlist场景。
roundrobin表不支持创建主键/唯一索引。
对表执行CREATE INDEX或REINDEX操作时会触发索引重建（索引重建过程中会先把数据转储到一个新的数据文件中，重建完成之后会删除原始文件），当表比较大时，重建会消耗较多的磁盘空间。当磁盘空间不足时，要谨慎对待大表CREATE INDEX或REINDEX操作，防止触发集群只读。

警告：

针对有大批量数据增删改的表，索引个数建议控制在3个以内，最多不超过5个。
避免在业务高峰期对大表执行CREATE INDEX和REINDEX操作。
更多开发设计规范参见总体开发设计规范。

语法格式

在表上创建索引。

       
          CREATE [ UNIQUE ] INDEX [ [IF NOT EXISTS] [ schema_name. ] index_name ] ON table_name [ USING method ]
    ({ { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ] }[, ...] )
    [ NULLS [ NOT ] DISTINCT | NULLS IGNORE ]
    [ COMMENT 'text' ]
    [ WITH ( {storage_parameter = value} [, ... ] ) ]
    
    [ WHERE predicate ];

在分区表上创建索引。

       
          CREATE [ UNIQUE ] INDEX [ [IF NOT EXISTS] [ schema_name. ] index_name ] ON table_name [ USING method ]
    ( {{ column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [ ASC | DESC ] [ NULLS LAST ] }[, ...] )
    [ NULLS [ NOT ] DISTINCT | NULLS IGNORE ]
    [ COMMENT 'text' ]
    LOCAL [ ( { PARTITION index_partition_name  } [, ...] ) ]
    [ WITH ( { storage_parameter = value } [, ...] ) ]
    ;

参数说明

表2 CREATE INDEX参数说明
参数	描述	取值范围
UNIQUE	创建唯一性索引，每次添加数据时检测表中是否有重复值。如果插入或更新的值会引起重复的记录时，系统会报错。目前只有行存表B-Tree索引和列存表的B-Tree索引支持唯一索引。	-
IF NOT EXISTS	指定IF NOT EXISTS时，若不存在同名索引，则可以成功创建索引。若已存在同名索引，创建时不会报错，仅会提示该索引已存在，且不执行任何操作。当使用IF NOT EXISTS时，需要指定索引名。该参数仅9.1.0及以上集群版本支持。	-
schema_name	要创建的索引所在的模式名。指定的模式名需与表所在的模式相同。	-
index_name	要创建的索引名，索引的模式与表相同。	取值范围：字符串，要符合标识符的命名规范。
table_name	需要为其创建索引的表的名字，可以用模式修饰。	取值范围：已存在的表名。
USING method	指定创建索引的方法。	取值范围： btree：B-Tree索引使用一种类似于B+树的结构来存储数据的键值，通过这种结构能够快速的查找索引。B-Tree适合支持比较查询以及查询范围。 gin：GIN索引是倒排索引，可以处理包含多个键的值（比如数组）。 gist：GiST索引适用于几何和地理等多维数据类型和集合数据类型。 psort：PSORT索引。针对列存表进行局部排序索引。行存表支持的索引类型：btree（行存表缺省值）、gin、gist。列存表支持的索引类型：psort（列存表缺省值）、btree、gin。
column_name	表中需要创建索引的列的名字（字段名）。	如果索引方式支持多字段索引，可以声明多个字段。最多可以声明32个字段。
expression	创建一个基于该表的一个或多个字段的表达式索引，通常必须写在圆括弧中。	如果表达式有函数调用的形式，圆括弧可以省略。表达式索引可用于获取对基本数据的某种变形的快速访问。比如，一个在upper(col)上的函数索引将允许WHERE upper(col) = 'JIM'子句使用索引。在创建表达式索引时，如果表达式中包含IS NULL子句，则这种索引是无效的。此时，建议用户尝试创建一个部分索引。
COLLATE collation	COLLATE子句指定列的排序规则（该列必须是可排列的数据类型）。如果没有指定，则使用默认的排序规则。	-
opclass	操作符类的名字。	对于索引的每一列可以指定一个操作符类，操作符类标识了索引那一列的使用的操作符。例如一个B-Tree索引在一个四字节整数上可以使用int4_ops；这个操作符类包括四字节整数的比较函数。实际上对于列上的数据类型默认的操作符类是足够用的。操作符类主要用于一些有多种排序的数据。例如，用户想按照绝对值或者实数部分排序一个复数。能通过定义两个操作符类然后在建立索引时选择合适的类。
ASC	指定按升序排序（默认）。本选项仅行存支持。	-
DESC	指定按降序排序。本选项仅行存支持。	-
NULLS FIRST	指定空值在排序中排在非空值之前，当指定DESC排序时，本选项为默认的。	-
NULLS LAST	指定空值在排序中排在非空值之后，未指定DESC排序时，本选项为默认的。	-
NULLS DISTINCT NULLS NOT DISTINCT NULLS IGNORE	指定Unique唯一索引中索引列NULL值的处理方式。	默认取值：该参数默认取值为空，即NULL值可重复插入。在对插入的新数据和表中原始数据进行列的等值比较时，对于NULL值有以下三种处理方式： NULLS DISTINCT：将每个NULL值视为不同的值，即允许NULL值重复插入。 NULLS NOT DISTINCT：将所有NULL值视为相同的值，即索引中只保留一个NULL值条目，不允许NULL值重复插入，只有非NULL值且与原索引列中已有数据不相等的数据可插入。 NULLS IGNORE：在等值比较时跳过NULL值。若索引列全为NULL，则NULL值可重复插入；部分索引列为NULL，只有非NULL值且与原索引列中已有数据不相等的数据可插入。三种处理方式具体的行为参见表4所示。
COMMENT 'text'	指定索引的注释信息。	-
WITH ( {storage_parameter = value} [, ... ] )	指定索引方法的存储参数。包括：FILLFACTOR、INVISIBLE、FASTUPDATE、GIN_PENDING_LIST_LIMIT。	取值范围和详细用法参见表3。
WHERE predicate	创建一个部分索引。部分索引是一个只包含表的一部分记录的索引，通常是该表中比其他部分数据更有用的部分。例如，有一个表，表里包含已记账和未记账的订单，未记账的订单只占表的一小部分而且这部分是最常用的部分，此时就可以通过只在未记账部分创建一个索引来改善性能。另外一个可能的用途是使用带有UNIQUE的WHERE强制一个表的某个子集的唯一性。	取值范围：predicate表达式只能引用表的字段，它可以使用所有字段，而不仅是被索引的字段。目前，子查询和聚集表达式不能出现在WHERE子句里。
LOCAL	本地索引（分区索引），即在分区表的每个区上单独创建索引，本地索引与分区表的分区一一对应，具有与其表相同的分区数和相同的分区范围。当表分区发生变化时，只需维护对应的索引分区。	-
PARTITION index_partition_name	索引分区的名称。	取值范围：字符串，要符合标识符的命名规范。

表3 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，以提高存储空间利用率。

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定B-Tree索引，并指定该索引的填充因子FILLFACTOR为70%。

这意味着每个数据页面在初次填充时只会填满70%。剩余的30%空间留给将来的插入和更新操作。

          
             CREATE INDEX ds_ship_mode_t1_index6 ON tpcds.ship_mode_t1 USING btree(SM_SHIP_MODE_SK) WITH (FILLFACTOR = 70);

INVISIBLE

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

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

取值范围：

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

默认值：OFF

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定B-Tree索引，并设置优化器不生成该索引扫描相关计划

          
             CREATE INDEX ds_ship_mode_t1_index7 ON tpcds.ship_mode_t1 USING btree(SM_SHIP_MODE_SK) WITH (INVISIBLE = ON);

FASTUPDATE

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

取值范围：ON，OFF

默认值：ON

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定GIN索引，并打开快速更新参数FASTUPDATE，设置该索引Pending List容量的最大值为8MB。

CREATE INDEX ds_ship_mode_t1_index8 ON tpcds.ship_mode_t1 USING gin(SM_SHIP_MODE_SK) WITH (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）。

表4 唯一索引中索引列NULL值的处理方式
字段控制	索引列全为NULL	部分索引列为NULL
NULLS DISTINCT	可重复插入。	可重复插入。
NULLS NOT DISTINCT	不可重复插入。	非NULL值相等，不可插入；非NULL值不相等，则插入成功。
NULLS IGNORE	可重复插入。	非NULL值相等，不可插入；非NULL值不相等，则插入成功。

示例

创建示例表tpcds.ship_mode_t1：

       
        
          
          CREATE SCHEMA tpcds;
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字段上创建唯一索引：

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

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建UNIQUE唯一索引，并指定NULL值的处理方式：

       
          CREATE UNIQUE INDEX ds_ship_mode_t1_index5 ON tpcds.ship_mode_t1(SM_SHIP_MODE_SK) NULLS NOT DISTINCT;

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建索引时添加索引的注释。

       
          CREATE INDEX ds_ship_mode_t1_index_comment ON tpcds.ship_mode_t1(SM_SHIP_MODE_SK) COMMENT 'index';

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定B-Tree索引。

1	CREATE INDEX ds_ship_mode_t1_index4 ON tpcds.ship_mode_t1 USING btree(SM_SHIP_MODE_SK);

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定B-Tree索引，并指定该索引的填充因子FILLFACTOR为70%。

       
          CREATE INDEX ds_ship_mode_t1_index6 ON tpcds.ship_mode_t1 USING btree(SM_SHIP_MODE_SK) WITH (FILLFACTOR = 70);

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定B-Tree索引，并设置优化器不生成该索引扫描相关计划(默认为OFF，表示生成，ON表示不生成)。

       
          CREATE INDEX ds_ship_mode_t1_index7 ON tpcds.ship_mode_t1 USING btree(SM_SHIP_MODE_SK) WITH (INVISIBLE = ON);

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建指定GIN索引，并打开快速更新参数FASTUPDATE，设置该索引Pending List容量的最大值为8MB。

CREATE INDEX ds_ship_mode_t1_index8 ON tpcds.ship_mode_t1 USING gin(SM_SHIP_MODE_SK) WITH (FASTUPDATE = ON, GIN_PENDING_LIST_LIMIT = 8192);

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

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

在表tpcds.ship_mode_t1上的SM_SHIP_MODE_SK字段上创建SM_SHIP_MODE_SK大于10的部分索引。

CREATE UNIQUE INDEX ds_ship_mode_t1_index3 ON tpcds.ship_mode_t1(SM_SHIP_MODE_SK) WHERE SM_SHIP_MODE_SK>10;

创建示例表tpcds.customer_address_p1。

       
        
          
          CREATE TABLE tpcds.customer_address_p1
(
    CA_ADDRESS_SK             INTEGER               NOT NULL,
    CA_ADDRESS_ID             CHAR(16)              NOT NULL,
    CA_STREET_NUMBER          CHAR(10)                      ,
    CA_STREET_NAME            VARCHAR(60)                   ,
    CA_STREET_TYPE            CHAR(15)                      ,
    CA_SUITE_NUMBER           CHAR(10)                      ,
    CA_CITY                   VARCHAR(60)                   ,
    CA_COUNTY                 VARCHAR(30)                   ,
    CA_STATE                  CHAR(2)                       ,
    CA_ZIP                    CHAR(10)                      ,
    CA_COUNTRY                VARCHAR(20)                   ,
    CA_GMT_OFFSET             DECIMAL(5,2)                  ,
    CA_LOCATION_TYPE          CHAR(20)
)
DISTRIBUTE BY HASH(CA_ADDRESS_SK)
PARTITION BY RANGE(CA_ADDRESS_SK)
( 
   PARTITION p1 VALUES LESS THAN (3000),
   PARTITION p2 VALUES LESS THAN (5000) ,
   PARTITION p3 VALUES LESS THAN (MAXVALUE) 
)
ENABLE ROW MOVEMENT;

         

       
      

创建分区表索引ds_customer_address_p1_index1，不指定索引分区的名字。

       
          CREATE INDEX ds_customer_address_p1_index1 ON tpcds.customer_address_p1(CA_ADDRESS_SK) LOCAL;

创建分区表索引ds_customer_address_p1_index2，并指定索引分区的名字。

       
          CREATE INDEX ds_customer_address_p1_index2 ON tpcds.customer_address_p1(CA_ADDRESS_SK) LOCAL
(
    PARTITION CA_ADDRESS_SK_index1,
    PARTITION CA_ADDRESS_SK_index2,
    PARTITION CA_ADDRESS_SK_index3 
) 
;

创建分区表索引ds_customer_address_p1_index_comment，并添加索引注释。

       
          CREATE INDEX ds_customer_address_p1_index_comment ON tpcds.customer_address_p1(CA_ADDRESS_SK) COMMENT 'index' LOCAL
(
    PARTITION CA_ADDRESS_SK_index1,
    PARTITION CA_ADDRESS_SK_index2,
    PARTITION CA_ADDRESS_SK_index3 
) 
;

关于NULLS DISTINCT、NULLS NOT DISTINCT、NULLS IGNORE使用上的场景差异

以下是举例说明这3个参数的使用差异，便于理解。

示例

假设我们有一张表users，包含id和email（可能为 NULL，表示未提供邮箱）。

场景 1：默认 NULLS DISTINCT（NULL可重复插入）

       
        
          
          -- 创建表
DROP TABLE IF EXISTS users;
CREATE TABLE users (
  id INT,
  email TEXT
)
DISTRIBUTE BY HASH(email);
-- 创建唯一索引（默认 NULLS DISTINCT）
CREATE UNIQUE INDEX idx_email_unique ON users (email);
-- 插入数据
INSERT INTO users (id, email) VALUES (1, NULL); -- 成功
INSERT INTO users (id, email) VALUES (2, NULL); -- 成功（NULL 被视为不同）
INSERT INTO users (id, email) VALUES (3, 'a@example.com'); -- 成功
INSERT INTO users (id, email) VALUES (4, 'a@example.com'); -- 失败（非 NULL 重复）

         

       
      

场景 2：NULLS NOT DISTINCT（NULL不可重复插入）

       
        
          
          -- 重新创建唯一索引，指定NULLS NOT DISTINCT
DROP TABLE IF EXISTS users;
CREATE TABLE users (
  id INT,
  email TEXT
)
DISTRIBUTE BY HASH(email);
CREATE UNIQUE INDEX idx_email_unique ON users (email) NULLS NOT DISTINCT;
-- 插入数据
INSERT INTO users (id, email) VALUES (5, NULL); -- 成功（第一个 NULL）
INSERT INTO users (id, email) VALUES (6, NULL); -- 失败（第二个 NULL，违反唯一约束）
INSERT INTO users (id, email) VALUES (7, 'b@example.com'); -- 成功
INSERT INTO users (id, email) VALUES (8, 'b@example.com'); -- 失败（非 NULL 重复）

         

       
      

场景 3：NULLS IGNORE（忽略NULL值）

       
        
          
          -- 创建索引，忽略NULL值
DROP TABLE IF EXISTS users;
CREATE TABLE users (
  id INT,
  email TEXT
)
DISTRIBUTE BY HASH(email);
CREATE UNIQUE INDEX idx_email_ignore ON users (email) NULLS IGNORE;
-- 插入数据
INSERT INTO users (id, email) VALUES (9, NULL); -- 成功（第一个 NULL）
INSERT INTO users (id, email) VALUES (10, NULL); -- 成功（NULL值被忽略）
INSERT INTO users (id, email) VALUES (11, 'c@example.com'); -- 成功
INSERT INTO users (id, email) VALUES (12, 'c@example.com'); -- 失败（非 NULL 重复）

         

       
      

常见问题

父主题： DDL语法

上一篇：CREATE GROUP

下一篇：CREATE MATERIALIZED VIEW

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问