uri
URI数据类型
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_uri | 1.20251029 | TYPE | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 3840 | uri | 否 | 是 | 否 | 是 | 否 | 是 | - |
| 相关扩展 | prefix semver unit pgpdf pglite_fusion md5hash asn1oid roaringbitmap |
|---|
+int flag
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 1.20251029 | 1817161514 | pg_uri | - |
| RPM | PIGSTY | 1.20251029 | 1817161514 | pg_uri_$v | - |
| DEB | PIGSTY | 1.20251029 | 1817161514 | postgresql-$v-pg-uri | - |
构建
您可以使用 pig build 命令构建 pg_uri 扩展的 RPM / DEB 包：
pig build pkg pg_uri # 构建 RPM / DEB 包
安装
您可以直接安装 pg_uri 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_uri; # 当前活跃 PG 版本安装
pig ext install -y pg_uri -v 18 # PG 18
pig ext install -y pg_uri -v 17 # PG 17
pig ext install -y pg_uri -v 16 # PG 16
pig ext install -y pg_uri -v 15 # PG 15
pig ext install -y pg_uri -v 14 # PG 14
dnf install -y pg_uri_18 # PG 18
dnf install -y pg_uri_17 # PG 17
dnf install -y pg_uri_16 # PG 16
dnf install -y pg_uri_15 # PG 15
dnf install -y pg_uri_14 # PG 14
apt install -y postgresql-18-pg-uri # PG 18
apt install -y postgresql-17-pg-uri # PG 17
apt install -y postgresql-16-pg-uri # PG 16
apt install -y postgresql-15-pg-uri # PG 15
apt install -y postgresql-14-pg-uri # PG 14
创建扩展：
CREATE EXTENSION uri;
用法
uri 扩展提供了一种用于存储 URI 的数据类型，支持 RFC 3986 语法验证、组件提取函数和人性化排序。
CREATE EXTENSION uri;
CREATE TABLE links (
id int PRIMARY KEY,
link uri
);
INSERT INTO links VALUES (1, 'https://github.com/petere/pguri');
组件提取函数
| 函数 | 返回类型 | 描述 |
|---|---|---|
uri_scheme(uri) | text | 协议（http、ftp、mailto） |
uri_userinfo(uri) | text | 用户信息；不存在时返回 NULL |
uri_host(uri) | text | 主机名或 IP 地址 |
uri_host_inet(uri) | inet | IP 主机转为 inet 类型；非 IP 时返回 NULL |
uri_port(uri) | integer | 端口号；未指定时返回 NULL |
uri_path(uri) | text | 路径组件（不会为 NULL） |
uri_path_array(uri) | text[] | 按 / 分割的路径 |
uri_query(uri) | text | 查询字符串；不存在时返回 NULL |
uri_fragment(uri) | text | 片段标识；不存在时返回 NULL |
工具函数
-- 按 RFC 3986 标准化 URI
SELECT uri_normalize('HTTP://Example.COM/foo/../bar');
-- 百分号编码文本
SELECT uri_escape('hello world', true, false); -- hello+world
-- 解码百分号编码文本
SELECT uri_unescape('hello+world', true, false); -- hello world
示例
SELECT uri_scheme(link), uri_host(link), uri_path(link)
FROM links
WHERE uri_host(link) = 'github.com';