hstore_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 hstore_plruby CASCADE;  -- 依赖: hstore, plruby

用法

来源：

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

hstore_plruby 为 plruby 语言安装 PostgreSQL hstore 与 Ruby Hash 值之间的转换。键会变为 Ruby 字符串，值会变为字符串或 nil；兼容的 Ruby 哈希也可以直接作为 hstore 返回。

安装并使用转换

CREATE EXTENSION hstore;
CREATE EXTENSION plruby;
CREATE EXTENSION hstore_plruby;

CREATE FUNCTION ruby_add_hstore_key(hstore)
RETURNS hstore
LANGUAGE plruby
TRANSFORM FOR TYPE hstore
AS $$
  value = args[0]
  value['processed'] = 'yes'
  value
$$;

SELECT ruby_add_hstore_key('id=>42'::hstore);

只有声明了 TRANSFORM FOR TYPE hstore 的函数才会使用该转换。

对象与注意事项

• hstore_to_plruby(internal) 实现从 SQL 到 Ruby 的转换。
• plruby_to_hstore(internal) 实现从 Ruby 到 SQL 的转换。
• 扩展版本为 1.0，同时依赖 hstore 和 plruby，并且可重定位。
• hstore 是从字符串到字符串或 NULL 的扁平映射。它不会保留嵌套的 Ruby 哈希、数组或有类型的数值；如果这些数据形态很重要，请使用 jsonb_plruby。
• PL/Ruby 仍是不受信任的语言。安装此转换不会为 Ruby 代码提供沙箱，也不会降低创建 PL/Ruby 函数所需的权限。