更新时间:2024-04-01 GMT+08:00

YYYYDD按年日哈希

适用场景

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

使用说明

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

路由方式

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

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

"2012-12-31"是2012年第366天,所以为"2012 * 366+366"。

算法计算方式

表1 算法计算方式

条件

算法

举例

分库拆分键 ≠ 分表拆分键

拆分键:yyyy-MM-dd

分库路由结果 = (yyyy * 366 + 一年第几天) % 分库数

分表路由结果 = (yyyy * 366 + 一年第几天) % 分表数

拆分键:2012-12-31

分库 :(2012 * 366 + 366) % 8 = 6

分表:(2012 * 366 + 366) % 3 = 0

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

拆分键:yyyy-MM-dd

分表路由结果 = (yyyy * 366 + 一年第几天) % (分库数 * 分表数)

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

说明:

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

拆分键:2012-12-31

分库 :(2012 * 366 + 366) % (8*3) = 6

分库 :6 / 3 = 2

建表语法

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

用户这时就可以使用YYYYDD分库函数来解决:业务要求两年以内的每天都对应一张分表(即一天一张表),由于一年最多有366天,所以两年至少需要创建732个物理分表才能满足用户的场景。用户的DDM有8个分库,所以每个分库应该建92张物理分表(732 / 8 = 91.5,取整为 92,分表数建议是分库数的整数倍)。建表语法如下所示:

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

只分库的建表语法:

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

 

注意事项

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