Python利用pysnowflake库实现雪花算法生成全局唯一ID

叶初
叶初
发布时间:2026-10-16| 6人浏览过
原创

本文介绍如何在Python中利用pysnowflake第三方库实现雪花算法生成全局唯一ID。通过对比Java实现,展示Python调用的便捷性。详细讲解pysnowflake的安装方法、服务启动配置及客户端调用代码,帮助开发者在单机或分布式项目中高效生成按时间递增的唯一标识符。

雪花算法概述与Python实现优势

雪花算法是一种在项目体系中生成全局唯一ID标识的有效方式。近期发现Python实现该算法的过程十分便捷,令人印象深刻。

其生成的唯一ID基于常用时间戳进行统计,但计算方式更为精准。此外,结合不同机器属性的分布式使用,可确保生成的ID在整个单机或分布式项目中保持唯一性。

雪花算法通过时间规则,以二进制方式填充时间戳及机器属性等信息,因此生成的唯一ID遵循时间递增规律。为进行对比,下文先展示Java开发中雪花算法生成唯一ID的实现方式。

Java雪花算法实现示例

package utils;

public class Snowflake {

    /** 开始时间截 (2015-01-01) */
    private final long twepoch = 1420041600000L;

    /** 机器id所占的位数 */
    private final long workerIdBits = 5L;

    /** 数据标识id所占的位数 */
    private final long datacenterIdBits = 5L;

    /** 支持的最大机器id,结果是31 (这个移位算法可以很快的计算出几位二进制数所能表示的最大十进制数) */
    private final long maxWorkerId = -1L ^ (-1L << workerIdBits);

    /** 支持的最大数据标识id,结果是31 */
    private final long maxDatacenterId = -1L ^ (-1L << datacenterIdBits);

    /** 序列在id中占的位数 */
    private final long sequenceBits = 12L;

    /** 机器ID向左移12位 */
    private final long workerIdShift = sequenceBits;

    /** 数据标识id向左移17位(12+5) */
    private final long datacenterIdShift = sequenceBits + workerIdBits;

    /** 时间截向左移22位(5+5+12) */
    private final long timestampLeftShift = sequenceBits + workerIdBits + datacenterIdBits;

    /** 生成序列的掩码,这里为4095 (0b111111111111=0xfff=4095) */
    private final long sequenceMask = -1L ^ (-1L << sequenceBits);

    /** 工作机器ID(0~31) */
    private long workerId;

    /** 数据中心ID(0~31) */
    private long datacenterId;

    /** 毫秒内序列(0~4095) */
    private long sequence = 0L;

    /** 上次生成ID的时间截 */
    private long lastTimestamp = -1L;

    public Snowflake(long workerId, long datacenterId) {
        if (workerId > maxWorkerId || workerId < 0) {
            throw new IllegalArgumentException(String.format("worker Id can't be greater than %d or less than 0", maxWorkerId));
        }
        if (datacenterId > maxDatacenterId || datacenterId < 0) {
            throw new IllegalArgumentException(String.format("datacenter Id can't be greater than %d or less than 0", maxDatacenterId));
        }
        this.workerId = workerId;
        this.datacenterId = datacenterId;
    }

    public synchronized long nextId() {
        long timestamp = timeGen();

        //如果当前时间小于上一次ID生成的时间戳,说明系统时钟回退过这个时候应当抛出异常
        if (timestamp < lastTimestamp) {
            throw new RuntimeException(
                    String.format("Clock moved backwards.  Refusing to generate id for %d milliseconds", lastTimestamp - timestamp));
        }

        //如果是同一时间生成的,则进行毫秒内序列
        if (lastTimestamp == timestamp) {
            sequence = (sequence + 1) & sequenceMask;
            //毫秒内序列溢出
            if (sequence == 0) {
                //阻塞到下一个毫秒,获得新的时间戳
                timestamp = tilNextMillis(lastTimestamp);
            }
        }
        //时间戳改变,毫秒内序列重置
        else {
            sequence = 0L;
        }

        //上次生成ID的时间截
        lastTimestamp = timestamp;

        //移位并通过或运算拼到一起组成64位的ID
        return ((timestamp - twepoch) << timestampLeftShift) //
                | (datacenterId << datacenterIdShift) //
                | (workerId << workerIdShift) //
                | sequence;
    }

    protected long tilNextMillis(long lastTimestamp) {
        long timestamp = timeGen();
        while (timestamp <= lastTimestamp) {
            timestamp = timeGen();
        }
        return timestamp;
    }

    protected long timeGen() {
        return System.currentTimeMillis();
    }

    public static void main(String[] args) {
        Snowflake idWorker = new Snowflake(0, 0);

        for (int i = 0; i < 100; i++) {
            long id = idWorker.nextId();
            System.out.println(Long.toBinaryString(id));
            System.out.println(id);
        }
    }


}

上述Java代码块可生成100个唯一ID。在Java代码中定义了生成ID时的各种属性信息,代码量约100行。此处仅截取生成唯一ID的部分结果进行展示。

111001000000000011001001011001011010110000000000000000010111 1026834554947633175 111001000000000011001001011001011010110000000000000000011000 1026834554947633176 111001000000000011001001011001011011000000000000000000000000 1026834554951827456 111001000000000011001001011001011011000000000000000000000001 1026834554951827457

若使用C++实现此类代码块,过程可能更为复杂。相比之下,Python开发较为简单,因为已有开发者封装了复杂逻辑,我们通常只需直接调用即可。这里需说明,不同编程语言均是业务开发的工具,各有其存在的意义。

Python使用pysnowflake库生成唯一ID

接下来,我们将使用Python调用第三方模块来实现雪花算法。具体使用Python实现雪花算法生成唯一ID的思路与Java相似。

在Python中,已有封装好的pysnowflake非标准库,这也是Python便捷性的体现。通过pip方式安装后即可使用。

pip install pysnowflake -i https://pypi.tuna.tsinghua.edu.cn/simple/

安装完成后,需启动雪花算法生成唯一ID的服务,并可定义工作数量。此处将工作数量定义为1以启动服务。

将snowflake.client导入代码中,相当于作为客户端访问服务端,即可直接生成唯一ID。

# Importing the `snowflake.client` module.
import snowflake.client

# Calling the `get_guid()` function from the `snowflake.client` module.
uuid = snowflake.client.get_guid()

# Printing the value of the `uuid` variable.
print(uuid)

# Printing the binary representation of the `uuid` variable.
print(bin(uuid))

# 4674877370191056897
# 0b100000011100000100000000011001100011010110000000001000000000001

至此,关于Python利用雪花算法实现生成唯一ID的介绍完毕。更多相关Python雪花算法生成唯一ID内容,请搜索本站以前的文章或继续浏览下面的相关文章,希望大家以后多多支持本站!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。