pgx_ulid
ULID数据类型与函数
仓库
pksunkara/pgx_ulid
https://github.com/pksunkara/pgx_ulid
源码
pgx_ulid-0.2.2.tar.gz
pgx_ulid-0.2.2.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pgx_ulid | 0.2.2 | FUNC | MIT | Rust |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 4510 | pgx_ulid | 否 | 是 | 是 | 是 | 否 | 否 | - |
| 相关扩展 | pg_idkit pg_uuidv7 sequential_uuids uuid-ossp pg_hashids permuteseq |
|---|
manual updated pgrx by Vonng
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 0.2.2 | 1817161514 | pgx_ulid | - |
| RPM | PIGSTY | 0.2.2 | 1817161514 | pgx_ulid_$v | - |
| DEB | PIGSTY | 0.2.2 | 1817161514 | postgresql-$v-pgx-ulid | - |
构建
您可以使用 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 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;
用法
CREATE EXTENSION pgx_ulid;
ULID 类型
该扩展提供了原生的 ulid 类型——一种 26 个字符、按字典序可排序的标识符，以二进制形式存储。
函数
| 函数 | 描述 |
|---|---|
gen_ulid() | 生成一个新的 ULID |
gen_monotonic_ulid() | 生成单调递增的 ULID（需要 shared_preload_libraries） |
类型转换
ulid::timestamp– 从 ULID 中提取创建时间timestamp::ulid– 从时间戳生成 ULID（随机部分为零）ulid::uuid/uuid::ulid– 在 ULID 和 UUID 之间互相转换
示例
-- 将 ULID 用作主键
CREATE TABLE users (
id ulid NOT NULL DEFAULT gen_ulid() PRIMARY KEY,
name text NOT NULL
);
-- 通过文本表示进行查询
SELECT * FROM users WHERE id = '01ARZ3NDEKTSV4RRFFQ69G5FAV';
-- 从 ULID 中提取时间戳
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;