开发指南—函数—拆分函数—YYYYDD

2023-10-25 11:01:40

描述

根据分库键时间值的年份与一年的天数计算哈希值，然后再按分库数进行取余，完成路由计算。

例如，YYYYDD('2012-12-31 12:12:12')函数等价于按照(2012x366+366)%D（D是分库数目）公式计算出2012-12-31是2012年的第366天。

使用限制

拆分键的类型必须是DATE、DATETIME或TIMESTAMP中的一种。
使用YYYYDD函数前，需要先确定所需的总物理分表数，您可以通过确定循环周期（如2年）来确定总的物理分表数。因为YYYYDD函数仅支持为循环周期内的每一天创建一张独立分表。
当日期经过一个循环周期后（如2012-03-01经过一个2年的循环周期后是2014-03-01），同一个日期有可能被路由到同一个分库分表，具体被分到哪个分表受实际的分表数目影响。

使用场景

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

使用示例

假设PolarDB-X里已经拥有8个物理库，现有如下需求：

按年天进行分库。
同一天的数据都能落在同一张分表，且两年以内的每一天都能单独对应一张分表。
查询时带上分库分表键后能直接将查询落在某个物理分库的某个物理分表。

上述需求中提到两年以内的每一天都需对应一张分表（即一天一张表），由于一年最多有366天，所以需要创建732（366x2=732）张物理分表才能满足上述需求。PolarDB-X已有8个分库，所以每个分库应该建92张物理分表（732/8=91.5，取整为92，分表数最好是分库数的整数倍）。

则您可以使用如下建表DDL：

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;