文档首页/ 云数据库 TaurusDB/ 内核介绍/ 常见内核功能/ 分区表增强/ LIST DEFAULT HASH

更新时间：2024-12-16 GMT+08:00

LIST DEFAULT HASH

LIST DEFAULT HASH是在同一级别支持两种分区类型：LIST和HASH。前面是普通的LIST分区，不符合LIST分区规则的数据会放在DEFAULT分区里，DEFAULT分区如果有多个分区则根据HASH规则计算。LIST DEFAULT HASH分区类型常用在LIST VALUES分布不均匀以及无法全部枚举的场景。

前提条件

TaurusDB的内核版本大于等于2.0.54.240600。
设置特性开关rds_list_default_partition_enabled的值为ON。

使用限制

一级DEFAULT PARTITION支持一个或多个DEFAULT分区。
支持二级分区LIST+DEFAULT，但每个PARTITION仅支持一个二级DEFAULT分区。
一级分区一个DEFAULT分区的情况下，支持所有类型的二级分区。
一级分区多个DEFAULT分区的情况下，仅支持HASH或KEY二级分区。

参数说明

在参数配置页面通过设置参数rds_list_default_partition_enabled的值来启用或禁用LIST DEFAULT HASH功能。

表1 参数说明
参数名称	级别	说明
rds_list_default_partition_enabled	Global	LIST DEFAULT HASH功能控制开关。取值范围如下： ON: 启用LIST DEFAULT HASH功能。 OFF: 关闭LIST DEFAULT HASH功能。

创建LIST DEFAULT HASH分区表

语法

CREATE TABLE [ schema. ]table_name
 table_definition
   PARTITION BY LIST [COLUMNS] (expr)
   SUBPARTITION BY ...
   (list_partition_definition[, ..., list_partition_definition],
    default_partition_definition
   )

其中，default_partition_definition为：

PARTITION partition_name DEFAULT [PARTITIONS number]

每个分区的定义也可以包含二级分区，二级分区也支持使用LIST DEFAULT分区，定义如下：

SUBPARTITION subpartition_name DEFAULT

表2 参数说明
参数名称	参数说明
table_name	要创建的表名称。
partition_name	只有一个DEFAULT分区时，表示分区名称。不可与其他分区表重复。当有多个DEFAULT分区时，表示分区名称前缀。“partition_name+序号”表示分区名称。
subpartition_name	子分区名称。同一个表中不可重复，子分区最多只支持一个DEFAULT分区。
number	DEFAULT分区按照哈希规则分成number个分区，通过number指定分区个数。PARTITIONS number是可选项，不指定时，则默认为一个DEFAULT分区。

示例

创建单个DEFAULT分区示例如下：

CREATE TABLE list_default_tbl (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT);

创建多个DEFAULT分区示例如下：

CREATE TABLE list_default_hash (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

使用LIST COLUMNS示例如下：

CREATE TABLE t_goods
(
  country   VARCHAR(30),
  year      VARCHAR(60),
  goods     TEXT
) PARTITION BY LIST COLUMNS(country)
(
  PARTITION p1 VALUES IN ('China'),
  PARTITION p2 VALUES IN ('USA'),
  PARTITION p3 VALUES IN ('Asia'),
  PARTITION p3 VALUES IN ('India'),
  PARTITION p_deft DEFAULT PARTITIONS 5
);

通过explain查看分区：

EXPLAIN SELECT * FROM list_default_hash;

显示结果如下：

+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
| id | select_type | table             | partitions        | type | possible_keys | key  | key_len | ref  | rows | filtered | Extra |
+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
|  1 | SIMPLE      | list_default_hash | p0,p1,pd0,pd1,pd2 | ALL  | NULL          | NULL | NULL    | NULL |    1 |   100.00 | NULL  |
+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
1 row in set (0.04 sec)

二级分区支持LIST DEFAULT类型，示例如下：

CREATE TABLE test (a int, b int)
PARTITION BY RANGE(a)
SUBPARTITION BY LIST(b) (
PARTITION part0 VALUES LESS THAN (10)
( SUBPARTITION sub0 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub1 DEFAULT),
PARTITION part1 VALUES LESS THAN (20)
( SUBPARTITION sub2 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub3 DEFAULT),
PARTITION part2 VALUES LESS THAN (30)
( SUBPARTITION sub4 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub5 DEFAULT));

一级分区存在多个LIST DEFAULT HASH分区的情况下，仅支持HASH或KEY二级分区：

CREATE TABLE list_default_hash_sub (
  a INT,
  b INT
)
PARTITION BY LIST (a)
SUBPARTITION BY HASH (b) SUBPARTITIONS 20
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

修改LIST DEFAULT HASH分区表

LIST DEFAULT HASH分区支持所有修改分区表的语法，包括ALTER TABLE ADD PARTITION、ALTER TABLE DROP PARTITION、ALTER TABLE REORGANIZE PARTITION、ALTER TABLE TRUNCATE PARTITION、ALTER TABLE EXCHANGE PARTITION、ALTER TABLE OPTIMIZE PARTITIONALTER TABLE REBUILD PARTITION、ALTER TABLE REPAIR PARTITION、ALTER TABLE ANALYZE PARTITION、ALTER TABLE CHECK PARTITION操作。除了ALTER TABLE ADD PARTITION，ALTER TABLE DROP PARTITION，ALTER TABLE REORGANIZE PARTITION有特殊的使用方法和限制，其他的语法同其他类型的分区表使用方法一样。

ALTER TABLE ADD PARTITION
- ADD DEFAULT PARTITION
  对于没有DEFAULT分区的普通LIST分区表，通过ADD PARTITION增加DEFAULT分区，使之变成LIST DEFAULT HASH分区表。
```
ALTER TABLE table_name ADD PARTITION(default_partition_definition)
```
  增加一个DEFAULT分区示例如下：
```
CREATE TABLE list_tab (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10)
);
ALTER TABLE list_tab ADD PARTITION(PARTITION pd DEFAULT);
```
  增加两个DEFAULT分区示例如下：
```
CREATE TABLE list_tab (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10)
);
ALTER TABLE list_tab ADD PARTITION(PARTITION pd DEFAULT PARTITIONS 2);
```
- ADD LIST PARTITION
  LIST DEFAULT HASH分区表ALTER TABLE ADD PARTITION语法支持使用WITHOUT VALIDATION选项添加LIST分区。
```
ALTER TABLE table_name ADD PARTITION(
  list_partition_definition[, ..., list_partition_definition])
WITHOUT VALIDATION
```
  新增一个LIST分区的示例如下：
```
CREATE TABLE list_default_hash (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

ALTER TABLE list_default_hash ADD PARTITION(
  PARTITION p2 VALUES IN (11,12,13)
)WITHOUT VALIDATION;
```
  执行后，list_default_hash表会增加一个LIST分区p2，p2中没有数据。
  
  一旦使用了without validation添加list分区，需要您手动执行`ALTER TABLE .. REBUILD ALL`命令，重新分配数据。否则数据不会重新分配，满足新添加的分区定义的数据仍存放在DEFAULT分区中，在查询时候会把default分区全部标记，不会裁剪掉，会导致查询性能下降。建议您使用ALTER TABLE REORGANIZE PARTITION语法，从DEFAULT分区中分离部分数据，建立新的LIST分区。
ALTER TABLE DROP PARTITION
DROP PARTITION操作时，只能一次性删除全部DEFAULT分区，不支持只删除部分DEFAULT分区。

执行DROP PARTITION操作，删除所有分区的示例如下：
```
ALTER TABLE list_default_hash DROP PARTITION pd0,pd1,pd2;
Query OK, 0 rows affected (0.33 sec)
Records: 0  Duplicates: 0  Warnings: 0
```
单独删除部分DEFAULT分区时会报错。
```
ALTER TABLE list_default_hash DROP PARTITION pd0;
```
报错信息如下：

ERROR 8078 (HY000): DROP PARTITION cannot be used on default partitions of LIST DEFAULT, except once dropping all default partitions
ALTER TABLE REORGANIZE PARTITION
REORGANIZE PARTITION操作时，只能一次性修改全部DEFAULT分区，不支持只修改部分DEFAULT分区。
- 使用REORGANIZE PARTITION操作可以改变DEFAULT分区的个数：
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  pd0,pd1
INTO(
  PARTITION pd DEFAULT PARTITIONS 3);
```
  执行后，DEFAULT分区的个数会由2个变成3个。
- 使用REORGANIZE PARTITION可以从DEFAULT分区中分离出一个LIST分区：
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  pd0,pd1
INTO (
 PARTITION p2 VALUES IN (20,21),
 PARTITION pd DEFAULT PARTITIONS 2);
```
  执行后，list_default_hash分区表会增加一个LIST分区p2， p2中会有从DEFAULT分区中分离出来的符合VALUES IN (20,21)的数据。
- 使用REORGANIZE PARTITION可以合并一个LIST分区到DEFAULT分区
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  p2, pd0, pd1
INTO (
 PARTITION pd DEFAULT PARTITIONS 2);
```
  执行后，LIST分区p2会合并到DEFAULT分区里。
- 使用REORGANIZE PARTITION可以从DEFAULT分区中分离部分values放到LIST分区：
```
ALTER TABLE list_default
REORGANIZE partition
  p2, pd0, pd1
INTO (
  PARTITION p2 VALUES IN (20,21,22,23,24),
  PARTITION pd DEFAULT PARTITIONS 4);
```
  执行后，p2的定义由PARTITION p2 VALUES IN (20,21)变为PARTITION p2 VALUES IN (20,21,22,23,24)，相应的数据也会从DEFAULT分区挪到p2。

父主题： 分区表增强

上一篇：KEY-LIST

下一篇：INTERVAL RANGE

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

智能客服提问云社区提问

LIST DEFAULT HASH

前提条件

使用限制

参数说明

创建LIST DEFAULT HASH分区表

修改LIST DEFAULT HASH分区表

相关文档

意见反馈

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

7*24

备案

专业服务

退订

建议反馈

售前咨询热线