使用Polars将DataFrame写入SQLite数据库时触发OperationalError

问题场景 #

尝试用Polars把DataFrame写入SQLite数据库，初始代码如下：

import polars as pl
import sqlite3

conn = sqlite3.connect("test.db")
df = pl.DataFrame({"col1": [1, 2, 3]})

按照pl.write_database的要求传入SQLite连接URI字符串后，执行代码：

df.write_database("test_table", f"sqlite:////test.db", if_table_exists="replace")

触发以下错误：

OperationalError: (sqlite3.OperationalError) unable to open database file

解决步骤 #

• 执行命令安装所需依赖：

pip install polars[sqlalchemy]

原因说明 #

Polars的write_database方法依赖SQLAlchemy处理数据库连接逻辑（包括解析SQLite的URI格式）。未安装该依赖时，无法正确识别URI形式的连接字符串，进而导致数据库文件无法打开。

内容的提问来源于stack exchange，提问作者Péter Szilvási