使用要求

• 拆分键的数据类型必须是整数类型或字符串类型。
• 该拆分函数对 DRDS 版本无要求，默认支持。

路由方式

使用 HASH 分库但不使用同一个拆分键进行 HASH 分表时，根据分库键的键值直接按分库数取余。如果键值是字符串，则字符串会被计算成哈希值再进行计算，完成路由计算，例如： HASH(8) 等价于 8 % D（D 是分库数目）, 而 HASH(“ABC”) 等价于 hashcode(“ABC”).abs() % D（D 是分库数目）。

分库和分表都使用同一个拆分键进行 HASH 时，根据拆分键的键值按总的分表数取余。例如，有 2 个分库，每个分库 4 张分表，那么 0 库上保存分表 0~3，1 库上保存分表 4~7。某个键值为 15，15 % (2 * 4) = 7，所以 15 被分到 1 库的表 7 上。

使用场景

• 适合于需要按用户 ID 或订单 ID 进行分库的场景。
• 适合于拆分键是字符串类型的场景。

使用示例

假设用户需要对 ID 列按 HASH 函数进行分库不分表，则应该使用如下的建表 DDL：

create table test_hash_tb (
    id int,
    name varchar(30) DEFAULT NULL,  
    create_time datetime DEFAULT NULL,
    primary key(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 dbpartition by HASH(ID);

注意事项

• 哈希算法是简单取模，要求拆分列的值的自身分布均衡才能保证哈希均衡。