本文介绍了变更表类型及分区策略(包括拆分函数或分区列)的相关语法和示例。

前提条件

  • 仅适用于分区模式为partitioning的逻辑库(请参见CREATE DATABASE);
  • 仅支持对内核小版本为5.4.13或以上的PolarDB-X实例变更表的类型和分区策略。
  • 仅内核小版本为5.4.13或以上的PolarDB-X实例支持对带有GSI的分区表进行分区变更。

如何查看实例版本,请参见查看实例版本

注意事项

  • 表属性变更后,主键分区表将变成普通表(即不再适用原主键分区表中的自动分区策略或索引转换规则)。更多详情,请参见自动分区模式下的主键拆分
  • 本文中关于变更分区表、广播表和单表的表类型示例,均在单表t_order的基础上进行变更,t_order表的创建语句如下:
    CREATE TABLE t_order (
      `id` bigint(11) NOT NULL AUTO_INCREMENT BY GROUP,
      `order_id` varchar(20) DEFAULT NULL,
      `buyer_id` varchar(20) DEFAULT NULL,
      `seller_id` varchar(20) DEFAULT NULL,
      `order_snapshot` longtext DEFAULT NULL,
      `order_detail` longtext DEFAULT NULL,
      PRIMARY KEY (`id`),
      KEY `l_i_order` (`order_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

表类型

PolarDB-X实例支持3种类型的表:分区表、广播表和单表。您可以通过ALTER TABLE语句将表的类型在分区表、广播表和单表之间进行转换,同时还能对分区表的分区策略进行变更。

  • 分区表

    使用partition_options分区子句进行创建的表。

    partition_options可以是如下子句:
      partition_options:
        PARTITION BY
              HASH({column_name | partition_func(column_name)})
            | KEY(column_list)
            | RANGE{({column_name | partition_func(column_name)}) 
            | RANGE COLUMNS(column_list)}
            | LIST{({column_name | partition_func(column_name)}) 
            | LIST COLUMNS(column_list)} }
        partition_list_spec
    说明 更多关于分区策略的信息,请参见分区类型介绍
  • 广播表

    通过BROADCAST子句创建的表,系统会将该表复制到每个分库上,并通过分布式事务实现数据一致性,更多详情,请参见单表与广播表

  • 单表

    通过SINGLE子句创建的表。更多详情,请参见单表与广播表

单表或广播表变为分区表

  • 语法
    ALTER TABLE table_name drds_partition_options;
    说明

    更多关于partition_options的信息,请参见CREATE TABLE

  • 示例

    因业务扩展,单表t_order无法承载日益增长的数据。此时,您可以使用如下语句将该单表变更为分区表(以order_id为分区键,采用KEY分区策略):

    ALTER TABLE t_order PARTITION BY KEY(`order_id`);
    如需指定分区数量,可以使用如下语句:
    ALTER TABLE t_order PARTITION BY KEY(`order_id`) PARTITIONS 8;

单表或分区表变为广播表

  • 语法
    ALTER TABLE table_name BROADCAST;
  • 示例
    您可以使用如下语句将单表或分区表t_order变更为广播表:
    ALTER TABLE t_order BROADCAST;

广播表或分区表变为单表

  • 语法
    ALTER TABLE table_name SINGLE;
    或者:
    ALTER TABLE table_name REMOVE PARTITIONING;
  • 示例
    您可以使用如下语句将广播表或分区表t_order变更为单表:
    ALTER TABLE t_order SINGLE;

    或者:

     ALTER TABLE t_order REMOVE PARTITIONING;

变更分区表的分区策略

  • 语法
    ALTER TABLE tbl_name partition_options;
  • 示例1
    假设已使用如下语句在PolarDB-X数据库中创建了一张分区表t_order(根据order_id列进行KEY分区):
      CREATE TABLE t_order (
        `id` bigint(11) NOT NULL AUTO_INCREMENT,
        `order_id` varchar(20) DEFAULT NULL,
        `buyer_id` varchar(20) DEFAULT NULL,
        `seller_id` varchar(20) DEFAULT NULL,
        `order_snapshot` longtext DEFAULT NULL,
        `order_detail` longtext DEFAULT NULL,
        PRIMARY KEY (`id`),
        KEY `l_i_order` (`order_id`)
      ) ENGINE=InnoDB DEFAULT CHARSET=utf8 
      PARTITION BY KEY(`order_id`);
    现需要对t_order表的分区策略作出如下变更:
    • 根据order_id列以及buyer_id进行KEY分区。
    • 共包含8个分区。

    您可以使用如下语句实现上述变更:

    ALTER TABLE t_order PARTITION BY KEY(order_id, buyer_id) PARTITIONS 8;
  • 示例2
    假设已使用如下语句在PolarDB-X数据库中创建了一张分区表t_order(根据id列进行RANGE分区):
      CREATE TABLE t_order (
        `id` bigint(11) NOT NULL AUTO_INCREMENT,
        `order_id` varchar(20) DEFAULT NULL,
        `buyer_id` varchar(20) DEFAULT NULL,
        `seller_id` varchar(20) DEFAULT NULL,
        `order_snapshot` longtext DEFAULT NULL,
        `order_detail` longtext DEFAULT NULL,
        PRIMARY KEY (`id`),
        KEY `l_i_order` (`order_id`)
      ) ENGINE=InnoDB DEFAULT CHARSET=utf8 
      PARTITION BY RANGE(`id`)
      (
        PARTITION p1 VALUES LESS THAN (100),
        PARTITION p2 VALUES LESS THAN (1000),
        PARTITION P3 VALUES LESS THAN MAXVALUE
      );
    现需要对t_order表的分区策略作出如下变更:
    • 根据order_id列以及buyer_id进行KEY分区;
    • 总共包含16个分区。

    您可以使用如下语句实现上述变更:

    ALTER TABLE t_order PARTITION BY KEY(order_id, buyer_id) PARTITIONS 16;

相关文档

分区变更后,您可以通过如下命令查看表的分区规则或拓扑结构:

常见问题

Q:为什么有时分区变更的DDL任务会执行失败?此时该如何处理?

A:实例崩溃或唯一索引存在冲突等因素会导致分区变更的DDL任务执行失败。但这不会损坏原表任何数据,也不会阻塞正常的DML和查询语句执行。当分区变更的DDL任务执行失败时,您可以通过CANCEL DDL命令回滚该任务,然后再次尝试变更。关于CANCEL DDL命令的详情,请参见CANCEL DDL