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 | - |
| OS / PG | PG18 | PG17 | PG16 | PG15 | PG14 |
|---|---|---|---|---|---|
| el8.x86_64 | PIGSTY 0.3.0 el8.x86_64.pg18 : pg_typeid_18 pg_typeid_18-0.3.0-1PIGSTY.el8.x86_64.rpm
| PIGSTY 0.3.0 el8.x86_64.pg17 : pg_typeid_17 pg_typeid_17-0.3.0-1PIGSTY.el8.x86_64.rpm
| PIGSTY 0.3.0 el8.x86_64.pg16 : pg_typeid_16 pg_typeid_16-0.3.0-1PIGSTY.el8.x86_64.rpm
| PIGSTY 0.3.0 el8.x86_64.pg15 : pg_typeid_15 pg_typeid_15-0.3.0-1PIGSTY.el8.x86_64.rpm
| PIGSTY 0.3.0 el8.x86_64.pg14 : pg_typeid_14 pg_typeid_14-0.3.0-1PIGSTY.el8.x86_64.rpm
|
| el8.aarch64 | PIGSTY 0.3.0 el8.aarch64.pg18 : pg_typeid_18 pg_typeid_18-0.3.0-1PIGSTY.el8.aarch64.rpm
| PIGSTY 0.3.0 el8.aarch64.pg17 : pg_typeid_17 pg_typeid_17-0.3.0-1PIGSTY.el8.aarch64.rpm
| PIGSTY 0.3.0 el8.aarch64.pg16 : pg_typeid_16 pg_typeid_16-0.3.0-1PIGSTY.el8.aarch64.rpm
| PIGSTY 0.3.0 el8.aarch64.pg15 : pg_typeid_15 pg_typeid_15-0.3.0-1PIGSTY.el8.aarch64.rpm
| PIGSTY 0.3.0 el8.aarch64.pg14 : pg_typeid_14 pg_typeid_14-0.3.0-1PIGSTY.el8.aarch64.rpm
|
| el9.x86_64 | PIGSTY 0.3.0 el9.x86_64.pg18 : pg_typeid_18 pg_typeid_18-0.3.0-1PIGSTY.el9.x86_64.rpm
| PIGSTY 0.3.0 el9.x86_64.pg17 : pg_typeid_17 pg_typeid_17-0.3.0-1PIGSTY.el9.x86_64.rpm
| PIGSTY 0.3.0 el9.x86_64.pg16 : pg_typeid_16 pg_typeid_16-0.3.0-1PIGSTY.el9.x86_64.rpm
| PIGSTY 0.3.0 el9.x86_64.pg15 : pg_typeid_15 pg_typeid_15-0.3.0-1PIGSTY.el9.x86_64.rpm
| PIGSTY 0.3.0 el9.x86_64.pg14 : pg_typeid_14 pg_typeid_14-0.3.0-1PIGSTY.el9.x86_64.rpm
|
| el9.aarch64 | PIGSTY 0.3.0 el9.aarch64.pg18 : pg_typeid_18 pg_typeid_18-0.3.0-1PIGSTY.el9.aarch64.rpm
| PIGSTY 0.3.0 el9.aarch64.pg17 : pg_typeid_17 pg_typeid_17-0.3.0-1PIGSTY.el9.aarch64.rpm
| PIGSTY 0.3.0 el9.aarch64.pg16 : pg_typeid_16 pg_typeid_16-0.3.0-1PIGSTY.el9.aarch64.rpm
| PIGSTY 0.3.0 el9.aarch64.pg15 : pg_typeid_15 pg_typeid_15-0.3.0-1PIGSTY.el9.aarch64.rpm
| PIGSTY 0.3.0 el9.aarch64.pg14 : pg_typeid_14 pg_typeid_14-0.3.0-1PIGSTY.el9.aarch64.rpm
|
| el10.x86_64 | PIGSTY 0.3.0 el10.x86_64.pg18 : pg_typeid_18 pg_typeid_18-0.3.0-1PIGSTY.el10.x86_64.rpm
| PIGSTY 0.3.0 el10.x86_64.pg17 : pg_typeid_17 pg_typeid_17-0.3.0-1PIGSTY.el10.x86_64.rpm
| PIGSTY 0.3.0 el10.x86_64.pg16 : pg_typeid_16 pg_typeid_16-0.3.0-1PIGSTY.el10.x86_64.rpm
| PIGSTY 0.3.0 el10.x86_64.pg15 : pg_typeid_15 pg_typeid_15-0.3.0-1PIGSTY.el10.x86_64.rpm
| PIGSTY 0.3.0 el10.x86_64.pg14 : pg_typeid_14 pg_typeid_14-0.3.0-1PIGSTY.el10.x86_64.rpm
|
| el10.aarch64 | PIGSTY 0.3.0 el10.aarch64.pg18 : pg_typeid_18 pg_typeid_18-0.3.0-1PIGSTY.el10.aarch64.rpm
| PIGSTY 0.3.0 el10.aarch64.pg17 : pg_typeid_17 pg_typeid_17-0.3.0-1PIGSTY.el10.aarch64.rpm
| PIGSTY 0.3.0 el10.aarch64.pg16 : pg_typeid_16 pg_typeid_16-0.3.0-1PIGSTY.el10.aarch64.rpm
| PIGSTY 0.3.0 el10.aarch64.pg15 : pg_typeid_15 pg_typeid_15-0.3.0-1PIGSTY.el10.aarch64.rpm
| PIGSTY 0.3.0 el10.aarch64.pg14 : pg_typeid_14 pg_typeid_14-0.3.0-1PIGSTY.el10.aarch64.rpm
|
| d12.x86_64 | PIGSTY 0.3.0 d12.x86_64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~bookworm_amd64.deb
| PIGSTY 0.3.0 d12.x86_64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~bookworm_amd64.deb
| PIGSTY 0.3.0 d12.x86_64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~bookworm_amd64.deb
| PIGSTY 0.3.0 d12.x86_64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~bookworm_amd64.deb
| PIGSTY 0.3.0 d12.x86_64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~bookworm_amd64.deb
|
| d12.aarch64 | PIGSTY 0.3.0 d12.aarch64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~bookworm_arm64.deb
| PIGSTY 0.3.0 d12.aarch64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~bookworm_arm64.deb
| PIGSTY 0.3.0 d12.aarch64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~bookworm_arm64.deb
| PIGSTY 0.3.0 d12.aarch64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~bookworm_arm64.deb
| PIGSTY 0.3.0 d12.aarch64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~bookworm_arm64.deb
|
| d13.x86_64 | PIGSTY 0.3.0 d13.x86_64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~trixie_amd64.deb
| PIGSTY 0.3.0 d13.x86_64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~trixie_amd64.deb
| PIGSTY 0.3.0 d13.x86_64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~trixie_amd64.deb
| PIGSTY 0.3.0 d13.x86_64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~trixie_amd64.deb
| PIGSTY 0.3.0 d13.x86_64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~trixie_amd64.deb
|
| d13.aarch64 | PIGSTY 0.3.0 d13.aarch64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~trixie_arm64.deb
| PIGSTY 0.3.0 d13.aarch64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~trixie_arm64.deb
| PIGSTY 0.3.0 d13.aarch64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~trixie_arm64.deb
| PIGSTY 0.3.0 d13.aarch64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~trixie_arm64.deb
| PIGSTY 0.3.0 d13.aarch64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~trixie_arm64.deb
|
| u22.x86_64 | PIGSTY 0.3.0 u22.x86_64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~jammy_amd64.deb
| PIGSTY 0.3.0 u22.x86_64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~jammy_amd64.deb
| PIGSTY 0.3.0 u22.x86_64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~jammy_amd64.deb
| PIGSTY 0.3.0 u22.x86_64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~jammy_amd64.deb
| PIGSTY 0.3.0 u22.x86_64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~jammy_amd64.deb
|
| u22.aarch64 | PIGSTY 0.3.0 u22.aarch64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~jammy_arm64.deb
| PIGSTY 0.3.0 u22.aarch64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~jammy_arm64.deb
| PIGSTY 0.3.0 u22.aarch64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~jammy_arm64.deb
| PIGSTY 0.3.0 u22.aarch64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~jammy_arm64.deb
| PIGSTY 0.3.0 u22.aarch64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~jammy_arm64.deb
|
| u24.x86_64 | PIGSTY 0.3.0 u24.x86_64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~noble_amd64.deb
| PIGSTY 0.3.0 u24.x86_64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~noble_amd64.deb
| PIGSTY 0.3.0 u24.x86_64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~noble_amd64.deb
| PIGSTY 0.3.0 u24.x86_64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~noble_amd64.deb
| PIGSTY 0.3.0 u24.x86_64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~noble_amd64.deb
|
| u24.aarch64 | PIGSTY 0.3.0 u24.aarch64.pg18 : postgresql-18-typeid postgresql-18-typeid_0.3.0-1PIGSTY~noble_arm64.deb
| PIGSTY 0.3.0 u24.aarch64.pg17 : postgresql-17-typeid postgresql-17-typeid_0.3.0-1PIGSTY~noble_arm64.deb
| PIGSTY 0.3.0 u24.aarch64.pg16 : postgresql-16-typeid postgresql-16-typeid_0.3.0-1PIGSTY~noble_arm64.deb
| PIGSTY 0.3.0 u24.aarch64.pg15 : postgresql-15-typeid postgresql-15-typeid_0.3.0-1PIGSTY~noble_arm64.deb
| PIGSTY 0.3.0 u24.aarch64.pg14 : postgresql-14-typeid postgresql-14-typeid_0.3.0-1PIGSTY~noble_arm64.deb
|
| u26.x86_64 | PIGSTY MISS | PIGSTY MISS | PIGSTY MISS | PIGSTY MISS | PIGSTY MISS |
| u26.aarch64 | PIGSTY MISS | PIGSTY MISS | PIGSTY MISS | PIGSTY MISS | PIGSTY MISS |
构建
您可以使用 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;