sequential_uuids

生成连续生成的UUID

概览

扩展包名版本分类许可证语言
sequential_uuids1.0.3FUNCMITC
ID扩展名BinLibLoadCreateTrustReloc模式
4570sequential_uuids-
相关扩展pg_idkit pg_uuidv7 pgx_ulid uuid-ossp pg_hashids permuteseq

版本

类型仓库版本PG 大版本包名依赖
EXTMIXED1.0.31817161514sequential_uuids-
RPMPGDG1.0.31817161514sequential_uuids_$v-
DEBPIGSTY1.0.31817161514postgresql-$v-sequential-uuids-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
el8.aarch64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
d12.aarch64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
d13.x86_64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
d13.aarch64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
u22.x86_64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
u22.aarch64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
u24.x86_64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
u24.aarch64
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3
PIGSTY 1.0.3

构建

您可以使用 pig build 命令构建 sequential_uuids 扩展的 RPM / DEB 包:

pig build pkg sequential_uuids         # 构建 RPM / DEB 包

安装

您可以直接安装 sequential_uuids 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install sequential_uuids;          # 当前活跃 PG 版本安装
pig ext install -y sequential_uuids -v 18  # PG 18
pig ext install -y sequential_uuids -v 17  # PG 17
pig ext install -y sequential_uuids -v 16  # PG 16
pig ext install -y sequential_uuids -v 15  # PG 15
pig ext install -y sequential_uuids -v 14  # PG 14
dnf install -y sequential_uuids_18       # PG 18
dnf install -y sequential_uuids_17       # PG 17
dnf install -y sequential_uuids_16       # PG 16
dnf install -y sequential_uuids_15       # PG 15
dnf install -y sequential_uuids_14       # PG 14
apt install -y postgresql-18-sequential-uuids   # PG 18
apt install -y postgresql-17-sequential-uuids   # PG 17
apt install -y postgresql-16-sequential-uuids   # PG 16
apt install -y postgresql-15-sequential-uuids   # PG 15
apt install -y postgresql-14-sequential-uuids   # PG 14

创建扩展

CREATE EXTENSION sequential_uuids;

用法

sequential_uuids: 顺序 UUID 生成器,提供更好的索引局部性

生成具有顺序模式的 UUID,减少索引中的随机 I/O,同时保持足够的随机性以避免冲突。

CREATE EXTENSION sequential_uuids;

函数

函数描述
uuid_sequence_nextval(sequence regclass, block_size int DEFAULT 65536, block_count int DEFAULT 65536)基于序列生成顺序 UUID
uuid_time_nextval(interval_length int DEFAULT 60, interval_count int DEFAULT 65536)基于当前时间戳生成顺序 UUID

示例

CREATE SEQUENCE my_seq;

-- 基于序列的 UUID 生成
SELECT uuid_sequence_nextval('my_seq'::regclass);

-- 基于时间的 UUID 生成(默认参数下约每 45 天循环一次)
SELECT uuid_time_nextval();

-- 用作列的默认值
CREATE TABLE orders (
  id uuid DEFAULT uuid_time_nextval() PRIMARY KEY,
  data text
);

-- 自定义块大小和数量
SELECT uuid_sequence_nextval('my_seq', 256, 65536);
SELECT uuid_time_nextval(120, 32768);

最后修改 2026-03-14: update extension metadata (953cbd0)