pg_liquid

概览

版本

构建

您可以使用 pig build 命令构建 pg_liquid 扩展的 RPM / DEB 包：

pig build pkg pg_liquid         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_liquid 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

pig install pg_liquid;          # 当前活跃 PG 版本安装

pig ext install -y pg_liquid -v 18  # PG 18
pig ext install -y pg_liquid -v 17  # PG 17
pig ext install -y pg_liquid -v 16  # PG 16
pig ext install -y pg_liquid -v 15  # PG 15
pig ext install -y pg_liquid -v 14  # PG 14

dnf install -y pg_liquid_18       # PG 18
dnf install -y pg_liquid_17       # PG 17
dnf install -y pg_liquid_16       # PG 16
dnf install -y pg_liquid_15       # PG 15
dnf install -y pg_liquid_14       # PG 14

apt install -y postgresql-18-pg-liquid   # PG 18
apt install -y postgresql-17-pg-liquid   # PG 17
apt install -y postgresql-16-pg-liquid   # PG 16
apt install -y postgresql-15-pg-liquid   # PG 15
apt install -y postgresql-14-pg-liquid   # PG 14

创建扩展：

CREATE EXTENSION pg_liquid;

用法

来源：文档站点，README，v0.1.7 发行版，SQL 安装脚本

pg_liquid 将 Liquid 风格的图与复合查询引入 PostgreSQL。它在 liquid 模式中存储图状态，并提供普通查询、绑定主体的查询与最小权限读取的 SQL 入口。

核心查询接口

CREATE EXTENSION pg_liquid;

SELECT *
FROM liquid.query($$
  Edge("a","b").
  Edge("b","c").
  Path(X,Y) :- Edge(X,Y).
  Path(X,Y) :- Edge(X,Z), Path(Z,Y).
  Path("a",Y)?
$$) AS t(y text);

• liquid.query(program text)：执行 Liquid 事实、规则和一个最终查询。
• liquid.query_as(principal text, program text)：以主体绑定方式执行。
• liquid.read_as(principal text, program text)：最小权限读取封装，面向应用侧读取。

语言与建模特性

• 以 . 结尾的事实和规则
• 每个程序只能有一个最终 ? 查询
• 通过 Edge(...) 表示图边
• 形如 Type@(role=value, ...) 的类型化复合项
• 查询局部递归规则
• 内建策略复合项，例如 CompoundReadByRole 与 liquid/acts_for

行规范化器

SELECT liquid.create_row_normalizer(
  'account_profiles'::regclass,
  'account_profile_normalizer',
  'AccountProfile',
  '{"account_id":"id","display_name":"display_name","tier":"tier"}'::jsonb,
  true
);

• liquid.create_row_normalizer(...)：将关系行投影为 Liquid 复合项。
• liquid.rebuild_row_normalizer(...)：在表结构变化后重新生成绑定。
• liquid.drop_row_normalizer(...)：删除规范化器，并可选清理已生成绑定。

注意事项

• 上游在 PostgreSQL 14 到 18 上验证该扩展。
• 随附 SQL 会从 PUBLIC 撤销 query_as 与 read_as；应按需显式授权。
• 当客户端不应声明新事实时，read_as(...) 是更安全的应用入口。