You need to enable JavaScript to run this app. 使用psycopg2动态插入pandas DataFrame到PostgreSQL报unsupported format character '('错误求助
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 01:45:03