DuckDB版本升级后无法读取旧库，求Python版EXPORT/IMPORT语法

问题背景 #

升级DuckDB后出现如下报错：

duckdb.IOException: IO Error: Trying to read a database file with version number 39, but we can only read version 43.
The database file was created with DuckDB version v0.6.0 or v0.6.1.

由于DuckDB 1.0之前存储格式未稳定，新旧版本数据库文件无法互相读取，需要通过导出-导入的方式迁移数据。

Python环境下的迁移步骤 #

1. 使用旧版本DuckDB导出数据库 #

首先安装与旧数据库匹配的DuckDB版本（比如v0.6.1）：

pip install duckdb==0.6.1

然后运行以下代码导出旧数据库：

import duckdb

# 连接旧数据库文件
conn = duckdb.connect('old_database.db')

# 将数据库导出到指定目录
conn.execute("EXPORT DATABASE 'exported_old_db'")

conn.close()

2. 使用新版本DuckDB导入数据库 #

安装当前使用的新版本DuckDB后，运行以下代码导入数据：

import duckdb

# 创建并连接新数据库文件
conn = duckdb.connect('new_database.db')

# 从导出目录导入数据
conn.execute("IMPORT DATABASE 'exported_old_db'")

# 可选：验证导入结果，查看所有表
print("导入的表列表：", conn.execute("SHOW TABLES").fetchall())

conn.close()

注意事项 #

• 导出目录会生成完整的数据库结构文件，请勿修改目录内的文件或结构
• 确保旧版本DuckDB与数据库创建版本严格匹配（v0.6.0或v0.6.1）
• 操作时注意文件路径权限，避免因权限不足导致导出/导入失败

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