開發指南—函數—拆分函數—YYYYDD

描述

根據分庫鍵時間值的年份與一年的天數計算哈希值，然後再按分庫數進行取餘，完成路由計算。

例如，

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;