使用pandas .to_sql()向Snowflake上传数据时小写列名识别异常问题

问题原因 #

Snowflake对未加双引号的标识符会自动转为大写，你的DataFrame中bb列在生成的INSERT语句里未被添加双引号，被解析为BB，但目标表实际列名为小写bb，因此触发invalid identifier 'BB'错误。

解决方案 #

1. 创建SQLAlchemy引擎时强制引用所有标识符 #

在创建Snowflake引擎时，通过connect_args设置quote_identifiers=True，让SQLAlchemy自动给所有列名、表名添加双引号：

from sqlalchemy import create_engine

# 替换为你的Snowflake连接信息
engine = create_engine(
    'snowflake://<user>:<password>@<account>/<database>/<schema>?warehouse=<warehouse>&role=<role>',
    connect_args={'quote_identifiers': True}
)

# 执行数据上传
df.to_sql('table', engine, if_exists='append', index=False)

这样生成的INSERT语句中，bb会被转为"bb"，与目标表的列名匹配。

2. 确保会话配置生效（备选方案） #

如果要使用quoted_identifiers_ignore_case = True，需要在同一个会话中执行配置和数据上传，避免跨会话失效：

from sqlalchemy import create_engine

engine = create_engine('snowflake://<your-connection-string>')

# 在当前会话中设置参数
with engine.connect() as conn:
    conn.execute("alter session set quoted_identifiers_ignore_case = True")
    conn.commit()

# 同一引擎会话下执行上传
df.to_sql('table', engine, if_exists='append', index=False)

该配置让Snowflake对带双引号的标识符忽略大小写，即使列名是"bb"，插入BB也能匹配，但不如强制加引号直接可靠。

3. 检查目标表的创建方式 #

确认你的Snowflake表是用双引号定义列名的，比如：

CREATE TABLE "table" (
    "AA" STRING,
    "Ba" STRING,
    "bb" STRING
);

如果创建表时未加双引号，列名会被自动转为大写BB，此时你需要修改DataFrame列名为BB，或者重新创建带双引号列名的表。

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