设置

在 Windows 上使用 DuckDB ODBC API 需要执行以下步骤

1. Microsoft Windows 需要一个 ODBC 驱动程序管理器来管理应用程序与 ODBC 驱动程序之间的通信。Windows 上的驱动程序管理器包含在 odbccp32.dll 文件以及其他文件和工具中。有关详细信息，请参阅通用 ODBC 组件文件。

2. DuckDB 将 ODBC 驱动程序作为资产发布。对于 Windows，请从此处下载：Windows ODBC 资产 (x86_64/AMD64)。

3. 该压缩包包含以下工件：

   • duckdb_odbc.dll：为 Windows 编译的 DuckDB 驱动程序。
   • duckdb_odbc_setup.dll：由 Windows ODBC 数据源管理器工具使用的安装 DLL。
   • odbc_install.exe：一个用于辅助 Windows 配置的安装脚本。

   将压缩包解压到某个目录（例如 duckdb_odbc）。

4. odbc_install.exe 二进制文件负责在 Windows 上配置 DuckDB ODBC 驱动程序。它依赖于提供配置 ODBC 注册表条目功能的 Odbccp32.dll。

   在永久目录（例如 duckdb_odbc）内，双击运行 odbc_install.exe。

   需要 Windows 管理员权限。如果是普通用户，系统会弹出用户帐户控制 (UAC) 提示。

5. odbc_install.exe 会在 ODBC 注册表中添加一个默认的 DSN 配置，其中默认数据库为 :memory:。

DSN Windows 设置

安装完成后，可以使用 Windows ODBC 数据源管理器工具 odbcad32.exe 更改默认 DSN 配置或添加新的 DSN。

也可以通过 Windows 开始菜单启动该工具。

默认 DuckDB DSN

新安装的 DSN 在 Windows ODBC 数据源管理器工具的系统 DSN 选项卡中可见。

更改 DuckDB DSN

当选择默认 DSN（即 DuckDB）或添加新配置时，会显示以下设置窗口：

此窗口允许您设置 DSN 以及与该 DSN 关联的数据库文件路径。

更详细的 Windows 设置

有两种配置 ODBC 驱动程序的方法：一是如下所述修改注册表项，二是使用 SQLDriverConnect 进行连接。也可以结合使用这两种方法。

此外，该 ODBC 驱动程序支持 DuckDB 中包含的所有配置选项。

如果在传递给 SQLDriverConnect 的连接字符串和 odbc.ini 文件中同时设置了相同的配置，则传递给 SQLDriverConnect 的设置优先。

有关配置参数的详细信息，请参阅ODBC 配置页面。

注册表项

Windows 上的 ODBC 设置基于注册表项（请参阅ODBC 组件的注册表条目）。ODBC 条目可以放置在当前用户注册表项 (HKCU) 或系统注册表项 (HKLM) 中。

我们已经在基于 HKLM->SOFTWARE->ODBC 的系统条目上进行了测试和使用。odbc_install.exe 会修改该条目，该条目具有两个子项：ODBC.INI 和 ODBCINST.INI。

ODBC.INI 是用户通常插入驱动程序 DSN 注册表条目的地方。

例如，DuckDB 的 DSN 注册表如下所示：

ODBCINST.INI 包含每个 ODBC 驱动程序的一个条目以及为Windows ODBC 配置预定义的其他键。

更新 ODBC 驱动程序

当发布新版本的 ODBC 驱动程序时，安装新版本会覆盖现有版本。但是，安装程序并不总是更新注册表中的版本号。为确保使用正确的版本，请检查 HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\DuckDB Driver 是否具有最新版本，并确保 HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\DuckDB\Driver 指向新驱动程序的正确路径。