typeid
PG原生TypeID类型与函数
仓库
blitss/typeid-postgres
https://github.com/blitss/typeid-postgres
源码
typeid-postgres-0.3.0.tar.gz
typeid-postgres-0.3.0.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_typeid | 0.3.0 | FUNC | MIT | Rust |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 4580 | typeid | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | pg_idkit pg_uuidv7 pgx_ulid uuid-ossp pg_hashids permuteseq |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 0.3.0 | 1817161514 | pg_typeid | - |
| RPM | PIGSTY | 0.3.0 | 1817161514 | pg_typeid_$v | - |
| DEB | PIGSTY | 0.3.0 | 1817161514 | postgresql-$v-typeid | - |
构建
您可以使用 pig build 命令构建 pg_typeid 扩展的 RPM / DEB 包：
pig build pkg pg_typeid # 构建 RPM / DEB 包
安装
您可以直接安装 pg_typeid 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_typeid; # 当前活跃 PG 版本安装
pig ext install -y pg_typeid -v 18 # PG 18
pig ext install -y pg_typeid -v 17 # PG 17
pig ext install -y pg_typeid -v 16 # PG 16
pig ext install -y pg_typeid -v 15 # PG 15
pig ext install -y pg_typeid -v 14 # PG 14
dnf install -y pg_typeid_18 # PG 18
dnf install -y pg_typeid_17 # PG 17
dnf install -y pg_typeid_16 # PG 16
dnf install -y pg_typeid_15 # PG 15
dnf install -y pg_typeid_14 # PG 14
apt install -y postgresql-18-typeid # PG 18
apt install -y postgresql-17-typeid # PG 17
apt install -y postgresql-16-typeid # PG 16
apt install -y postgresql-15-typeid # PG 15
apt install -y postgresql-14-typeid # PG 14
创建扩展：
CREATE EXTENSION typeid;
用法
TypeID 是 UUIDv7 的扩展，带有类型前缀，内部存储为前缀加二进制 UUID。
CREATE EXTENSION typeid;
函数
| 函数 | 返回类型 | 描述 |
|---|---|---|
typeid_generate(prefix TEXT) | typeid | 使用给定前缀生成新的 TypeID |
typeid_generate_nil() | typeid | 生成空前缀的 TypeID |
typeid_is_valid(input TEXT) | BOOLEAN | 检查 TypeID 字符串是否有效 |
typeid_prefix(typeid) | TEXT | 从 TypeID 中提取前缀 |
typeid_to_uuid(typeid) | UUID | 将 TypeID 转换为 UUID |
uuid_to_typeid(prefix TEXT, uuid UUID) | typeid | 将 UUID 转换为 TypeID |
typeid_uuid_generate_v7() | UUID | 生成 UUID v7 |
typeid_has_prefix(typeid, prefix TEXT) | BOOLEAN | 检查 TypeID 是否具有指定前缀 |
typeid_is_nil_prefix(typeid) | BOOLEAN | 检查 TypeID 是否具有空前缀 |
typeid_generate_batch(prefix TEXT, count INTEGER) | SETOF typeid | 批量生成 TypeID |
运算符
<,<=,=,>=,>,<>用于比较 TypeID@>用于检查 TypeID 是否具有特定前缀（例如id @> 'user'）- B-tree 运算符类用于索引
示例
-- 创建使用 TypeID 主键的表
CREATE TABLE users (
id typeid DEFAULT typeid_generate('user') NOT NULL PRIMARY KEY,
created_at timestamp DEFAULT CURRENT_TIMESTAMP NOT NULL
);
-- 插入数据
INSERT INTO users (id) SELECT typeid_generate('user') FROM generate_series(1, 100);
-- 提取前缀
SELECT typeid_prefix(id) FROM users LIMIT 1; -- 'user'
-- 使用运算符检查前缀
SELECT * FROM users WHERE id @> 'user';
-- 转换为 UUID
SELECT typeid_to_uuid(id) FROM users LIMIT 1;