pg_render
使用SQL渲染HTML页面
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_render | 0.1.3 | UTIL | MIT | Rust |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 4290 | pg_render | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | pg_html5_email_address pg_readme gzip bzip zstd http pg_net pg_curl |
|---|
manual updated pgrx by Vonng
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 0.1.3 | 1817161514 | pg_render | - |
| RPM | PIGSTY | 0.1.3 | 1817161514 | pg_render_$v | - |
| DEB | PIGSTY | 0.1.3 | 1817161514 | postgresql-$v-pg-render | - |
构建
您可以使用 pig build 命令构建 pg_render 扩展的 RPM / DEB 包：
pig build pkg pg_render # 构建 RPM / DEB 包
安装
您可以直接安装 pg_render 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_render; # 当前活跃 PG 版本安装
pig ext install -y pg_render -v 18 # PG 18
pig ext install -y pg_render -v 17 # PG 17
pig ext install -y pg_render -v 16 # PG 16
pig ext install -y pg_render -v 15 # PG 15
pig ext install -y pg_render -v 14 # PG 14
dnf install -y pg_render_18 # PG 18
dnf install -y pg_render_17 # PG 17
dnf install -y pg_render_16 # PG 16
dnf install -y pg_render_15 # PG 15
dnf install -y pg_render_14 # PG 14
apt install -y postgresql-18-pg-render # PG 18
apt install -y postgresql-17-pg-render # PG 17
apt install -y postgresql-16-pg-render # PG 16
apt install -y postgresql-15-pg-render # PG 15
apt install -y postgresql-14-pg-render # PG 14
创建扩展：
CREATE EXTENSION pg_render;
用法
render(template text, input json|array|value)
使用 Liquid 语法，用查询结果渲染模板：
-- 单个值
SELECT render('Total: {{ value }}', (SELECT count(*) FROM posts));
-- 单行多列
SELECT render(
'<h1>{{ title }}</h1><p>{{ text }}</p>',
(SELECT to_json(r) FROM (SELECT title, text FROM posts WHERE id = 1) r)
);
-- 遍历数组
SELECT render(
'{% for v in values %} {{ v }} {% endfor %}',
(SELECT array(SELECT title FROM posts))
);
-- 遍历多行多列
SELECT render(
'{% for row in rows %} {{ row.title }} - {{ row.author }} {% endfor %}',
json_agg(to_json(posts.*))
) FROM posts;
render_agg(template text, input record|json|value)
聚合渲染函数 – 为每一行渲染模板：
-- 从派生表逐行渲染
SELECT render_agg('{{ title }} {{ text }}', props)
FROM (SELECT title, text FROM posts) AS props;
-- 使用 json_build_object 渲染
SELECT render_agg(
'<article><h1>{{ title }}</h1></article>',
json_build_object('title', title)
) FROM posts;
使用存储的模板
SELECT render(
(SELECT template FROM templates WHERE id = 'my_tpl'),
(SELECT to_json(r) FROM (SELECT title, text FROM posts WHERE id = 1) r)
);
PostgREST 集成
CREATE FUNCTION api.index() RETURNS "text/html" AS $$
SELECT render(
'<html><body><h1>{{ title }}</h1></body></html>',
(SELECT to_json(r) FROM (SELECT title FROM posts WHERE id = 1) r)
) $$;