使用pandas to_sql()写入空DataFrame至SQLite时遇OperationalError问题咨询

问题原因分析 #

当你尝试将空DataFrame通过to_sql()写入SQLite，并且设置index=False时，Pandas生成的CREATE TABLE SQL语句会出现语法错误——因为空DataFrame没有列，导致语句变成了类似CREATE TABLE temp ()的格式，而SQLite不允许括号内为空的建表语句。同时，Pandas在处理这种场景时还会错误地拼接表名，导致表名变成temp (\n)(\n)，进一步触发sqlite3.OperationalError: near ")": syntax error报错。

解决方案 #

你可以通过以下几种方式解决这个问题：

1. 提前判断DataFrame是否为空，手动处理空表场景

如果DataFrame为空，先手动创建一个符合需求的空表，再执行写入操作：

import pandas as pd
import sqlite3

con = sqlite3.connect("C:\\an_user_dir\\a_base.sqlite")
df = pd.DataFrame()

if df.empty:
    # 手动创建空表（可自定义列，这里先加临时列再删除）
    con.execute("CREATE TABLE IF NOT EXISTS temp (temp_col INTEGER)")
    con.execute("ALTER TABLE temp DROP COLUMN temp_col")
else:
    df.to_sql('temp', con, if_exists="replace", index=False)
con.commit()
con.close()

2. 临时添加虚拟列，写入后删除

给空DataFrame添加一个临时列，写入完成后再删除该列：

import pandas as pd
import sqlite3

con = sqlite3.connect("C:\\an_user_dir\\a_base.sqlite")
df = pd.DataFrame()

if df.empty:
    df['temp_col'] = pd.Series(dtype='int')
    df.to_sql('temp', con, if_exists="replace", index=False)
    # 清理临时列
    con.execute("ALTER TABLE temp DROP COLUMN temp_col")
else:
    df.to_sql('temp', con, if_exists="replace", index=False)
con.commit()
con.close()

3. 升级Pandas到修复该Bug的版本

这个问题在Pandas的后续版本中已经被修复（建议升级到最新稳定版，比如1.3.0及之后的版本），升级后空DataFrame搭配index=False的场景会被正确处理，不会再触发语法错误。

补充说明 #

你之前测试的pd.DataFrame().to_sql('temp', con, if_exists="replace")不报错，是因为没有设置index=False，Pandas会自动将索引列作为表的一列写入，此时建表语句有合法的列定义，因此不会触发语法错误。

内容的提问来源于stack exchange，提问作者Gabriel Durán