本文將介紹YYYYDD函數的使用方式。
使用限制
- 拆分鍵的類型必須是DATE、DATETIME或TIMESTAMP中的一種。
- 使用YYYYDD函數前,需要先確定所需的總物理分表數,您可以通過確定循環周期(如2年)來確定總的物理分表數。因為YYYYDD函數僅支持為循環周期內的每一天創建一張獨立分表。
- 當日期經過一個循環周期后(如2012-03-01經過一個2年的循環周期后是2014-03-01),同一個日期有可能被路由到同一個分庫分表,具體被分到哪個分表受實際的分表數目影響。
- PolarDB-X 1.0實例的版本需為5.1.28-1320920或以上版本,關于實例版本請參見版本說明。
路由方式
根據分庫鍵時間值的年份與一年的天數計算哈希值,然后再按分庫數進行取余,完成路由計算。
例如,YYYYDD('2012-12-31 12:12:12')
函數等價于按照(2012x366+366)%D
(D是分庫數目)公式計算出2012-12-31是2012年的第366天。
使用場景
YYYYDD函數適用于需要按年份與一年的天數進行分庫的場景。建議結合該函數與 tbpartition by YYYYDD(ShardKey)
命令一起使用。
使用示例
假設PolarDB-X 1.0里已經擁有2個節點,每個節點默認有8個物理庫,現有如下需求:
- 按年天進行分庫。
- 同一天的數據都能落在同一張分表,且兩年以內的每一天都能單獨對應一張分表。
- 查詢時帶上分庫分表鍵后能直接將查詢落在某個物理分庫的某個物理分表。
YYYYDD分庫函數即可滿足上述要求。上述需求中提到兩年以內的每一天都需對應一張分表(即一天一張表),由于一年最多有366天,所以需要創建732(366x2=732)張物理分表才能滿足上述需求。PolarDB-X 1.0已有16個分庫,所以每個分庫應該建46張物理分表(732/16=45.75,取整為46,分表數最好是分庫數的整數倍)。
則您可以使用如下建表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 46;