使用psycopg2动态插入pandas DataFrame到PostgreSQL报unsupported format character '('错误求助
报错根因定位
你遇到的ValueError: unsupported format character: '('完全是两个使用逻辑错位导致的,没有玄学成分:
- 占位符用法和函数能力不匹配:原代码里
map(sql.Placeholder, list(df.columns))是给每个Placeholder实例传入了列名作为参数,生成的是%(对应列名)s格式的命名占位符。但你调用的psycopg2.extras.execute_values本身不支持这类带字段绑定的命名占位符,这个函数的设计目标是接收无字段绑定的通用位置占位符%s,自动批量拼接多值插入的SQL语句。 - 报错直接触发点:上面生成的命名占位符串,开头会出现
%(字符,这个字符会被psycopg2底层的参数解析器误判为普通字符串格式化的格式标识——因为%后面紧跟(不符合Python字符串格式化的语法规则,直接抛出不支持的格式字符错误。 - 传参格式不匹配:你把DataFrame转成了字典组成的元组传给
execute_values,这个格式是给带命名占位符的单条cursor.execute()用的,和execute_values要求的纯值元组列表参数格式不兼容,就算解决了格式符报错,后续也会出现参数长度不匹配的问题。
具体修正方案
- 生成列占位符时,去掉列名绑定,按照DataFrame的列数生成对等数量的通用位置占位符,不要用带字段名的
sql.Placeholder - 提取DataFrame值时直接转成纯值元组列表,不要转成字典结构
- 保留原有的
psycopg2.sql安全转义逻辑,避免SQL注入风险
修正后可直接运行的代码
# 需提前补充导入依赖 from psycopg2 import sql, extras def execute_values(conn, df, schema, table): # 提取DataFrame的纯值元组列表,适配execute_values的参数要求 values_list = [tuple(row) for row in df.to_numpy()] # 安全转义表名、列名,避免注入风险 columns = sql.SQL(',').join(map(sql.Identifier, df.columns.tolist())) # 生成和列数匹配的通用位置占位符,不带列名 placeholders = sql.SQL(',').join(sql.Placeholder() for _ in range(len(df.columns))) query = sql.SQL('INSERT INTO {} ({}) VALUES ({})').format( sql.Identifier(schema, table), columns, placeholders ) cursor = conn.cursor() try: extras.execute_values(cursor, query, values_list) conn.commit() except (Exception, psycopg2.DatabaseError) as error: print(f"Error: {error}") conn.rollback() cursor.close() raise print("execute_values() done") cursor.close()
额外避坑提醒
不要把psycopg2.sql构造的安全SQL对象和Python原生的%字符串格式化混用,之前很多人遇到这个报错,都是因为直接把写了%s的SQL字符串当成普通字符串用%拼接参数,导致%后面跟的内容被当成格式符解析出问题。
内容的提问来源于stack exchange,提问作者Josef
相关产品推荐
相关产品推荐

