Updated on 2022-09-16 GMT+08:00

WEEK

Application Scenarios

This algorithm applies when you want to shard data by day in a week. One table shard for one day is recommended.

Instructions

  • The sharding key must be DATE, DATETIME, or TIMESTAMP.
  • This algorithm can be used only for table sharding, instead of database sharding.

Data Routing

Use the day number of a week in the sharding key value to find the remainder. This remainder determines which table shard your data is routed to and serves as the name suffix of each table shard.

For example, if the sharding key value is 2019-01-15, the calculation of the table shard is: Day number in a week mod Table shards, that is, 3 mod 7 = 3.

Calculation Method

Table 1 Required calculation methods

Condition

Calculation Method

Example

None

Table routing result = Table sharding key value % Table shards

Sharding key value: 2019-01-15

Table shard: 3 mod 7= 3

Syntax for Creating Tables

create table test_week_tb (    
    id int, 
    name varchar(30) DEFAULT NULL,  
    create_time datetime DEFAULT NULL,
    primary key(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 
dbpartition by HASH(name) 
tbpartition by WEEK(create_time) tbpartitions 7;

Precautions

Table shards in each database shard cannot exceed 7 because there are 7 days in a week.