LIST DEFAULT HASH

前提条件

• 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功能。

创建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。