首批通过分布式安全可靠测评，为关键业务系统打造
创建分区表
更新时间：2026-06-13 16:22:25
编辑
分享
您可以根据业务需求，创建相应类型的一级分区表或二级分区表。
支持的分区类型
OceanBase 数据库一级分区支持的分区类型如下：Range 分区、Range Columns 分区、List 分区、List Columns 分区、Hash 分区及 Key 分区。
OceanBase 数据库二级分区为任意两种分区类型的组合，具体支持情况如下：
| 二级分区类型 | 模板化二级分区表 | 非模板化二级分区表 |
|---|---|---|
| Range + Range / Range + Range Columns / Range + List / Range + List Columns / Range + Hash / Range + Key | 支持 | 支持 |
| Range Columns + Range / Range Columns + Range Columns / Range Columns + List / Range Columns + List Columns / Range Columns + Hash / Range Columns + Key | 支持 | 支持 |
| List + Range / List + Range Columns / List + List / List + List Columns / List + Hash / List + Key | 支持 | 支持 |
| List Columns + Range / List Columns + Range Columns / List Columns + List / List Columns + List Columns / List Columns + Hash / List Columns + Key | 支持 | 支持 |
| Hash + Range / Hash + Range Columns / Hash + List / Hash + List Columns / Hash + Hash / Hash + Key | 支持 | 支持 |
| Key + Range / Key + Range Columns / Key + List / Key + List Columns / Key + Hash /Key + Key | 支持 | 支持 |
创建 Range/Range Columns 分区的一级分区表
语法
CREATE TABLE table_name (column_name column_type[, column_name column_type])
PARTITION BY { RANGE (expr(column_name) | column_name)
| RANGE COLUMNS(column_name [,column_name])
}
(
PARTITION partition_name VALUES LESS THAN(expr)
[, PARTITION partition_name VALUES LESS THAN (expr )...]
[, PARTITION partition_name VALUES LESS THAN (MAXVALUE)]
);
在创建 Range 分区时，需要遵循以下规则：
PARTITION BY RANGE ( expr )里的expr表达式的结果必须为整型。如果要按时间类型列做 Range 分区，则必须将时间类型转换为数值。每个分区都有一个
VALUES LESS THAN子句，它为分区指定一个非包含的上限值。分区键的任何值等于或大于这个值时将被映射到下一个分区中。除第一个分区外，所有分区都隐含一个下限值，即上一个分区的上限值。
仅允许最后一个分区的上限定义为
MAXVALUE，这个值没有具体的数值，并且比其他所有分区的上限都要大，也包含空值。如果最后一个 Range 分区指定了MAXVALUE，则不能新增分区。
参数解释
| 参数 | 描述 |
|---|---|
| table_name | 指定表名。 |
| column_name | 指定列名称。 |
| column_type | 指定列的数据类型。 |
| partition_name | 指定分区名称。 |
示例
创建一个 Range 分区表
tbl1_log_r。obclient> CREATE TABLE tbl1_r (log_id BIGINT NOT NULL,log_value VARCHAR(50),log_date TIMESTAMP NOT NULL) PARTITION BY RANGE(UNIX_TIMESTAMP(log_date)) (PARTITION M202001 VALUES LESS THAN(UNIX_TIMESTAMP('2020/02/01')) , PARTITION M202002 VALUES LESS THAN(UNIX_TIMESTAMP('2020/03/01')) , PARTITION M202003 VALUES LESS THAN(UNIX_TIMESTAMP('2020/04/01')) , PARTITION M202004 VALUES LESS THAN(UNIX_TIMESTAMP('2020/05/01')) , PARTITION M202005 VALUES LESS THAN(UNIX_TIMESTAMP('2020/06/01')) , PARTITION M202006 VALUES LESS THAN(UNIX_TIMESTAMP('2020/07/01')) , PARTITION M202007 VALUES LESS THAN(UNIX_TIMESTAMP('2020/08/01')) , PARTITION M202008 VALUES LESS THAN(UNIX_TIMESTAMP('2020/09/01')) , PARTITION M202009 VALUES LESS THAN(UNIX_TIMESTAMP('2020/10/01')) , PARTITION M202010 VALUES LESS THAN(UNIX_TIMESTAMP('2020/11/01')) , PARTITION M202011 VALUES LESS THAN(UNIX_TIMESTAMP('2020/12/01')) , PARTITION M202012 VALUES LESS THAN(UNIX_TIMESTAMP('2021/01/01')) ); Query OK, 0 rows affected创建一个 Range Columns 分区表
tbl1_log_rc。obclient> CREATE TABLE tbl1_log_rc (log_id BIGINT NOT NULL,log_value VARCHAR(50),log_date DATE NOT NULL) PARTITION BY RANGE COLUMNS(log_date) (PARTITION M202001 VALUES LESS THAN('2020/02/01') , PARTITION M202002 VALUES LESS THAN('2020/03/01') , PARTITION M202003 VALUES LESS THAN('2020/04/01') , PARTITION M202004 VALUES LESS THAN('2020/05/01') , PARTITION M202005 VALUES LESS THAN('2020/06/01') , PARTITION M202006 VALUES LESS THAN('2020/07/01') , PARTITION M202007 VALUES LESS THAN('2020/08/01') , PARTITION M202008 VALUES LESS THAN('2020/09/01') , PARTITION M202009 VALUES LESS THAN('2020/10/01') , PARTITION M202010 VALUES LESS THAN('2020/11/01') , PARTITION M202011 VALUES LESS THAN('2020/12/01') , PARTITION M202012 VALUES LESS THAN('2021/01/01') , PARTITION MMAX VALUES LESS THAN MAXVALUE ); Query OK, 0 rows affected
创建 List/List Columns 分区的一级分区表
语法
CREATE TABLE table_name (column_name column_type[,column_name column_type])
PARTITION BY { LIST ( expr(column_name) | column_name )
| LIST COLUMNS ( column_name [,column_name])
}
(PARTITION partition_name VALUES IN ( v01 [, v0N])
[,PARTITION partition_name VALUES IN ( vN1 [, vNN])]
[,PARTITION partition_name VALUES IN (DEFAULT)]
);
注意
当使用 List 分区时，需要遵循以下规则：
分区表达式的结果必须是整型。
分区表达式只能引用一列，不能有多列（即列向量）。
参数解释
| 参数 | 描述 |
|---|---|
| table_name | 指定表名。 |
| column_name | 指定列名称。 |
| column_type | 指定列的数据类型。 |
| partition_name | 指定分区名称。 |
| DEFAULT | 仅允许最后一个分区指定这个值，这个值没有具体的数值，并且比其他所有分区的上限都要大，也包含空值。 |
示例
创建一个 List 分区表
tbl1_l。obclient> CREATE TABLE tbl1_l (col1 BIGINT PRIMARY KEY,col2 VARCHAR(50)) PARTITION BY LIST(col1) (PARTITION p0 VALUES IN (1, 2, 3), PARTITION p1 VALUES IN (5, 6), PARTITION p2 VALUES IN (DEFAULT) ); Query OK, 0 rows affected创建一个 List Columns 分区表。
obclient> CREATE TABLE tbl1_lc (id INT,partition_id VARCHAR(2)) PARTITION BY LIST COLUMNS(partition_id) (PARTITION p0 VALUES IN ('00','01'), PARTITION p1 VALUES IN ('02','03'), PARTITION p2 VALUES IN (DEFAULT) ); Query OK, 0 rows affected
创建 Hash/Key 分区的一级分区表
语法
CREATE TABLE table_name (column_name column_type[,column_name column_type])
PARTITION BY { HASH(expr) | KEY([column_name_list]) }
PARTITIONS partition_count;
参数解释
| 参数 | 描述 |
|---|---|
| table_name | 指定表名。 |
| column_name | 指定列名。 |
| column_type | 指定列的数据类型。 |
| expr | 指定 Hash 分区表达式。 |
| column_name_list | 指定 Key 分区列名称列表。 |
| partition_count | 指定分区个数。 |
示例
创建一个 Hash 分区表
tbl1_h。obclient> CREATE TABLE tbl1_h(col1 INT,col2 VARCHAR(50)) PARTITION BY HASH(col1) PARTITIONS 60; Query OK, 0 rows affected创建一个 Key 分区表
tbl1_k。obclient> CREATE TABLE tbl1_k(id INT,gmt_create DATETIME,info VARCHAR(20)) PARTITION BY KEY(id,gmt_create) PARTITIONS 10; Query OK, 0 rows affected
创建模板化二级分区表
OceanBase 数据库目前支持 Hash、Range、 List、Key、Range Columns 和 List Columns 六种分区类型，二级分区为任意两种分区类型的组合。
创建模板化二级分区表的 SQL 语法如下：
CREATE TABLE [IF NOT EXISTS] table_name(column_option_list)
[table_option_list] partition_option_list;
column_option_list:
column_name column_type [, column_name column_type]
table_option_list:
table_option [table_option]
table_option:
LOCALITY [=] locality_name
| PRIMARY_ZONE [=] primary_zone_name
partition_option_list:
PARTITION BY
RANGE {(expression) | COLUMNS (column_name_list)}{subpartition_option} (range_partition_list)
| LIST {(expression) | COLUMNS (column_name_list)}{subpartition_option} (list_partition_list)
| HASH(expression) {subpartition_option} { (hash_partition_list)
| PARTITIONS partition_count }
| KEY(column_name_list) {subpartition_option} { (key_partition_list)
| PARTITIONS partition_count }
subpartition_option:
SUBPARTITION BY
RANGE {(expression) | COLUMNS (column_name_list)} SUBPARTITION TEMPLATE (range_subpartition_list)
| LIST {(expression) | COLUMNS (column_name_list)} SUBPARTITION TEMPLATE (list_subpartition_list)
| HASH(expression) { SUBPARTITION TEMPLATE (hash_subpartition_list)
| SUBPARTITIONS subpartition_count}
| KEY(column_name_list) { SUBPARTITION TEMPLATE (key_subpartition_list)
| SUBPARTITIONS subpartition_count}
range_partition_list:
range_partition [, range_partition ...]
range_partition:
PARTITION partition_name VALUES LESS THAN {(expression_list) | MAXVALUE}
range_subpartition_list:
range_subpartition [, range_subpartition ...]
range_subpartition:
SUBPARTITION subpartition_name VALUES LESS THAN {(expression_list) | MAXVALUE}
list_partition_list:
list_partition [, list_partition ...]
list_partition:
PARTITION partition_name VALUES IN {(expression_list) | DEFAULT}
list_subpartition_list:
list_subpartition [, list_subpartition ...]
list_subpartition:
SUBPARTITION subpartition_name VALUES IN {(expression_list) | DEFAULT}
hash_partition_list:
hash_partition [, hash_partition ...]
key_partition_list:
key_partition [, key_partition ...]
hash_partition | key_partition:
PARTITION partition_name
hash_subpartition_list:
hash_subpartition [, hash_subpartition ...]
key_subpartition_list:
key_subpartition [, key_subpartition ...]
hash_subpartition | key_subpartition:
SUBPARTITION subpartition_name
expression_list:
expression [, expression ...]
column_name_list:
column_name [, column_name ...]
partition_count | subpartition_count:
INT_VALUE
说明
模板化二级分区表的每个一级分区下的二级分区都按照模板中的二级分区定义，即每个一级分区下的二级分区定义均相同。
对于模板化二级分区表来说，二级分区的命名规则为
($part_name)s($subpart_name)。例如：对于下⾯的tbl_rr表，一级分区p0下的 3 个二级分区的分区名分别为p0smp1、p0smp2、p0smp3。
obclient> CREATE TABLE tbl_rr(col1 INT,col2 INT,col3 INT)
PARTITION BY RANGE(col1)
SUBPARTITION BY RANGE(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION mp1 VALUES LESS THAN(100),
SUBPARTITION mp2 VALUES LESS THAN(200),
SUBPARTITION mp3 VALUES LESS THAN(300)
)
(PARTITION p0 VALUES LESS THAN(100),
PARTITION p1 VALUES LESS THAN(200),
PARTITION p2 VALUES LESS THAN(300)
);
Query OK, 0 rows affected
部分参数说明如下表所示：
| 参数 | 说明 |
|---|---|
| table_name | 指定表名。 |
| column_name | 指定列名。 |
| column_type | 指定列数据类型。 |
| locality_name | 指定副本在 Zone 间的分布情况。例如：F@z1,F@z2,F@z3,F@z4 表示 z1、 z2、z3 、z4 为全功能副本。 |
| primary_zone_name | 指定主 Zone（副本 Leader 所在 Zone）。 |
| partition_name | 指定一级分区名称。 |
| subpartition_name | 指定二级分区名称。 |
| INT_VALUE | 指定 hash 或 Key 类型的二级分区个数。 |
创建 Range Columns + Range 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_rcr (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY RANGE(col3)
SUBPARTITION TEMPLATE
(SUBPARTITION mp0 VALUES LESS THAN(1000),
SUBPARTITION mp1 VALUES LESS THAN(2000),
SUBPARTITION mp2 VALUES LESS THAN(3000)
)
(PARTITION p0 VALUES LESS THAN(100),
PARTITION p1 VALUES LESS THAN(200),
PARTITION p2 VALUES LESS THAN(300)
);
创建 Range Columns + Range Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t_m_rcrc(col1 INT,col2 INT)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY RANGE COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION mp0 VALUES LESS THAN(1000),
SUBPARTITION mp1 VALUES LESS THAN(2000),
SUBPARTITION mp2 VALUES LESS THAN(3000)
)
(PARTITION p0 VALUES LESS THAN(100),
PARTITION p1 VALUES LESS THAN(200),
PARTITION p2 VALUES LESS THAN(300)
);
Query OK, 0 rows affected
创建 Range Columns + List Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t_m_rclc(col1 INT,col2 INT)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY LIST COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION mp0 VALUES IN(1,3),
SUBPARTITION mp1 VALUES IN(4,6),
SUBPARTITION mp2 VALUES IN(7)
)
(PARTITION p0 VALUES LESS THAN(100),
PARTITION p1 VALUES LESS THAN(200),
PARTITION p2 VALUES LESS THAN(300)
);
Query OK, 0 rows affected
创建 Range Columns + Hash 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_rch(col1 INT,col2 INT)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY HASH(col2) SUBPARTITIONS 5
(PARTITION p0 VALUES LESS THAN(100),
PARTITION p1 VALUES LESS THAN(200),
PARTITION p2 VALUES LESS THAN(300)
);
Query OK, 0 rows affected
创建 Range Columns + Key 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_rck(col1 INT,col2 INT)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY KEY(col2) SUBPARTITIONS 3
(PARTITION p0 VALUES LESS THAN(100),
PARTITION p1 VALUES LESS THAN(200),
PARTITION p2 VALUES LESS THAN(300)
);
Query OK, 0 rows affected
创建 List + Range 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lr(col1 INT,col2 INT)
PARTITION BY LIST (col1)
SUBPARTITION BY RANGE(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION mp0 VALUES LESS THAN(100),
SUBPARTITION mp1 VALUES LESS THAN(200),
SUBPARTITION mp2 VALUES LESS THAN(300)
)
(PARTITION p0 VALUES IN(1,3),
PARTITION p1 VALUES IN(4,6),
PARTITION p2 VALUES IN(7,9)
);
Query OK, 0 rows affected
创建 List + Hash 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lh (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY LIST (col1)
SUBPARTITION BY HASH(col3) SUBPARTITIONS 3
(PARTITION p0 VALUES IN(100),
PARTITION p1 VALUES IN(200),
PARTITION p2 VALUES IN(300)
);
Query OK, 0 rows affected
创建 List + Key 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lk (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY LIST(col1)
SUBPARTITION BY KEY(col3) SUBPARTITIONS 3
(PARTITION p0 VALUES IN(100),
PARTITION p1 VALUES IN(200),
PARTITION p2 VALUES IN(300)
);
创建 List Columns + Range Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lcrc(col1 INT,col2 INT)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY RANGE COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION mp0 VALUES LESS THAN(100),
SUBPARTITION mp1 VALUES LESS THAN(200),
SUBPARTITION mp2 VALUES LESS THAN(300)
)
(PARTITION p0 VALUES IN(1,3),
PARTITION p1 VALUES IN(4,6),
PARTITION p2 VALUES IN(7,9)
);
Query OK, 0 rows affected
创建 List Columns + List Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lclc(col1 INT,col2 INT)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY LIST COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION mp0 VALUES IN(2),
SUBPARTITION mp1 VALUES IN(5),
SUBPARTITION mp2 VALUES IN(8)
)
(PARTITION p0 VALUES IN(1,3),
PARTITION p1 VALUES IN(4,6),
PARTITION p2 VALUES IN(7,9)
);
Query OK, 0 rows affected
创建 List Columns + Hash 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lch(col1 INT,col2 INT)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY HASH(col2) SUBPARTITIONS 5
(PARTITION p0 VALUES IN(100),
PARTITION p1 VALUES IN(200),
PARTITION p2 VALUES IN(300)
);
Query OK, 0 rows affected
创建 List Columns + Key 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_m_lck(col1 INT,col2 INT)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY KEY(col2)
SUBPARTITIONS 3
(PARTITION p0 VALUES IN(100),
PARTITION p1 VALUES IN(200),
PARTITION p2 VALUES IN(300)
);
Query OK, 0 rows affected
创建 Hash + Range Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_hrc(col1 INT,col2 INT,col3 INT)
PARTITION BY HASH(col1)
SUBPARTITION BY RANGE COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION p0 VALUES LESS THAN(100),
SUBPARTITION p1 VALUES LESS THAN(200),
SUBPARTITION p2 VALUES LESS THAN(300)
)
PARTITIONS 5;
创建 Hash + List Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_hlc(col1 INT,col2 INT,col3 INT)
PARTITION BY HASH(col1)
SUBPARTITION BY LIST COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION p0 VALUES IN(1,3),
SUBPARTITION p1 VALUES IN(4,6),
SUBPARTITION p2 VALUES IN(7,9)
)
PARTITIONS 5;
创建 Hash + Hash 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_hh(col1 INT,col2 INT,col3 INT)
PARTITION BY HASH(col1)
SUBPARTITION BY HASH(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2
)
PARTITIONS 5;
Query OK, 0 rows affected
创建 Hash + Key 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_hh(col1 INT,col2 INT,col3 INT)
PARTITION BY HASH(col1)
SUBPARTITION BY KEY(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2
)
PARTITIONS 5;
Query OK, 0 rows affected
创建 Key + Range Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_krc(col1 INT,col2 INT,col3 INT)
PARTITION BY KEY(col1)
SUBPARTITION BY RANGE COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION sp0 VALUES LESS THAN(100),
SUBPARTITION sp1 VALUES LESS THAN(200),
SUBPARTITION sp2 VALUES LESS THAN(300)
)
(PARTITION p0,
PARTITION p1,
PARTITION p2
);
Query OK, 0 rows affected
创建 Key + List Columns 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_klc(col1 INT,col2 INT,col3 INT)
PARTITION BY KEY(col1)
SUBPARTITION BY LIST COLUMNS(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION p0 VALUES IN(1,3),
SUBPARTITION p1 VALUES IN(4,6),
SUBPARTITION p2 VALUES IN(7,9)
)
PARTITIONS 5;
Query OK, 0 rows affected
创建 Key + Key 分区的模板化二级分区表
示例如下：
obclient> CREATE TABLE tbl2_m_kk(col1 INT,col2 INT,col3 INT)
PARTITION BY KEY(col1)
SUBPARTITION BY KEY(col2)
SUBPARTITION TEMPLATE
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2
)
PARTITIONS 5;
Query OK, 0 rows affected
创建非模板化二级分区表
OceanBase 数据库目前支持 Hash、Range、 List、Key、Range Columns 和 List Columns 六种分区类型，二级分区为任意两种分区类型的组合。
创建非模板化二级分区表的 SQL 语法如下：
CREATE TABLE [IF NOT EXISTS] table_name(column_option_list)
[table_option_list] [partition_option_list];
column_option_list:
column_name column_type [, column_name column_type]
table_option_list:
table_option [table_option]
table_option:
LOCALITY [=] locality_name
| PRIMARY_ZONE [=] primary_zone_name
partition_option_list:
PARTITION BY
RANGE {(expression) | COLUMNS (column_name_list)}{subpartition_option}
{ range_partition_option (subpartition_option_list)
[, range_partition_option (subpartition_option_list)]...
}
| LIST {(expression) | COLUMNS (column_name_list)}{subpartition_option}
{ list_partition_option (subpartition_option_list)
[, list_partition_option (subpartition_option_list)]...
}
| HASH(expression) {subpartition_option}
{ hash_partition_option (subpartition_option_list)
[, hash_partition_option (subpartition_option_list)]...
}
| KEY(column_name_list) {subpartition_option}
{ key_partition_option (subpartition_option_list)
[, key_partition_option (subpartition_option_list)]
}
subpartition_option:
SUBPARTITION BY
RANGE {(expression) | COLUMNS (column_name_list)}
| LIST {(expression) | COLUMNS (column_name_list)}
| HASH (expression)
| KEY(column_name_list)
subpartition_option_list:
range_partition_option_list
| list_partition_option_list
| hash_partition_option_list
| key_partition_option_list
range_partition_option_list:
range_partition_option [, range_partition_option ]...
list_partition_option_list:
list_partition_option [, list_partition_option ]...
hash_partition_option_list:
hash_partition_option [, hash_partition_option ]...
key_partition_option_list:
key_partition_option [, key_partition_option ]...
range_partition_option:
SUBPARTITION subpartition_name VALUES LESS THAN range_partition_expr
[,SUBPARTITION subpartition_name VALUES LESS THAN range_partition_expr]...
list_partition_option:
SUBPARTITION subpartition_name VALUES IN list_partition_expr
[, SUBPARTITION subpartition_name VALUES IN list_partition_expr]...
hash_partition_option_list:
SUBPARTITION subpartition_name
[, SUBPARTITION subpartition_name]...
key_partition_option_list:
SUBPARTITION subpartition_name
[, SUBPARTITION subpartition_name]...
部分参数的说明如下表所示：
| 参数 | 说明 |
|---|---|
| table_name | 指定表名。 |
| column_name | 指定列名。 |
| column_type | 指定列数据类型。 |
| locality_name | 指定副本在 Zone 间的分布情况。例如：F@z1,F@z2,F@z3,F@z4 表示 z1、 z2、z3、z4 为全功能副本。 |
| primary_zone_name | 指定主 Zone（副本 Leader 所在 Zone）。 |
| partition_name | 指定一级分区名称。 |
| subpartition_name | 指定二级分区名称。 |
| INT_VALUE | 指定 hash 或 Key 类型的二级分区个数。 |
创建 Range + Range 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_rr(col1 INT,col2 TIMESTAMP)
PARTITION BY RANGE(col1)
SUBPARTITION BY RANGE(UNIX_TIMESTAMP(col2))
(PARTITION p0 VALUES LESS THAN(100)
(SUBPARTITION sp0 VALUES LESS THAN(UNIX_TIMESTAMP('2021/04/01')),
SUBPARTITION sp1 VALUES LESS THAN(UNIX_TIMESTAMP('2021/07/01')),
SUBPARTITION sp2 VALUES LESS THAN(UNIX_TIMESTAMP('2021/10/01')),
SUBPARTITION sp3 VALUES LESS THAN(UNIX_TIMESTAMP('2022/01/01'))
),
PARTITION p1 VALUES LESS THAN(200)
(SUBPARTITION sp4 VALUES LESS THAN(UNIX_TIMESTAMP('2021/04/01')),
SUBPARTITION sp5 VALUES LESS THAN(UNIX_TIMESTAMP('2021/07/01')),
SUBPARTITION sp6 VALUES LESS THAN(UNIX_TIMESTAMP('2021/10/01')),
SUBPARTITION sp7 VALUES LESS THAN(UNIX_TIMESTAMP('2022/01/01'))
)
);
Query OK, 0 rows affected
创建 Range + List Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_rlc (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY RANGE(col1)
SUBPARTITION BY LIST COLUMNS(col3)
(PARTITION p0 VALUES LESS THAN(100)
(SUBPARTITION sp0 VALUES IN(1,3),
SUBPARTITION sp1 VALUES IN(4,6),
SUBPARTITION sp2 VALUES IN(7,9)),
PARTITION p1 VALUES LESS THAN(200)
(SUBPARTITION sp3 VALUES IN(1,3),
SUBPARTITION sp4 VALUES IN(4,6),
SUBPARTITION sp5 VALUES IN(7,9))
);
Query OK, 0 rows affected
创建 Range Columns + Range Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_rcrc (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY RANGE COLUMNS(col3)
(PARTITION p0 VALUES LESS THAN(100)
(SUBPARTITION sp0 VALUES LESS THAN(1000),
SUBPARTITION sp1 VALUES LESS THAN(2000),
SUBPARTITION sp2 VALUES LESS THAN(3000)),
PARTITION p1 VALUES LESS THAN(200)
(SUBPARTITION sp3 VALUES LESS THAN(1000),
SUBPARTITION sp4 VALUES LESS THAN(2000),
SUBPARTITION sp5 VALUES LESS THAN(3000)),
PARTITION p2 VALUES LESS THAN(300)
(SUBPARTITION sp6 VALUES LESS THAN(1000),
SUBPARTITION sp7 VALUES LESS THAN(2000),
SUBPARTITION sp8 VALUES LESS THAN(3000))
);
Query OK, 0 rows affected
创建 Range Columns + List Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_rclc (col1 INT,col2 INT)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY LIST COLUMNS(col2)
(PARTITION p0 VALUES LESS THAN(100)
(SUBPARTITION sp0 VALUES IN(1,3),
SUBPARTITION sp1 VALUES IN(4,6),
SUBPARTITION sp2 VALUES IN(7,9)),
PARTITION p1 VALUES LESS THAN(200)
(SUBPARTITION sp3 VALUES IN(1,3),
SUBPARTITION sp4 VALUES IN(4,6),
SUBPARTITION sp5 VALUES IN(7,9))
);
Query OK, 0 rows affected
创建 Range Columns + Hash 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_rch (col1 INT,col2 INT)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY HASH(col2)
(PARTITION p0 VALUES LESS THAN(100)
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2),
PARTITION p1 VALUES LESS THAN(200)
(SUBPARTITION sp3,
SUBPARTITION sp4,
SUBPARTITION sp5)
);
Query OK, 0 rows affected
创建 Range Columns + Key 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_rck (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY RANGE COLUMNS(col1)
SUBPARTITION BY KEY(col3)
(PARTITION p0 VALUES LESS THAN(100)
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2),
PARTITION p1 VALUES LESS THAN(200)
(SUBPARTITION sp3,
SUBPARTITION sp4,
SUBPARTITION sp5)
);
Query OK, 0 rows affected
创建 List + Range Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_lrc(col1 INT,col2 TIMESTAMP)
PARTITION BY LIST(col1)
SUBPARTITION BY RANGE COLUMNS(UNIX_TIMESTAMP(col2))
(PARTITION p0 VALUES IN(100)
(SUBPARTITION sp0 VALUES LESS THAN(UNIX_TIMESTAMP('2021/04/01')),
SUBPARTITION sp1 VALUES LESS THAN(UNIX_TIMESTAMP('2021/07/01')),
SUBPARTITION sp2 VALUES LESS THAN(UNIX_TIMESTAMP('2021/10/01')),
SUBPARTITION sp3 VALUES LESS THAN(UNIX_TIMESTAMP('2022/01/01'))
),
PARTITION p1 VALUES IN(200)
(SUBPARTITION sp4 VALUES LESS THAN(UNIX_TIMESTAMP('2021/04/01')),
SUBPARTITION sp5 VALUES LESS THAN(UNIX_TIMESTAMP('2021/07/01')),
SUBPARTITION sp6 VALUES LESS THAN(UNIX_TIMESTAMP('2021/10/01')),
SUBPARTITION sp7 VALUES LESS THAN(UNIX_TIMESTAMP('2022/01/01'))
)
);
Query OK, 0 rows affected
创建 List + List Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_llc(col1 INT,col2 TIMESTAMP)
PARTITION BY LIST(col1)
SUBPARTITION BY LIST COLUMNS(UNIX_TIMESTAMP(col2))
(PARTITION p0 VALUES IN(100)
(SUBPARTITION sp0 VALUES IN(UNIX_TIMESTAMP('2021/04/01')),
SUBPARTITION sp1 VALUES IN(UNIX_TIMESTAMP('2021/07/01')),
SUBPARTITION sp2 VALUES IN(UNIX_TIMESTAMP('2021/10/01')),
SUBPARTITION sp3 VALUES IN(UNIX_TIMESTAMP('2022/01/01'))
),
PARTITION p1 VALUES IN(200)
(SUBPARTITION sp4 VALUES IN(UNIX_TIMESTAMP('2021/04/01')),
SUBPARTITION sp5 VALUES IN(UNIX_TIMESTAMP('2021/07/01')),
SUBPARTITION sp6 VALUES IN(UNIX_TIMESTAMP('2021/10/01')),
SUBPARTITION sp7 VALUES IN(UNIX_TIMESTAMP('2022/01/01'))
)
);
Query OK, 0 rows affected
创建 List Columns+ Range Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_lcrc(col1 INT,col2 INT)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY RANGE COLUMNS(col2)
(PARTITION p0 VALUES IN(100)
(SUBPARTITION sp0 VALUES LESS THAN(1000),
SUBPARTITION sp1 VALUES LESS THAN(2000),
SUBPARTITION sp2 VALUES LESS THAN(3000),
SUBPARTITION sp3 VALUES LESS THAN(4000)
),
PARTITION p1 VALUES IN(200)
(SUBPARTITION sp4 VALUES LESS THAN(100),
SUBPARTITION sp5 VALUES LESS THAN(200),
SUBPARTITION sp6 VALUES LESS THAN(300),
SUBPARTITION sp7 VALUES LESS THAN(400)
)
);
Query OK, 0 rows affected
创建 List Columns + List Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_lclc(col1 INT,col2 INT)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY LIST COLUMNS(col2)
(PARTITION p0 VALUES IN(100)
(SUBPARTITION sp0 VALUES IN(1000),
SUBPARTITION sp1 VALUES IN(2000),
SUBPARTITION sp2 VALUES IN(3000),
SUBPARTITION sp3 VALUES IN(4000)
),
PARTITION p1 VALUES IN(200)
(SUBPARTITION sp4 VALUES IN(100),
SUBPARTITION sp5 VALUES IN(200),
SUBPARTITION sp6 VALUES IN(300),
SUBPARTITION sp7 VALUES IN(400)
)
);
Query OK, 0 rows affected
创建 List Columns + Hash 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_lch (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY HASH(col3)
(PARTITION p0 VALUES IN(100)
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2),
PARTITION p1 VALUES IN(200)
(SUBPARTITION sp3,
SUBPARTITION sp4,
SUBPARTITION sp5)
);
Query OK, 0 rows affected
创建 List Columns + Key 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_lck (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY LIST COLUMNS(col1)
SUBPARTITION BY KEY(col3)
(PARTITION p0 VALUES IN(100)
(SUBPARTITION sp0,
SUBPARTITION sp1,
SUBPARTITION sp2),
PARTITION p1 VALUES IN(200)
(SUBPARTITION sp3,
SUBPARTITION sp4,
SUBPARTITION sp5)
);
Query OK, 0 rows affected
创建 Hash + Range Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_hrc (col1 INT,col2 INT)
PARTITION BY KEY(col1)
SUBPARTITION BY RANGE COLUMNS(col2)
(PARTITION p1
(SUBPARTITION sp0 VALUES LESS THAN (2020)
,SUBPARTITION sp1 VALUES LESS THAN (2021)
,SUBPARTITION sp2 VALUES LESS THAN (2022)
,SUBPARTITION sp3 VALUES LESS THAN (2023)
),
PARTITION p2
(SUBPARTITION sp4 VALUES LESS THAN (2020)
,SUBPARTITION sp5 VALUES LESS THAN (2021)
,SUBPARTITION sp6 VALUES LESS THAN (2022)
,SUBPARTITION sp7 VALUES LESS THAN (2023)
)
);
Query OK, 0 rows affected
创建 Hash + List Columns 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_hlc (col1 INT,col2 INT)
PARTITION BY HASH(col1)
SUBPARTITION BY LIST COLUMNS(col2)
(PARTITION p1
(SUBPARTITION sp0 VALUES IN (2020)
,SUBPARTITION sp1 VALUES IN (2021)
,SUBPARTITION sp2 VALUES IN (2022)
,SUBPARTITION sp3 VALUES IN (2023)
),
PARTITION p2
(SUBPARTITION sp4 VALUES IN (2020)
,SUBPARTITION sp5 VALUES IN (2021)
,SUBPARTITION sp6 VALUES IN (2022)
,SUBPARTITION sp7 VALUES IN (2023)
)
);
Query OK, 0 rows affected
创建 Hash + Hash 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_hh (col1 INT NOT NULL,col2 varchar(50),col3 INT NOT NULL)
PARTITION BY HASH(col3)
SUBPARTITION BY HASH(col1)
( PARTITION p1
( SUBPARTITION sp0
, SUBPARTITION sp1
, SUBPARTITION sp2
, SUBPARTITION sp3
),
PARTITION p2
( SUBPARTITION sp4
, SUBPARTITION sp5
, SUBPARTITION sp6
, SUBPARTITION sp7
)
);
Query OK, 0 rows affected
创建 Hash + Key 分区的非模板化二级分区表
示例如下：
obclient> CREATE TABLE t2_f_hk (col1 INT,col2 INT)
PARTITION BY HASH(col1)
SUBPARTITION BY KEY(col2)
(PARTITION p1
(SUBPARTITION sp0
,SUBPARTITION sp1
,SUBPARTITION sp2
,SUBPARTITION sp3
),
PARTITION p2
(SUBPARTITION sp4
,SUBPARTITION sp5
,SUBPARTITION sp6
,SUBPARTITION sp7
)
);
Query OK, 0 rows affected
