pg_map

概览

This packaged provider is Snowflake pg_lake pg_map 3.4, not the unrelated semenikhind/pg_map 1.0 array-mapping extension. The catalog name is unique, so the packaged provider supersedes that source-only row and is reassigned with the pg_lake family to OLAP ID 2563. Extension SQL/control version is 3.4; source and DEB/RPM package version is 3.4.0.

版本

构建

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

pig build pkg pg_lake         # 构建 RPM / DEB 包

安装

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

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

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

• 安装
• pig
• dnf
• apt

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

pig ext install -y pg_lake -v 18  # PG 18
pig ext install -y pg_lake -v 17  # PG 17
pig ext install -y pg_lake -v 16  # PG 16

dnf install -y pg_lake_18       # PG 18
dnf install -y pg_lake_17       # PG 17
dnf install -y pg_lake_16       # PG 16

apt install -y postgresql-18-pg-lake   # PG 18
apt install -y postgresql-17-pg-lake   # PG 17
apt install -y postgresql-16-pg-lake   # PG 16

创建扩展：

CREATE EXTENSION pg_map;

用法

来源：

• 已复核 commit 的 pg_map README
• 已复核 commit 的 pg_map 安装 SQL
• 已复核 commit 的 pg_map C 实现

pg_map 将一个单参数 PostgreSQL 函数应用到数组的每个元素，并返回由函数结果组成的数组。它的两个重载分别用 OID 或文本标识待映射函数；带括号的文本签名按特定 regprocedure 解析，裸函数名按 regproc 解析。

在数组上映射函数

CREATE EXTENSION pg_map;

SELECT pg_map(
  'upper(text)',
  ARRAY['alpha', 'beta', 'gamma']::text[]
);

本例将 upper(text) 应用于每个元素，并返回大写文本数组。函数存在重载时，给出完整签名可避免歧义。

注意事项

• 上游只声明与 PostgreSQL 9.6devel 兼容，没有说明支持现代 PostgreSQL 版本。
• 1.0 版 C 实现使用 PostgreSQL 内部数组、catalog 和函数管理器 API。使用前应针对确切服务器源码构建并运行回归测试。
• 被映射函数必须接收一个参数。数组元素类型不同于函数参数类型时，实现会尝试做元素类型转换；找不到转换函数时会报错。
• 上游没有发布许可证或发行版兼容矩阵。