ActionTech DBLE 项目中 MySQL-offset-step 全局序列配置详解

什么是 MySQL-offset-step 全局序列

在分布式数据库环境中，全局序列是一种确保跨多个数据库实例生成唯一标识符的机制。ActionTech DBLE 提供了多种全局序列实现方式，其中 MySQL-offset-step 是一种基于 MySQL 数据库实现的序列生成方案。

配置前准备

在开始配置前，需要确保已经完成以下准备工作：

1. DBLE 服务已正确安装并运行
2. 后端 MySQL 实例已就绪并可连接
3. 熟悉 DBLE 的基本配置文件结构

详细配置步骤

1. 配置 cluster.conf 文件

首先需要在 cluster.conf 中指定序列处理器类型：

sequenceHandlerType=1

这里的 1 表示使用 MySQL-offset-step 方式的全局序列。

2. 配置 user.xml 文件

设置用户权限，确保有足够的权限访问相关数据库：

<?xml version="1.0" encoding="UTF-8"?>
<dble:user xmlns:dble="http://dble.cloud/" >
    <managerUser name="test" password="test"/>
    <shardingUser name="abc" password="abc" schemas="myschema" maxCon="1000000">
    </shardingUser>
</dble:user>

3. 配置 db.xml 文件

定义后端数据库连接信息：

<?xml version="1.0"?>
<dble:db xmlns:dble="http://dble.cloud/" >
    <dbGroup name="host_1" rwSplitMode="0" delayThreshold="10000">
        <heartbeat>select USER()</heartbeat>
        <dbInstance name="hostM1" url="172.100.10.101:3306" user="test1" password="test1" maxCon="1000" minCon="1000" primary="true" />
    </dbGroup>
    <dbGroup name="host_2" rwSplitMode="0" delayThreshold="10000">
        <heartbeat>select USER()</heartbeat>
        <dbInstance name="hostM2" url="172.100.10.102:3306" user="test1" password="test1" maxCon="1000" minCon="1000" primary="true" />
    </dbGroup>
</dble:db>

4. 配置 sharding.xml 文件

定义分片规则和全局序列配置：

<?xml version="1.0"?>
<dble:sharding xmlns:dble="http://dble.cloud/" >
    <schema name="myschema" shardingNode="dn1">
        <shardingTable name="sbtest1" shardingNode="dn1,dn2" function="mod" shardingColumn="id" incrementColumn="id" />
    </schema> 
    <shardingNode name="dn1" dbGroup="host_1" database="dble"/>
    <shardingNode name="dn2" dbGroup="host_2" database="dble"/>

    <function name="mod" class="Hash">
        <property name="partitionCount">2</property>
        <property name="partitionLength">1</property>
    </function>
</dble:sharding>

5. 配置 sequence_db_conf.properties 文件

指定序列存储位置：

`myschema`.`sbtest1`=dn1

6. 初始化序列表

在指定的分片节点上执行初始化操作：

1. 首先执行 dbseq.sql 脚本创建序列表结构
2. 然后插入初始序列配置：

INSERT INTO DBLE_SEQUENCE VALUES ('`myschema`.`sbtest1`', 16, 1);

DBLE_SEQUENCE 表结构说明：

• name：逻辑数据库和表名，必须与 sequence_db_conf.properties 中的配置一致
• current_value：序列当前值
• increment：每次预取的序列数量，但实际递增步长固定为1

验证配置

创建测试表并插入数据验证序列生成：

mysql> create table sbtest1(id int, k int unsigned not null default '0', primary key(id));
mysql> insert into sbtest1(k) values(2);
mysql> select * from sbtest1;

预期结果：

• 初始 current_value 设置为16
• 插入数据后ID自动生成为17

工作原理深入解析

MySQL-offset-step 全局序列的工作原理是：

1. DBLE 从后端 MySQL 的 DBLE_SEQUENCE 表中获取当前序列值
2. 每次插入操作时，序列值自动递增1
3. 当预取的序列值用完后，DBLE 会再次从后端 MySQL 获取新的序列段

这种机制确保了：

• 全局唯一性：所有分片上的ID都不会重复
• 高性能：减少了与后端MySQL的交互次数
• 可靠性：即使DBLE重启，序列也不会重复

最佳实践建议

1. 初始值设置：根据业务需求合理设置初始值，避免与现有数据冲突
2. 预取值大小：increment参数应根据业务量设置合理值，过高会导致序列浪费，过低会增加MySQL访问频率
3. 监控：定期检查序列使用情况，确保不会耗尽
4. 备份：定期备份DBLE_SEQUENCE表，防止数据丢失

常见问题排查

1. 序列不递增：

   • 检查 sequenceHandlerType 是否正确设置为1
   • 确认 sequence_db_conf.properties 配置正确
   • 验证 DBLE_SEQUENCE 表数据是否正确

2. 序列重复：

   • 检查是否有多个DBLE实例共享同一个后端MySQL
   • 确认没有手动修改过DBLE_SEQUENCE表

3. 性能问题：

   • 适当增大increment值减少MySQL访问
   • 确保后端MySQL性能良好

通过以上详细的配置说明和原理分析，您应该能够成功在ActionTech DBLE项目中配置并使用MySQL-offset-step方式的全局序列。