如何用Python构建PostgreSQL的多值INSERT语句？

问题场景 #

你需要基于元组列表生成符合格式的PostgreSQL多值INSERT语句，当前拼接时出现了多余的方括号，目标格式如下：

INSERT INTO mytable
VALUES
(, , …, ),
(<value 1>, <value 2>, …, ),
(, , …, )

给定元组列表：foo = [(1, 2, 3), (4, 5, 6), (7, 8, 9)]

解决方法 #

利用Python的字符串拼接和元组转字符串的特性，直接将每个元组转换为带括号的字符串，再拼接成VALUES部分：

foo = [(1, 2, 3), (4, 5, 6), (7, 8, 9)]
table_name = "mytable"

# 将每个元组转为带括号的字符串，再用逗号+换行缩进连接
values_clause = ',\n    '.join(map(str, foo))
# 拼接完整INSERT语句
insert_sql = f"INSERT INTO {table_name}\nVALUES\n    {values_clause};"

print(insert_sql)

输出结果 #

执行后会生成正确的SQL语句：

INSERT INTO mytable
VALUES
    (1, 2, 3),
    (4, 5, 6),
    (7, 8, 9);

注意事项 #

• 如果元组包含字符串类型（如("alice", "bob", "charlie")），str(tuple)会生成带单引号的格式，PostgreSQL支持单引号作为字符串分隔符，无需额外处理；
• 若字符串中包含单引号（如("O'Neil", "Doe")），直接拼接会导致SQL语法错误，此时建议使用参数化查询（如psycopg2的executemany）来避免SQL注入风险，同时自动处理特殊字符转义。

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