pgx_ulid

概览

shared_preload_libraries = pgx_ulid is only required for gen_monotonic_ulid(); other functions work without it.

版本

构建

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

pig build pkg pgx_ulid         # 构建 RPM / DEB 包

安装

您可以直接安装 pgx_ulid 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

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

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

• 安装
• pig
• dnf
• apt

pig install pgx_ulid;          # 当前活跃 PG 版本安装

pig ext install -y pgx_ulid -v 18  # PG 18
pig ext install -y pgx_ulid -v 17  # PG 17
pig ext install -y pgx_ulid -v 16  # PG 16
pig ext install -y pgx_ulid -v 15  # PG 15
pig ext install -y pgx_ulid -v 14  # PG 14

dnf install -y pgx_ulid_18       # PG 18
dnf install -y pgx_ulid_17       # PG 17
dnf install -y pgx_ulid_16       # PG 16
dnf install -y pgx_ulid_15       # PG 15
dnf install -y pgx_ulid_14       # PG 14

apt install -y postgresql-18-pgx-ulid   # PG 18
apt install -y postgresql-17-pgx-ulid   # PG 17
apt install -y postgresql-16-pgx-ulid   # PG 16
apt install -y postgresql-15-pgx-ulid   # PG 15
apt install -y postgresql-14-pgx-ulid   # PG 14

预加载配置：

shared_preload_libraries = 'pgx_ulid';

创建扩展：

CREATE EXTENSION pgx_ulid;

用法

来源：README, releases

pgx_ulid 提供原生 ulid 类型、生成器，以及与 timestamp 和 uuid 的双向 casts。README 记录了二进制存储和 monotonic ULID 支持。pgext catalog 记录 package 和 extension 名均为 pgx_ulid，版本 0.2.3，覆盖 PostgreSQL 14-18。

启用扩展

CREATE EXTENSION pgx_ulid;

生成 ULID

SELECT gen_ulid();
SELECT gen_monotonic_ulid();

gen_monotonic_ulid() 需要：

shared_preload_libraries = 'pgx_ulid'

README 明确说明该 preload 要求只影响 gen_monotonic_ulid()；扩展其他功能无需 preload。

将 ulid 用作主键

CREATE TABLE users (
  id ulid NOT NULL DEFAULT gen_ulid() PRIMARY KEY,
  name text NOT NULL
);

SELECT * FROM users
WHERE id = '01ARZ3NDEKTSV4RRFFQ69G5FAV';

Casts 与范围查询

ALTER TABLE users
ADD COLUMN created_at timestamp GENERATED ALWAYS AS (id::timestamp) STORED;

SELECT * FROM users
WHERE id BETWEEN '2023-09-15'::timestamp::ulid
            AND '2023-09-16'::timestamp::ulid;

README 还记录了 ulid 与 uuid 之间的 casts。

注意事项

• Monotonic ULIDs 使用 shared memory 和 LWLock 来保存上一次生成的值。
• README 提到 monotonic generation 理论上可能 overflow 并抛出错误，虽然它认为实践中可忽略。
• 上游 README 也展示 CREATE EXTENSION ulid；此 stub 遵循 db/extension.csv，其中 package 和 lead extension 都是 pgx_ulid。
• GitHub release page 将 v0.2.3 列为最新，且只标为 Release 0.2.3，没有单独用户侧 release notes。