⌘+k ctrl+k
1.4 (stable)
Search Shortcut cmd + k | ctrl + k
ODBC API on macOS

  1. A driver manager is required to manage communication between applications and the ODBC driver. DuckDB supports unixODBC, which is a complete ODBC driver manager for macOS and Linux. Users can install it from the command line via Homebrew:

    brew install unixodbc

  2. DuckDB releases a universal ODBC driver for macOS (supporting both Intel and Apple Silicon CPUs). To download it, run:

    wget https://github.com/duckdb/duckdb-odbc/releases/download/v1.4.1.0/duckdb_odbc-osx-universal.zip

  3. The archive contains the libduckdb_odbc.dylib artifact. To extract it to a directory, run:

    mkdir duckdb_odbc && unzip duckdb_odbc-osx-universal.zip -d duckdb_odbc

  4. There are two ways to configure the ODBC driver, either by initializing via the configuration files, or by connecting with SQLDriverConnect. A combination of the two is also possible.

    Furthermore, the ODBC driver supports all the configuration options included in DuckDB.

    If a configuration is set in both the connection string passed to SQLDriverConnect and in the odbc.ini file, the one passed to SQLDriverConnect will take precedence.

    For the details of the configuration parameters, see the ODBC configuration page.

  5. After the configuration, to validate the installation, it is possible to use an ODBC client. unixODBC uses a command line tool called isql.

    Use the DSN defined in odbc.ini as a parameter of isql.

    isql DuckDB

    +---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| echo [string]                         |
| quit                                  |
|                                       |
+---------------------------------------+

    SQL> SELECT 42;

    +------------+
| 42         |
+------------+
| 42         |
+------------+

SQLRowCount returns -1
1 rows fetched
About this page
© 2025 DuckDB Foundation, Amsterdam NL
Code of Conduct Trademark Use