PostgreSQL插入数组类型字段为何需用大括号包裹值？

你的public."order"表中order_type、first_name等字段定义为**character varying[]（变长字符数组）**类型，PostgreSQL对数组类型的输入有强制语法要求，这就是必须用{}包裹值才能插入的核心原因，而其他无需此操作的表，对应的字段肯定不是数组类型。

1. 数组类型的输入语法规则 #

PostgreSQL规定，数组类型的字面量必须以{开头、}结尾，多元素之间用逗号分隔。哪怕是仅包含单个元素的数组，也必须遵循这个格式——比如'{Something}'表示包含一个字符串元素的数组。如果直接传入普通字符串'Something'，PostgreSQL会将其视为普通字符类型值，无法匹配数组字段的类型要求，因此抛出ERROR: malformed array literal错误。

2. 与JSONB字段的差异 #

你之前使用JSONB字段插入遇阻，是因为JSONB遵循JSON格式语法（比如字符串需用双引号包裹，整体为JSON结构），但数组类型和JSONB是完全独立的两种数据类型，输入规则没有关联，不能混为一谈。

3. 其他表无需操作的原因 #

那些不需要用{}包裹值的表，对应的字段类型肯定是普通的character varying（非数组），直接传入字符串值就能匹配字段类型，因此不需要额外的格式处理。

你的表结构： #

CREATE TABLE IF NOT EXISTS public."order"
(
    id integer NOT NULL GENERATED ALWAYS AS IDENTITY ( INCREMENT 1 START 1 MINVALUE 1 MAXVALUE 2147483647 CACHE 1 ),
    order_type character varying(12)[] COLLATE pg_catalog."default",
    created_at timestamp with time zone,
    updated_at timestamp with time zone,
    first_name character varying(24)[] COLLATE pg_catalog."default",
    last_name character varying(24)[] COLLATE pg_catalog."default",
    email character varying(64)[] COLLATE pg_catalog."default",
    guest boolean NOT NULL DEFAULT false,
    location integer,
    user_id integer,
    phone character varying(24)[] COLLATE pg_catalog."default"
)

报错的INSERT语句： #

INSERT INTO public."order"(
    order_type, first_name, last_name, phone, email, guest, location, user_id)
    VALUES ('Something', 'Answer', 'hello', '1234567890', 'some@email.com', true, 123, 0) RETURNING *;

报错信息： #

ERROR: malformed array literal: "Something" LINE 3: VALUES ('Something', 'Answer', 'hello', '1234567890',...
DETAIL: Array value must start with "{" or dimension information. SQL state: 22P02 Character: 114

成功的INSERT语句： #

INSERT INTO public."order"(
    order_type, first_name, last_name, phone, email, guest, location, user_id)
    VALUES ('{Something}', '{Answer}', '{hello}', '{1234567890}', '{some@email.com}', true, 123, 0) RETURNING *;

执行结果： #

Successfully run. Total query runtime: 158 msec. 1 rows affected.

内容的提问来源于stack exchange，提问作者Anraiki