pg_csv

灵活的CSV聚合处理函数

概览

扩展包名版本分类许可证语言
pg_csv1.0.1FUNCMITC
ID扩展名BinLibLoadCreateTrustReloc模式
4760pg_csv-
相关扩展aggs_for_vecs first_last_agg arraymath intarray

版本

类型仓库版本PG 大版本包名依赖
EXTPGDG1.0.11817161514pg_csv-
RPMPGDG1.0.11817161514pg_csv_$v-
DEBPIGSTY1.0.11817161514postgresql-$v-pg-csv-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
d13.x86_64
d13.aarch64
u22.x86_64
u22.aarch64
u24.x86_64
u24.aarch64

构建

您可以使用 pig build 命令构建 pg_csv 扩展的 DEB 包:

pig build pkg pg_csv         # 构建 DEB 包

安装

您可以直接安装 pg_csv 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:

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

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

pig install pg_csv;          # 当前活跃 PG 版本安装
pig ext install -y pg_csv -v 18  # PG 18
pig ext install -y pg_csv -v 17  # PG 17
pig ext install -y pg_csv -v 16  # PG 16
pig ext install -y pg_csv -v 15  # PG 15
pig ext install -y pg_csv -v 14  # PG 14
dnf install -y pg_csv_18       # PG 18
dnf install -y pg_csv_17       # PG 17
dnf install -y pg_csv_16       # PG 16
dnf install -y pg_csv_15       # PG 15
dnf install -y pg_csv_14       # PG 14
apt install -y postgresql-18-pg-csv   # PG 18
apt install -y postgresql-17-pg-csv   # PG 17
apt install -y postgresql-16-pg-csv   # PG 16
apt install -y postgresql-15-pg-csv   # PG 15
apt install -y postgresql-14-pg-csv   # PG 14

创建扩展

CREATE EXTENSION pg_csv;

用法

pg_csv: 灵活的 CSV 处理聚合函数

提供 CSV 聚合函数,可与 SQL 表达式组合使用,不同于需要特殊协议的 COPY 命令。符合 RFC 4180 标准,正确处理引号。

CREATE EXTENSION pg_csv;

函数

函数说明
csv_agg(record)将行聚合为带表头的 CSV 文本
csv_agg(record, csv_options(...))使用自定义选项进行聚合
csv_options(delimiter, bom, header, nullstr)配置 CSV 输出选项

示例

CREATE TABLE projects AS SELECT * FROM (VALUES
  (1, 'Death Star OS', 1),
  (2, 'Windows 95 Rebooted', 1),
  (3, 'Project "Comma,Please"', 2)
) AS _(id, name, client_id);

-- 基本 CSV 输出
SELECT csv_agg(x) FROM projects x;
-- id,name,client_id
-- 1,Death Star OS,1
-- 2,Windows 95 Rebooted,1
-- 3,"Project ""Comma,Please""",2

-- 管道符分隔
SELECT csv_agg(x, csv_options(delimiter := '|')) FROM projects x;

-- 制表符分隔
SELECT csv_agg(x, csv_options(delimiter := E'\t')) FROM projects x;

-- 添加 BOM 以兼容 Excel
SELECT csv_agg(x, csv_options(bom := true)) FROM projects x;

最后修改 2026-03-14: update extension metadata (953cbd0)