cetus/scale-up-tool/readme.md

udf_sharding_hash.so使用手册

1 工具介绍

在MySQL实例，使用udf_sharding_hash.so创建函数。通过这个函数，可以算出记录所在桶号。

2 工具用法

查询MySQL plugin_dir：

mysql> show variables like 'plugin_dir'; 
+---------------+--------------------------+
| Variable_name | Value                    |
+---------------+--------------------------+
| plugin_dir    | /usr/lib64/mysql/plugin/ |
+---------------+--------------------------+

将udf_sharding_hash.so包上传至/usr/lib64/mysql/plugin/目录

创建MySQL函数：

mysql> create function sharding_hash returns integer soname 'udf_sharding_hash.so';

删除MySQL函数：

mysql> drop function sharding_hash;

使用方法：

select sharding_hash('col_value',X);

col_value为列值，X为分片表桶的数量，与sharding.json文件'"num": X' 中的X含义一致。

具体使用例子：

mysql> select sharding_hash('test',4);
+-------------------------+
| sharding_hash('test',4) |
+-------------------------+
|                       2 |
+-------------------------+

mysql> select sharding_hash(123,4);
+----------------------+
| sharding_hash(123,4) |
+----------------------+
|                    3 |
+----------------------+