Icicle 分布式唯一ID生成系统使用教程

最新推荐文章于 2025-01-11 09:36:36 发布

郦岚彬Steward

最新推荐文章于 2025-01-11 09:36:36 发布

阅读量429

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00039/article/details/142086985

Icicle 分布式唯一ID生成系统使用教程

icicle A distributed, k-sortable unique ID generation system using Redis and Lua. 项目地址: https://gitcode.com/gh_mirrors/icicle/icicle

1. 项目介绍

Icicle 是一个基于 Redis 和 Lua 脚本的分布式 k-sortable 唯一 ID 生成系统。它能够生成 64 位的唯一 ID，这些 ID 在分布式环境中是 k-sortable 的，即可以根据时间戳进行排序。Icicle 的设计灵感来自于 Twitter 的 Snowflake 项目，但它使用了 Redis 和 Lua 脚本来实现 ID 的生成。

Icicle 的主要特点包括：

分布式生成：可以在多个 Redis 节点上生成唯一 ID。
k-sortable：生成的 ID 可以根据时间戳进行排序。
高可用性：通过 Redis 的冗余和 Lua 脚本的高效执行，确保 ID 生成的可靠性。

2. 项目快速启动

2.1 环境准备

在开始使用 Icicle 之前，您需要准备以下环境：

Redis 服务器（建议版本 >= 2.6，推荐使用 Redis 3.x）
Java 开发环境（如果使用 icicle-jedis 客户端库）

2.2 安装 Redis

首先，确保您已经安装并运行了 Redis 服务器。您可以通过以下命令启动 Redis：

redis-server

2.3 配置 Redis 节点

每个 Redis 节点需要分配一个唯一的逻辑分片 ID（logical shard ID），范围在 0 到 1023 之间。您可以通过以下命令设置逻辑分片 ID：

SET icicle-generator-logical-shard-id 123

确保每个节点的逻辑分片 ID 是唯一的，以避免生成重复的 ID。

2.4 配置 NTP

为了确保系统时钟的准确性，建议在每个 Redis 节点上安装并配置 NTP。NTP 应该配置为不会向后移动时钟的模式，以避免生成重复的 ID。

2.5 使用 icicle-jedis 客户端库

Icicle 提供了一个预构建的 icicle-jedis 客户端库，使用起来非常简单。以下是一个快速启动示例：

import com.intenthq.icicle.IcicleIdGenerator;
import com.intenthq.icicle.RoundRobinRedisPool;
import com.intenthq.icicle.jedis.JedisIcicle;
import java.util.Arrays;
import java.util.List;
import java.util.Optional;

public class IcicleExample {
    public static void main(String[] args) {
        JedisIcicle redisServerOne = new JedisIcicle("server-one:6379");
        JedisIcicle redisServerTwo = new JedisIcicle("server-two:6379");
        JedisIcicle redisServerThree = new JedisIcicle("server-three:6379");

        List<JedisIcicle> redises = Arrays.asList(redisServerOne, redisServerTwo, redisServerThree);
        RoundRobinRedisPool roundRobinRedisPool = new RoundRobinRedisPool(redises);
        IcicleIdGenerator icicleIdGenerator = new IcicleIdGenerator(roundRobinRedisPool);

        // 生成一个 ID
        Optional<Id> id = icicleIdGenerator.generateId();
        System.out.println("Generated ID: " + id.get());

        // 生成一批 ID
        Optional<List<Id>> ids = icicleIdGenerator.generateIdBatch(10);
        System.out.println("Generated IDs: " + ids.get());
    }
}