分布式序列

普通序列

数据访问代理的分布式序列功能提供了类 Oracle 语法的 SQL 语句，seq_name.nextval，其中 seq_name 是任意字符串，一般是一张逻辑表使用同一个 seq_name，基于单库单表的 dbp_sequence 表实现。使用如下：

SELECT order_seq.nextval FROM dual

业务序列

如前面提到的，分布式序列功能基于数据库表实现，dbp_sequence 可以部署成单库单表模式，同样也可以部署成分库分表模式，分库分表模式下有如下优点：

• 提升 Sequence 表的读写能力。

• 提升 Sequence 表的可用性，无单点故障。

• 通过将 Sequence 表和业务数据表部署在一起，保持数据拆分规则一致，方便生成业务主键。

数据访问代理的分布式序列在 nextVal 语法基础下，扩展了更多业务型的字段，在获得 Sequence 值之外，还可以获得更多分库分表相关的信息，开发者可以根据实际场景灵活组装业务的序列号。使用如下：

SELECT
  order_seq.timestamp, order_seq.dbtimestamp, order_seq.groupid,
  order_seq.tableid, order_seq.nextval
FROM dual
WHERE sharding_col =?

其中各项字段的含义：

• timestamp：获取 Sequence 的时间戳，该时间是机器时间。

• dbtimestamp：获取 Sequence 数据库的时间，使用该命令的话，数据访问代理会实时向物理数据库请求当前时间。

• groupid：获取 Sequence 所在分片的 ID。

• tableid：获取 Sequence 所在分表的 ID。

• sharding_col：获取 Sequence 的分库分表字段，该字段是虚拟并不真实存在，用以方便数据访问代理计算分库分表规则。

配置分表规则

在数据库中添加 dbp_sequence 表的分表规则，以下是以 100 个分片 100 个分表，以 sharding_col 字段 hash 规则为示例：

全局序列

通过配置分布式序列，获取全局序列的核心步骤如下：

1. 在 DB 中创建 dbp_sequence 表。

   • 建议您在数据访问代理中创建逻辑表 dbp_sequence 时，让数据访问代理去创建 DB 中的 dbp_sequence 表（数据访问代理会按照分表规则，自动创建相应的表）。

   • 假如是分表模式，则添加的分表必须以 sharding_col 为分表字段，例如 #sharding_col#%4 ，注意这个字段不能变。

2. 在客户端使用 SELECT user.nextval FROM dual WHERE sharding_col = xxxx 去获取 sequence。

   • 其中，dual 和 sharding_col 不能变。

   • user 代表客户的逻辑表，会被数据访问代理填充到 dbp_sequence 表的 name 字段里面去，表示该 sequence 是为 user 这个表产生的。但是，这里没有强相关性，只是为了程序中好控制唯一性。

数据访问代理上的逻辑表，示例如下：

dbp_sequence 的分表规则，示例如下：

物理数据库中的表和内容示例如下：

获取 sequence 的 SQL 代码，示例如下：

注意事项

• 分库分表场景下，nextval 是每个分片/分表独立递增，不同分片/分表的 nextval 会有重复的情况。所以请拼接其他信息用以区分，如：groupid。

• nextval 不保证严格递增，且也有上限，默认 nextval 在 1 ~ 99999999 中重复循环。

• 单条 SQL 中不支持多个 Sequence 名字。

附录

dbp_sequence 建表语句

CREATE TABLE dbp_sequence (
`id` INT AUTO_INCREMENT,
`name` VARCHAR(255),
`value` INT,
`min_value` BIGINT,
`max_value` BIGINT,
`step` BIGINT,
`gmt_create` DATETIME,
`gmt_modified` DATETIME,
  PRIMARY KEY (`id`),
  UNIQUE KEY (`name`)
);

字段说明：