colnames

概览

Distribution 1.7.1 retains extension version 1.7.0; colnames(record) returns name[]. No preload or runtime extension dependencies. Upstream release lists PG8.2-17; PG14-18 verified across all 16 PGSTY target platforms.

版本

构建

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

pig build pkg colnames         # 构建 RPM / DEB 包

安装

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

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

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

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

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

dnf install -y colnames_18       # PG 18
dnf install -y colnames_17       # PG 17
dnf install -y colnames_16       # PG 16
dnf install -y colnames_15       # PG 15
dnf install -y colnames_14       # PG 14

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

创建扩展：

CREATE EXTENSION colnames;

用法

来源：

• 版本文档
• SQL 函数定义
• C 实现
• 扩展控制文件
• 发行说明

colnames 提供 colnames(record)，以 name[] 返回输入记录的字段名。通用触发器或动态 SQL 辅助函数需要了解复合值的结构、又不想把字段值转换为 JSON 时，可以使用它。发行版本 1.7.1 保留了扩展版本 1.7.0。

核心用法

CREATE EXTENSION colnames;

SELECT colnames(ROW(1, 'foo', 458.0));
SELECT colnames(t)
FROM (SELECT 1 AS id, 'Ada'::text AS name) AS t;

CREATE TYPE contact AS (id integer, name text);
SELECT colnames(NULL::contact);

三个调用分别返回 {f1,f2,f3}、{id,name} 和 {id,name}。匿名行使用生成的名称，具名行保留属性名。带类型的空值可由复合类型提供描述信息；不带类型的空值无法确定复合类型。

函数行为

colnames(record) 返回 name[]，标记为 STABLE，并且有意不声明为 STRICT。它保留列顺序和带引号标识符的拼写，忽略已删除的列，对空复合类型返回空数组。它读取行描述信息，无须读取表数据。

运行说明

扩展没有运行时扩展依赖，无须预加载或重启。调用函数时才加载 C 库。控制文件未将扩展标记为可信，因此创建扩展需要超级用户。扩展可重定位，支持安装到指定模式，或通过 ALTER EXTENSION colnames SET SCHEMA 移动。

发行版 1.7.1 的文档声明兼容 PostgreSQL 8.2–17。PGSTY 软件包面向 PostgreSQL 14–18；PostgreSQL 18 的验收依据是软件包与回归测试，不是该发行版的兼容性声明。

PostgreSQL 9.3 及以后也可以结合 row_to_json 和 json_object_keys 使用纯 SQL 方案。若把取得的名称用于动态 SQL，必须正确引用标识符，并对值保持参数化。