pg_slug_gen

概览

版本

构建

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

pig build pkg pg_slug_gen         # 构建 RPM / DEB 包

安装

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

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

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

• 安装
• pig
• dnf
• apt

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

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

dnf install -y pg_slug_gen_18       # PG 18
dnf install -y pg_slug_gen_17       # PG 17
dnf install -y pg_slug_gen_16       # PG 16
dnf install -y pg_slug_gen_15       # PG 15

apt install -y postgresql-18-pg-slug-gen   # PG 18
apt install -y postgresql-17-pg-slug-gen   # PG 17
apt install -y postgresql-16-pg-slug-gen   # PG 16
apt install -y postgresql-15-pg-slug-gen   # PG 15

创建扩展：

CREATE EXTENSION pg_slug_gen;

用法

来源: official PGXN release page, official release README, official release SQL, official release metadata

pg_slug_gen 使用密码学随机性生成基于时间戳的 slug。官方 1.0.0 版本将其描述为安全、适合 URL 的短 ID 生成器，且请求的长度决定时间戳精度。

CREATE EXTENSION pg_slug_gen;

SELECT gen_random_slug();
SELECT gen_random_slug(13);

函数

• gen_random_slug(slug_length int DEFAULT 16) returns text

发布版 SQL 注释和 README 记录了这些受支持的取值：

• 10: 秒
• 13: 毫秒
• 16: 微秒，也是默认值
• 19: 纳秒

精度与格式

每种精度都对应一个时间戳宽度和固定的 slug 形状：

• 10 位：5-5 格式，总长度 11 个字符
• 13 位：6-7 格式，总长度 14 个字符
• 16 位：8-8 格式，总长度 17 个字符
• 19 位：9-10 格式，总长度 20 个字符

README 表示，无碰撞窗口受时间戳精度约束：对应秒、毫秒、微秒、纳秒四种精度时，最多分别每个时间单位插入 1 次。

示例

SELECT gen_random_slug();
SELECT gen_random_slug(10);
SELECT gen_random_slug(16);

CREATE TABLE products (
  id serial PRIMARY KEY,
  name text NOT NULL,
  slug text DEFAULT gen_random_slug() UNIQUE
);

工作原理

官方 README 将算法描述为：

• 取当前时间戳，并使用所选精度
• 将每一位数字映射到基于 QWERTY 的字符桶
• 使用 pg_strong_random() 从对应字符桶中随机选择一个字符
• 在中点插入连字符

注意事项

• 这是一个安全短 ID 生成器，不是文本转写器，也不是把标题转换为 URL 的 slugifier。
• 同一时间戳下仍然可能发生碰撞；上游只在插入速率不超过所选时间单位每单位 1 次时声称可保持唯一。
• 官方发布元数据仍指向 https://github.com/fernandoolle/pg_slug_gen，但该仓库 URL 当前返回 404。