分布式:可任意横向扩展
高性能:分配ID只访问内存(到达上限会请求数据库一次)
易用性:对外提供HTTP服务
唯一性:MySQL自增ID,永不重复
高可靠:MySQL持久化
依赖项本项目使用下列优秀的项目作为必要组件。
gopkg.in/yaml.v2
github.com/go-sql-driver/mysql
github.com/satori/go.uuid
安装注意:需要在启动之前创建数据库并修改配置文件中数据库的配置。
goget方式:
需保证$GOPATH/bin在系统PATH中。
go get github.com/qichengzx/seqsvrseqsvr单独编译:
git clone git@github.com:qichengzx/seqsvr.gitcd seqsvrgo build ../seqsvrDocker方式:
Dockerfile使用了Docker多阶段构建功能,需保证Docker版本在17.05及以上。详见:Usemulti-stagebuilds
git clone git@github.com:qichengzx/seqsvr.gitcd seqsvrdocker build seqsvr:latest .docker run -p 8000:8000 seqsvr:latest初始化数据库数据库名称可以自定义,修改config.yml即可。
然后导入以下SQL生成数据表。
CREATE TABLE `generator_table` ( `id` int(11) NOT NULL AUTO_INCREMENT, `uuid` char(36) NOT NULL COMMENT '机器识别码', PRIMARY KEY (`id`), UNIQUE KEY `id_UNIQUE` (`id`), UNIQUE KEY `stub_UNIQUE` (`uuid`) USING BTREE) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;修改配置配置文件使用 YAML 格式。
#appport: ':8000'#servicestep: 100#dbmysql: user: 'root' password: '' host: 'tcp(localhost:3306)' database: 'sequence'可修改端口号及MySQL的配置。
使用curl https://localhost:8000/new{"code":0,"msg":"ok","data":{"id":101}}原理本项目设计原理来自携程技术中心的干货|分布式架构系统生成全局唯一序列号的一个思路。
服务初始化后第一次请求会在MySQL数据库中插入一条数据,以生成初始ID。
后续的请求,都会在内存中进行自增返回,并且保证返回的ID不会超过设置的上限,到达上限后会再次从MySQL中更新数据,返回新的初始ID。
核心SQL
REPLACE INTO `generator_table` (uuid) VALUES ("54f5a3e2-e04c-4664-81db-d7f6a1259d01");
评论