Tinyid 分布式ID生成器使用教程

项目介绍

Tinyid 是滴滴开发的一款分布式ID系统。它基于美团（Leaf）的 leaf-segment 算法升级而来，不仅支持数据库多主节点模式，还提供了 tinyid-client 客户端的接入方式，使用起来更加方便。Tinyid 只支持号段模式，不支持雪花模式。

特性

• 全局唯一的 long 型 ID
• 趋势递增的 ID
• 提供 http 和 java-client 方式接入
• 支持批量获取 ID
• 支持生成 1, 3, 5, 7, 9 序列的 ID
• 支持多个数据库的配置

适用场景

• 只关心 ID 是数字，趋势递增的系统
• 可以容忍 ID 不连续，可以容忍 ID 的浪费

不适用场景

• 类似于订单 ID 的业务，因生成的 ID 大部分是连续的，容易被扫库、或者推算出订单量等信息

项目快速启动

1. 克隆代码

git clone https://github.com/didi/tinyid.git

2. 创建数据库表

进入 tinyid-server 目录并使用提供的 SQL 文件创建表：

cd tinyid/tinyid-server/
mysql -u root -p < db.sql

3. 配置数据库

编辑 application.properties 文件，配置数据库连接信息：

cd src/main/resources/
vi application.properties

4. 启动服务

打包并启动 tinyid-server：

mvn clean package
java -jar target/tinyid-server-0.1.0-SNAPSHOT.jar

5. 使用 Java 客户端

在 Maven 项目中添加依赖：

<dependency>
    <groupId>com.xiaoju.uemc.tinyid</groupId>
    <artifactId>tinyid-client</artifactId>
    <version>0.1.0-SNAPSHOT</version>
</dependency>

在 classpath 下创建 tinyid_client.properties 文件：

tinyid.server=localhost:9999
tinyid.token=0f673adf80504e2eaa552f5d791b644c

使用 Java 代码获取 ID：

Long id = TinyId.nextId("test");
List<Long> ids = TinyId.nextId("test", 10);

应用案例和最佳实践

案例一：电商订单系统

在电商订单系统中，使用 Tinyid 生成唯一的订单 ID。由于订单 ID 需要趋势递增且唯一，Tinyid 的号段模式非常适合这种场景。

案例二：日志系统

在日志系统中，使用 Tinyid 生成日志记录的唯一 ID。日志 ID 需要趋势递增，便于后续的日志分析和查询。

最佳实践

• 配置合适的号段长度（step），以支持高 QPS 需求。
• 使用 tinyid-client 客户端方式，减少对 tinyid-server 的频繁访问，减轻服务器压力。
• 定期检查和维护数据库表，确保 ID 生成的连续性和唯一性。

典型生态项目

1. 数据库中间件

Tinyid 可以与数据库中间件（如 MyCat、ShardingSphere）结合使用，为分库分表提供唯一的自增 ID。

2. 分布式缓存系统

Tinyid 可以与分布式缓存系统（如 Redis、Memcached）结合使用，为缓存数据提供唯一的自增 ID。

3. 消息队列系统

Tinyid 可以与消息队列系统（如 Kafka、RabbitMQ）结合使用，为消息记录提供唯一的自增 ID。

通过以上模块的介绍和实践，您可以快速上手并应用 Tinyid 分布式ID生成器，为您的系统提供高效、可靠的 ID 生成服务。