ltree_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 ltree_plruby CASCADE;  -- 依赖: ltree, plruby

用法

来源：

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

ltree_plruby 为 plruby 语言安装 PostgreSQL ltree 路径与 Ruby 数组之间的转换。ltree 参数会成为由标签字符串组成的数组；由有效标签组成的数组也可以直接作为 ltree 值返回。

安装并使用转换

CREATE EXTENSION ltree;
CREATE EXTENSION plruby;
CREATE EXTENSION ltree_plruby;

CREATE FUNCTION ruby_append_label(ltree, text)
RETURNS ltree
LANGUAGE plruby
TRANSFORM FOR TYPE ltree
AS $$
  path = args[0]
  path << args[1]
  path
$$;

SELECT ruby_append_label('Top.Science'::ltree, 'Astronomy');

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

对象与注意事项

• ltree_to_plruby(internal) 实现从 SQL 到 Ruby 的转换。
• plruby_to_ltree(internal) 实现从 Ruby 到 SQL 的转换。
• 扩展版本为 1.0，同时依赖 ltree 和 plruby，并且可重定位。
• 返回数组中的每个元素都必须是有效的 ltree 标签。PostgreSQL 会拒绝无效字符、空标签或超过 ltree 限制的路径。
• PL/Ruby 仍是不受信任的语言。安装此转换不会为 Ruby 代码提供沙箱，也不会降低创建 PL/Ruby 函数所需的权限。