PostgreSQL 中的 intagg 模块位于源码的 contrib 目录下，是一个官方附带但需要手动启用的扩展。它的核心作用是把多行整数聚合成一个紧凑的内部类型 int2vector，再通过枚举函数把这个向量拆回独立行。和通用的 array_agg 不同，intagg 并不面向所有数据类型，而是专注于整数场景，并且返回结果不是常见的 integer[] 数组，而是一个系统内部常用的 int2vector 值。

一、intagg 模块的作用与启用方式

intagg 可以理解为 integer aggregator 的缩写，它解决的问题非常具体：当一批整数需要被合并成一个可传递、可再次展开的数据结构时，不再借助通用数组，而是使用 PostgreSQL 系统已有的 int2vector 类型。这个类型在系统目录中也有应用，例如索引相关字段会用它来保存一组 int2 值。因此 intagg 的聚合适配度很高，尤其适合与系统表结构打交道的内部工具。

启用 intagg 并不复杂，因为它随 PostgreSQL 发行包一起提供，不需要到第三方源下载。创建扩展时，数据库会注册两个主要函数：int_array_aggregate(integer) 和 int_array_enum(int2vector)。前者负责把多行整数合并成一个 int2vector，后者负责把 int2vector 展开成多行结果。扩展的创建只在当前数据库生效，不会影响同一实例中的其他数据库。

下面这段 SQL 可以检查扩展是否可用并完成创建。通常执行第二条语句后，extname 为 intagg 的记录就说明当前库已经可以调用相关函数。

-- 查看当前 PostgreSQL 是否支持 intagg
SELECT name, default_version, installed_version
FROM pg_available_extensions
WHERE name = 'intagg';
-- 在目标数据库中创建扩展
CREATE EXTENSION IF NOT EXISTS intagg;
-- 确认扩展已经生效
SELECT extname, extversion
FROM pg_extension
WHERE extname = 'intagg';

创建扩展后，不需要重启数据库，也不要求断开当前连接，函数会立即可用。需要留意的是，如果连接用户不是数据库所有者，可能需要提前授予 CREATE 权限，或者在超级用户下执行。

二、整数聚合与反聚合函数用法

为了演示 intagg 的实际效果，可以先创建一张小型传感器读数表。该表只保存 id、设备编号和整数值，并不要求字段类型必须为 smallint，因为 int_array_aggregate 的入参类型是 integer，真正受限的是聚合结果中的值必须能放入 int2vector，也就是最终值需要落在 smallint 范围。

CREATE TABLE sensor_readings (
    id integer PRIMARY KEY,
    device_id integer NOT NULL,
    value integer
);
INSERT INTO sensor_readings (id, device_id, value) VALUES
(1, 10, 100),
(2, 10, 200),
(3, 20, 150),
(4, 20, 300),
(5, 20, 250);

如果按设备编号进行整数聚合，可以直接在 GROUP BY 查询中调用 int_array_aggregate。返回的 id_list 在 psql 中显示为一串空格分隔的数字，例如 1 2，而不是数组字面量。这个结果是 int2vector 类型，不能直接用数组下标访问，但它可以继续交给系统函数或反聚合函数处理。

SELECT
    device_id,
    int_array_aggregate(id) AS id_list
FROM sensor_readings
GROUP BY device_id
ORDER BY device_id;

反聚合操作由 int_array_enum 完成。它接收一个 int2vector 类型的参数，返回 SETOF integer。最典型的用法是把聚合结果作为子查询传入，避免聚合函数和集合返回函数混在同一层执行产生不稳定的行数。像下面这样先计算某个设备的 id 集合，再把它拆成多行输出，逻辑会更加清晰。

SELECT *
FROM int_array_enum(
    (SELECT int_array_aggregate(id)
     FROM sensor_readings
     WHERE device_id = 20)
);

如果直接使用 '1 2 3'::int2vector 这样的字面量，也可以测试反聚合函数，不需要现成数据表。这个特性在调试 intagg 行为时很方便，也反映了 int2vector 类型的文本表示形式。反聚合结果的每一行就是一个 int2 值，因此再次确认了范围限制的来源。

三、intagg 与 array_agg 的对比

理解 intagg 和 array_agg 的差异，有助于在合适的场景中做选择。array_agg 是通用聚合函数，可以作用于任意数据类型，返回对应的数组类型，例如 integer[]、text[]；而 intagg 只处理整数，并且输出 int2vector。int2vector 虽然本质上是 int2 数组，但它的使用方式、显示方式和限制条件与标准数组并不完全一样。

从可逆操作看，array_agg 通常与 unnest 搭配，能够把数组重新展开成行；intagg 则提供了专门的 int_array_enum 函数。功能上二者都能完成聚合并再展开的闭环，但 intagg 的核心优势在于类型更小、实现更单一，与系统内部格式的衔接更直接。尤其在只需要 int2 范围数据时，intagg 可以避免 array_agg 的通用数组管理与类型元数据开销。

不过 array_agg 的通用性明显更强。对于包含 40000 这类超出 smallint 范围的整数，intagg 会因为 int2vector 的元素类型限制而报错或产生数据问题，而 array_agg 不会受这个限制。下表整理了几个关键差异。

如果项目仍在维护早期代码，并且已经大量使用 int2vector 或系统目录结构，继续沿用 intagg 可以减少转换成本。但如果面对新的业务表，选择 array_agg 通常会带来更好的可读性和更宽的数据范围，除非明确只处理 smallint 且希望保持轻量的系统内部数据结构。

四、使用边界与维护注意

intagg 的最大边界来自 int2vector。由于该类型保存的是 int2 值，输入聚合函数的 integer 数值不会自动截断，而是可能因为无法写入 int2 而触发错误。例如某个 id 达到了 40000，聚合时就不是返回一个合理结果，而是直接报 smallint out of range 之类的异常。因此使用前最好通过数据质量检查或类型转换约束，确保所有参与聚合的值都落在 -32768 到 32767 之间。

另一个常见问题是空值处理。虽然 PostgreSQL 的多数聚合函数会跳过 NULL，但 intagg 本身面向的是紧凑的整数集合，如果在业务上游混入 NULL，最好显式使用 COALESCE 或 WHERE 条件过滤，避免聚合结果不符合预期。对于期望保留位置信息的集合场景，intagg 并不是合适的工具，它只能保存值本身，无法表达空位。

容量方面，int2vector 适合小规模整数集合，例如几十个、几百个相关 id，而不是用来处理海量日志流水或超大维度表。一旦数据量上升到较大规模，通用数组的扩展性和生态支持会更完整。维护上还需要注意，intagg 相对冷门，新接触 PostgreSQL 的开发者可能对 int2vector 不熟悉，因此在项目中使用时应补充注释和文档，说明为什么选择这个内部类型，而不是简单地在查询里调用函数后留下晦涩结果。