更新时间:2023-07-25 GMT+08:00

YYYYMM按年月哈希

适用场景

适用于需要按年份与月份进行分库的场景,建议该函数与 tbpartition YYYYMM(ShardKey) 联合使用。

使用说明

拆分键的数据类型必须是DATE / DATETIME / TIMESTAMP其中之一。

路由方式

根据拆分键的时间值的年份与月份计算哈希值,然后再按分库数取余。

例如,YYYYMM(‘2012-12-31 12:12:12’) 等价于 (2012 * 12 + 12) % D(D是分库数目/分表数)。

算法计算方式

表1 算法计算方式

条件

算法

举例

分库拆分键 ≠ 分表拆分键

拆分键:yyyy-MM-dd

分库路由结果 = (yyyy * 12 + MM) % 分库数

分表路由结果 = (yyyy * 12 + MM) % 分表数

拆分键:2012-11-20

分库 :(2012 * 12 + 11) % 8 = 3

分表:(2012 * 12 + 11) % 3 = 2

分库拆分键 = 分表拆分键(拆分键)

拆分键:yyyy-MM-dd

分表路由结果 = (yyyy*12+MM) % (分库数 * 分表数)

分库路由结果 = 分表路由结果 / 分表数

说明:

分库路由结果四舍五入到最接近的整数。

拆分键:2012-11-20

分表:(2012 * 12 + 11) % (8 * 3) = 11

分库 :11 % 3 = 3

建表语法

假设用户的实例里已经分了8个物理库,现有一个业务想按年月进行分库。要求同一个月的数据能落在同一张分表内,并且两年以内的每个月都单独对应一张分表,查询时带上分库分表键后能直接将查询落在某个物理分库的某个物理分表。

用户这时就可以使用YYYYMM分库函数来解决:业务要求两年以内的每个月都对应一张分表(即一个月一张表),由于一年有 12 个月,所以至少需要创建 24 个物理分表才能满足用户的场景,而用户的DDM有8个分库,所以每个分库应该建3张物理分表。建表语法如下所示:

create table test_yyyymm_tb(
	id int,
	name varchar(30) DEFAULT NULL,
	create_time datetime DEFAULT NULL,
	primary key(id)
) ENGINE = InnoDB DEFAULT CHARSET = utf8
dbpartition by YYYYMM(create_time)
tbpartition by YYYYMM(create_time) tbpartitions 3;

只分库场景的建表语法:

create table YYYYMM(
	id int,
	name varchar(30) DEFAULT NULL,
	create_time datetime DEFAULT NULL,
	primary key(id)
) ENGINE = InnoDB DEFAULT CHARSET = utf8
dbpartition by YYYYMM(create_time);

注意事项

  • YYYYMM算法不支持对于每一个年月都独立对应一张分库,分库分表时必须固定分表数目。
  • 当月份经历一个轮回(如 2013-03 是 2012-03 的一个轮回)后,同一个月份有可能被路由到同一个分库分表,请以实际的分表数目而定。