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;

用法

语法：

CREATE EXTENSION pg_slug_gen;
SELECT gen_random_slug();
SELECT gen_random_slug(13);

来源：PGXN 发布 README

pg_slug_gen 使用密码学随机性生成基于时间戳的 slug。PGXN 发布页将其描述为一个 PostgreSQL 扩展，会把时间戳中的数字映射到字母桶，并在中间插入连字符，从而生成适合 URL 使用的 slug。

函数

上游文档给出的 SQL 函数是：

gen_random_slug(slug_length int DEFAULT 16) RETURNS text

README 展示了以下调用方式：

gen_random_slug()      -- 默认：16（微秒）
gen_random_slug(10)    -- 秒
gen_random_slug(13)    -- 毫秒
gen_random_slug(16)    -- 微秒
gen_random_slug(19)    -- 纳秒

精度与长度

发布页把精度与时间戳位数、以及可无碰撞吞吐量对应起来：

• 10 位表示秒级，最多每秒 1 条
• 13 位表示毫秒级，最多每秒 1,000 条
• 16 位表示微秒级，最多每秒 1,000,000 条
• 19 位表示纳秒级，最多每秒 10 亿条

slug 中间会插入一个连字符：

• 秒级：5-5 模式，总长度 11
• 毫秒级：6-7 模式，总长度 14
• 微秒级：8-8 模式，总长度 17
• 纳秒级：9-10 模式，总长度 20

示例

SELECT gen_random_slug();
SELECT gen_random_slug(10);
SELECT gen_random_slug(13);
SELECT gen_random_slug(16);
SELECT gen_random_slug(19);

作为表默认值：

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

工作原理

发布页将算法描述为：

1. 取出当前时间戳并按指定精度截断
2. 将每一位数字映射到基于 QWERTY 的字符桶
3. 使用 pg_strong_random() 从对应字符桶中随机取一个字符
4. 在中间位置插入连字符

README 还指出，同一时间戳下仍可能出现碰撞，但在微秒级精度下，碰撞概率约为一千万分之一。