全部产品
云市场
云游戏

YYYYMM

更新时间:2020-08-03 16:01:51

使用要求

  • 拆分键的类型必须是DATE、DATETIME或TIMESTAMP其中之一。
  • PolarDB-X实例的版本必须是5.1.28-1320920及其以上的版本。PolarDB-X版本说明请参见版本说明

路由方式

根据拆分键的时间值的年份月份进行计算哈希值,然后再按分库数去取余,完成路由计算。

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

使用场景

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

例如,假设用户的PolarDB-X里已经分了8个物理库,现业务有如下的场景:

  1. 一个业务想按年月进行分库;
  2. 要求是同一个月的数据能落在同一张分表,并且两年以内的每个月都单独对应一张分表
  3. 查询时带上分库分表键后能直接将查询落在某个物理分库的某个物理分表。

那么,用户这时就可以使用YYYYMM的分库函数进行解决。业务要求两年以内的每个月都对应一张分表(就是一个月一张表),由于一年有12个月,所以至少需要创建24个物理分表才能满足用户的场景,而用户的PolarDB-X有8个分库,所以每个分库应该建3张物理分表。因此,与用户业务场景应该对应的DDL应该是:

  1. create table test_yyyymm_tb (
  2. id int,
  3. name varchar(30) DEFAULT NULL,
  4. create_time datetime DEFAULT NULL,
  5. primary key(id)
  6. ) ENGINE=InnoDB DEFAULT CHARSET=utf8
  7. dbpartition by YYYYMM(create_time)
  8. tbpartition by YYYYMM(create_time) tbpartitions 3;

注意事项

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