开发指南—透明分布式—变更表类型及拆分规则

本文涉及的产品
云原生数据库 PolarDB 分布式版,标准版 2核8GB
简介: PolarDB-X新增支持变更表的类型(即在单表、拆分表和广播表三者间进行相互转换),和变更拆分表的拆分规则(包括拆分函数或拆分列)。本文介绍相关语法和示例。

前提条件

  • 仅内核小版本为5.4.8或以上的PolarDB-X实例支持变更拆分表的拆分规则。
  • 仅内核小版本为5.4.10或以上的PolarDB-X实例支持变更表的类型(即在单表、拆分表和广播表三者间进行相互转换)。

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

注意事项

  • 暂不支持变更带有GSI的拆分表的拆分规则。
  • 表属性变更后,主键拆分表将变成普通表(即不再适用原主键拆分表中的自动拆分规则或索引转换规则)。更多详情,请参见主键拆分
  • 若单表设置了自增列,在变更为广播表或拆分表时,需提前为该表创建Sequence。如何创建Sequence,请参见显式用法
  • 本文中关于变更拆分表、广播表和单表的表类型示例,均在单表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语句在拆分表、广播表和单表间进行转换,同时还能对拆分表的拆分规则进行变更。3..png

  • 拆分表使用drds_partition_options子句进行拆分的表。drds_partition_options可以是如下分库或分表子句:
drds_partition_options:

DBPARTITION BY db_partition_algorithm
[TBPARTITION BY table_partition_algorithm [TBPARTITIONS number]]
  • 其中:
    • db_partition_algorithm支持如下函数:
db_partition_algorithm:
HASH([col_name])
| {YYYYMM|YYYYWEEK|YYYYDD|YYYYMM_OPT|YYYYWEEK_OPT|YYYYDD_OPT}(col_name)
| UNI_HASH(col_name)
| RIGHT_SHIFT(col_name, n)
| RANGE_HASH(col_name, col_name, n)
    • table_partition_algorithm支持如下函数:
table_partition_algorithm:
HASH(col_name)
| {MM|DD|WEEK|MMDD|YYYYMM|YYYYWEEK|YYYYDD|YYYYMM_OPT|YYYYWEEK_OPT|YYYYDD_OPT}(col_name)
| UNI_HASH(col_name)
| RIGHT_SHIFT(col_name, n)
| RANGE_HASH(col_name, col_name, n)
  • 广播表通过BROADCAST子句创建的表,系统会将该表复制到每个分库上,并通过分布式事务实现数据一致性。更多详情,请参见广播表
  • 单表未进行任何拆分或未指定BROADCAST子句的表。更多详情,请参见单库单表

单表或广播表变为拆分表

  • 语法
ALTER TABLE table_name drds_partition_options;
  • 说明
    • 更多关于drds_partition_options的信息,请参见表类型
    • 若单表设置了自增列,在变更为拆分表时,需提前为该表创建Sequence。如何创建Sequence,请参见显式用法
  • 示例因业务扩展,单表t_order无法承载日益增长的数据。此时,您可以使用如下语句将该单表变更为拆分表(以order_id为拆分键):
ALTER TABLE t_order dbpartition BY hash(`order_id`);

单表或拆分表变为广播表

  • 语法
ALTER TABLE table_name BROADCAST;

  • 说明 若单表设置了自增列,在变更为广播表时,需提前为该表创建Sequence。如何创建Sequence,请参见显式用法
  • 示例您可以使用如下语句将单表或拆分表t_order变更为广播表:
ALTER TABLE t_order BROADCAST;

广播表或拆分表变为单表

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

变更拆分表的拆分规则

  • 语法
ALTER TABLE tbl_name drds_partition_options;
  • 示例假设已使用如下语句在PolarDB-X数据库中创建了一张拆分表t_order(根据order_id列进行库级拆分):
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
dbpartition BY hash(`order_id`);
  • 现需要对t_order表的拆分规则作出如下变更:
    • 根据order_id列进行库级拆分。
    • buyer_id列做表级拆分。
    • 每个分库包含3个分表。
  • 您可以使用如下语句实现上述变更:
ALTER TABLE t_order dbpartition BY hash(order_id) tbpartition BY hash(buyer_id) tbpartitions 3;

相关文档

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

常见问题

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

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


说明 暂不支持通过RECOVER DDL命令恢复执行失败的拆分键变更任务。

相关实践学习
快速体验PolarDB开源数据库
本实验环境已内置PostgreSQL数据库以及PolarDB开源数据库:PolarDB PostgreSQL版和PolarDB分布式版,支持一键拉起使用,方便各位开发者学习使用。
相关文章
|
4月前
|
消息中间件
分布式篇问题之通过本地消息表实现分布式事务的最终一致性问题如何解决
分布式篇问题之通过本地消息表实现分布式事务的最终一致性问题如何解决
157 0
|
4月前
|
缓存 Devops 微服务
微服务01好处,随着代码越多耦合度越多,升级维护困难,微服务技术栈,异步通信技术,缓存技术,DevOps技术,搜索技术,单体架构,分布式架构将业务功能进行拆分,部署时费劲,集连失败如何解决
微服务01好处,随着代码越多耦合度越多,升级维护困难,微服务技术栈,异步通信技术,缓存技术,DevOps技术,搜索技术,单体架构,分布式架构将业务功能进行拆分,部署时费劲,集连失败如何解决
|
6月前
|
消息中间件 存储 缓存
分布式实时消息队列Kafka(三)生产分区规则
分布式实时消息队列Kafka(三)生产分区规则
63 0
分布式实时消息队列Kafka(三)生产分区规则
|
6月前
|
存储 NoSQL 算法
redis存储什么类型的数据?redis分布式锁怎么实现的?
redis存储什么类型的数据?redis分布式锁怎么实现的?
|
6月前
|
缓存 分布式计算 NoSQL
分布式NoSQL列存储数据库Hbase_MR集成Hbase:读写Hbase规则(九)
分布式NoSQL列存储数据库Hbase_MR集成Hbase:读写Hbase规则(九)
62 0
TypeScript-条件和分布式条件类型
TypeScript-条件和分布式条件类型
58 0
|
SQL 缓存 负载均衡
分布式AKF拆分原则
分布式AKF拆分原则
143 0
集群类型之分布式系统
集群类型之分布式系统
93 0
|
存储 消息中间件 固态存储
MySQL技术专题之MySQL分布式系统架构设计偏向扩容问题+业务拆分
MySQL技术专题之MySQL分布式系统架构设计偏向扩容问题+业务拆分
100 0
MySQL技术专题之MySQL分布式系统架构设计偏向扩容问题+业务拆分
|
SQL 关系型数据库 分布式数据库
分布式关系型数据库服务DRDS——拆分键
分布式关系型数据库服务DRDS——拆分键自制脑图, 即分库/分表字段。 DRDS 根据拆分键的值将数据表水平拆分到后端的每一个 RDS 分库里。DRDS 里除了可以定义分库键以外,每一张逻辑表都可以定义自己的拆分键。拆分键暂时只能是单个字段。如果分库键与分表键相同,那么在插入时只需要指定该分库/分表键。如果分库键与分表键不同则在插入时需要同时指定分库键和分表键。
660 0
分布式关系型数据库服务DRDS——拆分键