如何使用psycopg2指定ANSI驱动连接PostgreSQL解决跨编码迁移报错

AI 小北

2026-9-26

问题解答

核心结论

psycopg2是PostgreSQL原生Python适配器，不属于ODBC驱动体系，不支持指定ODBC层面的ANSI/Unicode驱动。你之前的连接串写法混淆了psycopg2和ODBC驱动的配置规则，所以无法生效。

可落地解决方案

方案一：使用pyodbc指定ANSI驱动（复现ETL工具成功逻辑）

该方案和你之前在ETL工具中的处理逻辑完全一致，适配性最高：

首先在运行环境中安装对应PostgreSQL版本的ODBC ANSI驱动
使用pyodbc库建立连接，示例代码如下：

import pyodbc
conn_str = (
    "DRIVER={PostgreSQL ANSI};"
    f"SERVER={stage_host};"
    f"PORT={stage_port};"
    f"DATABASE={stage_database};"
    f"UID={stage_user};"
    f"PWD={stage_password};"
)
conn = pyodbc.connect(conn_str)
cursor = conn.cursor()
# 执行编码设置
cursor.execute("SET client_encoding = 'windows-1252';")

数据迁移可结合批量读写或者PostgreSQL原生COPY方法，性能可支撑百万级数据量。

方案二：修正psycopg2编码配置直接使用

你之前使用psycopg2报错是因为编码设置的执行逻辑错误，按以下步骤调整即可正常使用：

你之前的错误点：将SET client_encoding语句和查询语句放在同一个execute调用中执行，编码设置还未生效就启动了数据查询，导致编码报错。
正确使用示例：

import psycopg2
# 标准方式建立连接，可直接在连接参数中指定客户端编码
conn = psycopg2.connect(
    host=stage_host,
    port=stage_port,
    database=stage_database,
    user=stage_user,
    password=stage_password,
    options="-c client_encoding=windows-1252"
)
conn.autocommit = True
cur = conn.cursor()
# 直接执行COPY操作
with open("sql_tmp_export.csv", "w", encoding="utf-8", errors="ignore") as f:
    cur.copy_to(f, "table", sep=";", columns=("no","description"))