jsonb_plruby

概览

Extension control default_version is 1.0; shipped in the PL/Ruby 2.5.0 package.

版本

构建

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

pig build pkg plruby         # 构建 RPM / DEB 包

安装

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

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

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

• 安装
• pig
• dnf
• apt

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

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

dnf install -y plruby_18       # PG 18
dnf install -y plruby_17       # PG 17
dnf install -y plruby_16       # PG 16
dnf install -y plruby_15       # PG 15
dnf install -y plruby_14       # PG 14

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

创建扩展：

CREATE EXTENSION jsonb_plruby CASCADE;  -- 依赖: plruby

用法

来源：

• PL/Ruby v2.5.0 README
• jsonb_plruby v1.0 控制文件
• jsonb_plruby v1.0 扩展 SQL

jsonb_plruby 为 plruby 语言安装 PostgreSQL jsonb 与原生 Ruby 值之间的转换。经过转换的 jsonb 参数会成为 Ruby Hash、Array、String、Integer、Float、true、false 或 nil；兼容的 Ruby 值也可以直接作为 jsonb 返回。

安装并使用转换

CREATE EXTENSION plruby;
CREATE EXTENSION jsonb_plruby;

CREATE FUNCTION ruby_mark_processed(jsonb)
RETURNS jsonb
LANGUAGE plruby
TRANSFORM FOR TYPE jsonb
AS $$
  value = args[0]
  value['processed'] = true
  value
$$;

SELECT ruby_mark_processed('{"id": 42}'::jsonb);

只有声明了 TRANSFORM FOR TYPE jsonb 的函数才会使用该转换。其他 PL/Ruby 函数仍采用该语言通常的 JSONB 转换行为。

对象与注意事项

• jsonb_to_plruby(internal) 实现从 SQL 到 Ruby 的转换。
• plruby_to_jsonb(internal) 实现从 Ruby 到 SQL 的转换。
• 扩展版本为 1.0，依赖 plruby，并且可重定位。
• 返回 PostgreSQL 的 Ruby Hash 键必须是有效的 JSON 对象键，数值及特殊值也必须能够由 PostgreSQL jsonb 表示。请显式测试嵌套值和数值边界。
• PL/Ruby 仍是不受信任的语言。安装此转换不会为 Ruby 代码提供沙箱，也不会降低创建 PL/Ruby 函数所需的权限。