snowflake

Extensions

snowflake

snowflake : Snowflake-style 64-bit ID generator and sequence utilities for PostgreSQL

Overview

ID	Extension	Package	Version	Category	License	Language
4590	snowflake	snowflake	`2.4`	FUNC	PostgreSQL	C

Attribute	Has Binary	Has Library	Need Load	Has DDL	Relocatable	Trusted
--s-d--	No	Yes	No	Yes	no	no

Relationships
Schemas	`snowflake`
See Also	spock lolor

works on pgedge kernel fork. Set snowflake.node (1..1023) before using snowflake.nextval().

Packages

Type	Repo	Version	PG Major Compatibility	Package Pattern	Dependencies
EXT	PIGSTY	`2.4`	18 17 16 15 14	`snowflake`	-
RPM	PIGSTY	`2.4`	18 17 16 15 14	`snowflake_$v`	`pgedge_$v`
DEB	PIGSTY	`2.4`	18 17 16 15 14	`pgedge-$v-snowflake`	`pgedge-$v`

Linux / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
el8.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS
el9.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
el9.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS
el10.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
el10.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS
d12.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
d12.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS
d13.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
d13.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS
u22.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
u22.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS
u24.x86_64	MISS	PIGSTY 2.4	MISS	MISS	MISS
u24.aarch64	MISS	PIGSTY 2.4	MISS	MISS	MISS

Package	Version	OS	ORG	SIZE	File URL
`snowflake_17`	`2.4`	el8.x86_64	pigsty	20.7 KiB	snowflake_17-2.4-1PIGSTY.el8.x86_64.rpm
`snowflake_17`	`2.4`	el8.aarch64	pigsty	20.7 KiB	snowflake_17-2.4-1PIGSTY.el8.aarch64.rpm
`snowflake_17`	`2.4`	el9.x86_64	pigsty	20.6 KiB	snowflake_17-2.4-1PIGSTY.el9.x86_64.rpm
`snowflake_17`	`2.4`	el9.aarch64	pigsty	20.4 KiB	snowflake_17-2.4-1PIGSTY.el9.aarch64.rpm
`snowflake_17`	`2.4`	el10.x86_64	pigsty	20.7 KiB	snowflake_17-2.4-1PIGSTY.el10.x86_64.rpm
`snowflake_17`	`2.4`	el10.aarch64	pigsty	20.6 KiB	snowflake_17-2.4-1PIGSTY.el10.aarch64.rpm
`pgedge-17-snowflake`	`2.4`	d12.x86_64	pigsty	10.2 KiB	pgedge-17-snowflake_2.4-1PIGSTY~bookworm_amd64.deb
`pgedge-17-snowflake`	`2.4`	d12.aarch64	pigsty	10.1 KiB	pgedge-17-snowflake_2.4-1PIGSTY~bookworm_arm64.deb
`pgedge-17-snowflake`	`2.4`	d13.x86_64	pigsty	10.2 KiB	pgedge-17-snowflake_2.4-1PIGSTY~trixie_amd64.deb
`pgedge-17-snowflake`	`2.4`	d13.aarch64	pigsty	10.1 KiB	pgedge-17-snowflake_2.4-1PIGSTY~trixie_arm64.deb
`pgedge-17-snowflake`	`2.4`	u22.x86_64	pigsty	10.7 KiB	pgedge-17-snowflake_2.4-1PIGSTY~jammy_amd64.deb
`pgedge-17-snowflake`	`2.4`	u22.aarch64	pigsty	10.4 KiB	pgedge-17-snowflake_2.4-1PIGSTY~jammy_arm64.deb
`pgedge-17-snowflake`	`2.4`	u24.x86_64	pigsty	10.6 KiB	pgedge-17-snowflake_2.4-1PIGSTY~noble_amd64.deb
`pgedge-17-snowflake`	`2.4`	u24.aarch64	pigsty	10.4 KiB	pgedge-17-snowflake_2.4-1PIGSTY~noble_arm64.deb

Source

Repository

github.com/pgEdge/snowflake

Source Tarball

snowflake-2.4.tar.gz

pig build pkg snowflake;		# build rpm/deb

Install

Make sure PGDG and PIGSTY repo available:

pig repo add pgsql -u   # add both repo and update cache

Install this extension with pig:

pig install snowflake;		# install via package name, for the active PG version

pig install snowflake -v 17;   # install for PG 17

Create this extension with:

CREATE EXTENSION snowflake;

Usage

snowflake: Snowflake ID sequences for PostgreSQL

Provides int8 and sequence based unique ID generation using the Snowflake format, suitable for distributed systems.

CREATE EXTENSION snowflake;

Configuration

Set the node identifier in postgresql.conf (required, values 1-1023):

snowflake.node = 1

Functions

Function	Description
`snowflake.nextval([sequence regclass])`	Generate the next Snowflake ID (uses internal sequence if none specified)
`snowflake.currval([sequence regclass])`	Return the current value of the sequence
`snowflake.get_epoch(snowflake int8)`	Extract the timestamp as epoch (seconds since 2023-01-01)
`snowflake.get_count(snowflake int8)`	Extract the count part (resets per millisecond)
`snowflake.get_node(snowflake int8)`	Extract the node identifier
`snowflake.format(snowflake int8)`	Return a JSONB with `node`, `ts`, and `count` fields

Examples

-- Generate a snowflake ID
SELECT snowflake.nextval();
-- 136169504773242881

-- Use with a named sequence
CREATE SEQUENCE orders_id_seq;
SELECT snowflake.nextval('orders_id_seq'::regclass);

-- Extract components
SELECT snowflake.get_epoch(136169504773242881);
-- 1704996539.845

SELECT to_timestamp(snowflake.get_epoch(136169504773242881));
-- 2024-01-11 13:08:59.845-05

SELECT snowflake.get_node(136169504773242881);
-- 1

SELECT snowflake.format(136169504773242881);
-- {"id": 1, "ts": "2024-01-11 13:08:59.845-05", "count": 0}

-- Use as default column
CREATE TABLE orders (
  id int8 DEFAULT snowflake.nextval() PRIMARY KEY,
  data text
);

Last updated on 2026-04-11

typeid topn