因为crosstab()不是PostgreSQL内置函数，必须先在当前数据库执行CREATE EXTENSION IF NOT EXISTS tablefunc;启用扩展，否则报错；source_sql须严格返回row_name、category、value三列并ORDER BY 1,2，category_sql须返回一列且ORDER BY，AS子句列数、顺序、类型须与category_sql完全匹配。
为什么执行 crosstab() 会报 “function does not exist”
因为 crosstab() 不是 PostgreSQL 内置函数，它属于 tablefunc 扩展，必须显式启用才能用。没这步，直接调用就报错。
- 在目标数据库中执行
CREATE EXTENSION IF NOT EXISTS tablefunc;—— 注意是“当前连接的数据库”，不是集群或模板库 - 如果提示
permission denied for database或must be owner of extension，说明当前用户无CREATE权限，需 DBA 或超级用户执行 - 扩展只生效于当前库；换库后要重新运行一次，不能跨库共享
- 扩展只需启用一次，后续所有查询都可用，不用每次连接都重复加载
crosstab() 的两个 SQL 参数怎么写才不翻车
第一个参数（source_sql）负责提供原始三元组，第二个参数（category_sql）决定列头和顺序——两者稍有偏差，结果就错位、空值、甚至报错。
PostgreSQL 18.4 ubuntu
下载
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布，这是目前最新的稳定版本。推荐通过官方 APT 仓库安装：先执行 sudo apt update 更新索引，再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统，在顺序扫描与 VACUUM 场景下性能提升显著，同时支持 UUID v7 原生生成函数与虚拟生成列。
-
source_sql必须返回且仅返回三列：位置固定为row_name、category、value（列名可任意，但顺序不能变） -
source_sql必须带ORDER BY 1,2：保证同row_name的行连续，且组内按category升序排列（crosstab按顺序填值，不查名字） -
category_sql只返回一列（即所有目标列名），且必须ORDER BY—— 否则列顺序错乱，值对不上；例如返回'Jan'、'Feb'，结果列就是"Jan"、"Feb"（注意双引号，区分大小写和空格） - 若某
row_name缺少某个category，对应位置为NULL；多出的行会被丢弃（不报错，但数据丢失）
AS ct(...) 子句里列定义为何总报类型/数量不匹配
crosstab() 返回的是 SETOF RECORD，PostgreSQL 完全依赖你写的 AS 显式声明结构。错一个字母、差一个类型，就直接失败。
- 列数 =
category_sql返回的行数 + 1（首列为row_name）；比如category_sql返回 3 行，AS就必须定义 4 列 - 列名顺序必须和
category_sql的ORDER BY顺序完全一致；比如它返回'Math'、'English'，AS就得写Math numeric, English numeric，颠倒就错 - 类型必须匹配实际值：如果
value是numeric，别写成int；如果category值含空格或大写（如'Q1 Sales'），列名必须用双引号包裹："Q1 Sales" numeric - 常见翻车点：
AS ct(region text, "Widget A" numeric, "Widget B" numeric)中漏掉引号或大小写不一致，导致整列全NULL
列名动态变化时，crosstab() 还能用吗
不能硬刚。当列来自业务数据且频繁新增（比如每月新增销售区域、每季度新增产品线），crosstab() 的静态 AS 定义会立刻失效——这不是性能问题，而是语法层面不可解。
- 别试图用
EXECUTE拼接AS：PostgreSQL 不允许动态列定义出现在AS子句中，语法直接拒绝 - 可行替代路径一：
jsonb_object_agg(category, value)+jsonb_path_query_array()构建键值对，再用jsonb_to_recordset()展开，适合应用层解析或中间层处理 - 可行替代路径二：退回
GROUP BY+CASE WHEN，虽然啰嗦，但完全可控；配合部分索引（如ON sales (product, sale_month) INCLUDE (amount)）也能跑得很快 - 真正容易被忽略的点：很多人以为“加个定时任务每天重生成
AS”就行，但一旦报表被其他系统（BI 工具、API）引用，列结构变更会直接导致下游解析失败——这种耦合比性能更致命
