变更表类型及分区策略 - 开发指南| 阿里云

前提条件

仅适用于分区模式为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。