PostgreSQL从早期版本就原生支持数组类型，允许把同一数据类型的多个值放进单独一列。相比额外建关联表，数组在存储紧凑度和读写简单性上更有优势，比如给用户打标签、记录每日温度、保存多边形顶点都很合适。向数组列写数据时，主要有两条路线：用ARRAY关键字显式构造，或者直接用花括号包裹的文本字面量。这两条路线在解析阶段、类型绑定和维度控制上有明显不同，选错写法很容易遇到类型推断失败或维度不匹配。
ARRAY关键字构造器的用法与原理
ARRAY关键字是PostgreSQL提供的数组构造器，它把括号里的表达式列表包装成数组。最基础的写法是ARRAY[值1, 值2, 值3]，其中的元素可以是常量、变量或子查询返回的单列。构造器本身不强制声明元素类型，类型由上下文推断：如果目标列是integer[]，那么列表里的数字按整数处理；如果是text[]，则按文本处理。这种依赖上下文的特性，让它在带参数的预处理语句里特别好用，因为驱动层绑定参数时已经知道目标类型。
当插入多维数组时，ARRAY构造器支持嵌套写法，例如ARRAY[[1,2],[3,4]]表示两行两列的二维整数数组。数据库会校验内层数组长度一致，否则报维度错误。下面的示例演示向一张帖子表插入带标签数组的行，标签列定义为text[]：
CREATE TABLE posts (
id serial PRIMARY KEY,
title text,
tags text[]
);
INSERT INTO posts (title, tags)
VALUES ('PostgreSQL数组入门', ARRAY['数据库', 'SQL', '数组']);
-- 使用预处理参数形式（伪代码逻辑）
PREPARE stmt(text, text[]) AS
INSERT INTO posts (title, tags) VALUES ($1, $2);
EXECUTE stmt('参数化插入', ARRAY['pg', 'array']);
ARRAY构造器的优势在于可读性强、类型安全，尤其在应用代码里拼接SQL时，配合参数化能避免字符串转义问题。但它要求元素类型统一，且不能出现歧义空值，比如ARRAY[1, NULL]在目标为integer[]时没问题，若目标不明则可能推断为text[]导致类型冲突。在批量COPY场景中，ARRAY构造器不能直接用于文本文件，只能走SQL语句，因此大括号语法在文件导入时更常见。
大括号语法作为数组字面量的插入方式
大括号语法把数组写成带花括号的字符串，例如'{a,b,c}'，它本质上是一个未知类型的字符串常量，需要数据库在写入时转换成对应数组类型。如果目标列类型明确，PostgreSQL会自动做转换；若用在通用表达式或默认值位置，往往要显式加类型转换，如'{1,2,3}'::integer[]。这种写法在INSERT语句里可以直接嵌在值列表中，也能写在COPY的CSV或文本数据里。
大括号里的元素用逗号分隔，包含空格或特殊字符时要加双引号，例如'{"hello world", "a,b"}'。多维数组用嵌套花括号表示：'{{1,2},{3,4}}'。下面的例子展示用大括号语法插入同一张posts表，以及如何处理带空格的标签：
INSERT INTO posts (title, tags)
VALUES ('大括号写法示例', '{数据库, SQL, 数组}');
INSERT INTO posts (title, tags)
VALUES ('带空格标签', '{"后端开发", "前端开发"}'::text[]);
-- 从文本文件COPY时，文件内就是花括号文本
-- COPY posts(title, tags) FROM '/data/posts.txt' WITH (FORMAT csv);
大括号语法的最大价值是和COPY命令配合做高速批量装载，因为文件里直接写文本数组比拼SQL更省解析开销。但它的弱点是类型模糊，如果表里该列后来改了类型，旧文本可能转换失败；另外花括号里的引号规则容易写错，少一个引号就会导致整个数组解析异常。在应用层动态拼大括号字符串也有SQL注入风险，不如ARRAY加参数来得稳。
两种写法在实践中的选择与安全注意
从执行计划角度看，ARRAY构造器和大括号字面量最终都会变成内存里的相同数组结构，性能差异主要来自SQL解析和类型推断成本，单次插入几乎无感。真正影响选型的是场景：应用内参数化写数据优先用ARRAY，因为驱动能正确处理类型绑定；离线数据迁移、日志导入优先用大括号加COPY，因为吞吐高、写法简单。混合使用时，可以在同一条语句里既用ARRAY又用转换后的大括号，只要类型对得上就不会报错。
安全方面，无论哪种写法都不要直接拼接用户输入。用ARRAY时走预处理参数，用大括号时至少做白名单校验和引号转义。数组列建索引可用GIN，配合@>、&&、ANY()做包含和交集查询，这时插入格式正确与否直接决定查询能否命中索引。以下示例展示插入后如何用数组操作符筛选：
-- 插入一些测试数据
INSERT INTO posts (title, tags)
VALUES ('第三篇', ARRAY['pg', '性能']),
('第四篇', '{pg, 优化}'::text[]);
-- 查找包含pg标签的文章
SELECT title FROM posts WHERE tags @> ARRAY['pg'];
-- 查找标签含SQL或数组的
SELECT title FROM posts WHERE tags && '{SQL, 数组}'::text[];
综合来看，ARRAY关键字偏向编程接口和类型安全，大括号语法偏向文本交换和批量工具。团队里最好约定统一风格，并在迁移脚本中明确标出类型转换，这样后续维护数组列的人不会因为写法混乱而踩坑。理解二者差异后，插入PostgreSQL数组类型数据就不再是模糊地带，而是可预期、可调试的常规操作。
PostgreSQLarray_insertARRAY_literal修改时间：2026-08-15 05:51:31