Adapter: chDB

The chDB adapter was contributed by the chDB team.

See the harlequin-chdb repository for the latest documentation.

Installation

Install Harlequin with the chDB adapter:

$ uv tool install 'harlequin[chdb]'

Usage

Run an in-memory database:

$ harlequin -a chdb

Use a persistent local database:

$ harlequin -a chdb /path/to/chdb-data

You can also pass a chDB ADBC URI with --uri, or use --path for a persistent database directory. Add --read-only to prevent writes and --show-system to include system databases in the catalog.

The adapter is also available to hsql:

$ hsql -a chdb -c "SELECT 1 AS value"