pg_uuidv7
UUIDv7 支持
仓库
fboulnois/pg_uuidv7
https://github.com/fboulnois/pg_uuidv7
源码
pg_uuidv7-1.7.0.tar.gz
pg_uuidv7-1.7.0.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_uuidv7 | 1.7.0 | FUNC | MPL-2.0 | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 4540 | pg_uuidv7 | 否 | 是 | 否 | 是 | 否 | 是 | - |
| 相关扩展 | pg_idkit pgx_ulid uuid-ossp sequential_uuids pg_hashids permuteseq |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | MIXED | 1.7.0 | 1817161514 | pg_uuidv7 | - |
| RPM | PGDG | 1.7.0 | 1817161514 | pg_uuidv7_$v | - |
| DEB | PIGSTY | 1.7.0 | 1817161514 | postgresql-$v-pg-uuidv7 | - |
构建
您可以使用 pig build 命令构建 pg_uuidv7 扩展的 DEB 包：
pig build pkg pg_uuidv7 # 构建 DEB 包
安装
您可以直接安装 pg_uuidv7 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_uuidv7; # 当前活跃 PG 版本安装
pig ext install -y pg_uuidv7 -v 18 # PG 18
pig ext install -y pg_uuidv7 -v 17 # PG 17
pig ext install -y pg_uuidv7 -v 16 # PG 16
pig ext install -y pg_uuidv7 -v 15 # PG 15
pig ext install -y pg_uuidv7 -v 14 # PG 14
dnf install -y pg_uuidv7_18 # PG 18
dnf install -y pg_uuidv7_17 # PG 17
dnf install -y pg_uuidv7_16 # PG 16
dnf install -y pg_uuidv7_15 # PG 15
dnf install -y pg_uuidv7_14 # PG 14
apt install -y postgresql-18-pg-uuidv7 # PG 18
apt install -y postgresql-17-pg-uuidv7 # PG 17
apt install -y postgresql-16-pg-uuidv7 # PG 16
apt install -y postgresql-15-pg-uuidv7 # PG 15
apt install -y postgresql-14-pg-uuidv7 # PG 14
创建扩展：
CREATE EXTENSION pg_uuidv7;
用法
CREATE EXTENSION pg_uuidv7;
函数
| 函数 | 描述 |
|---|---|
uuid_generate_v7() | 生成一个新的 UUIDv7 |
uuid_v7_to_timestamptz(uuid) | 从 UUIDv7 中提取时间戳 |
uuid_timestamptz_to_v7(timestamptz [, bool]) | 将时间戳转换为 UUIDv7（第二个参数设为 true 则将随机位清零） |
示例
-- 生成一个 UUIDv7
SELECT uuid_generate_v7();
-- 018570bb-4a7d-7c7e-8df4-6d47afd8c8fc
-- 从 UUIDv7 中提取时间戳
SELECT uuid_v7_to_timestamptz('018570bb-4a7d-7c7e-8df4-6d47afd8c8fc');
-- 2023-01-02 04:26:40.637+00
-- 将时间戳转换为 UUIDv7
SELECT uuid_timestamptz_to_v7('2023-01-02 04:26:40.637+00');
-- 018570bb-4a7d-7630-a5c4-89b795024c5d
-- 用于日期范围查询时，将随机位清零
SELECT uuid_timestamptz_to_v7('2023-01-02 04:26:40.637+00', true);
-- 018570bb-4a7d-7000-8000-000000000000
-- 用作主键
CREATE TABLE events (
id uuid NOT NULL DEFAULT uuid_generate_v7() PRIMARY KEY,
data text
);