ClickHouse/metabase-clickhouse-driver

ClickHouse database driver for the Metabase business intelligence front-end

509

stars

243

commits

Clojure

primary language

Jun 13, 2025

updated

analytics
bi-tools
business-intelligence
clickhouse
metabase

README

ClickHouse driver for Metabase


About

The Metabase team promoted the ClickHouse driver to the core level as of Metabase 54 (release notes, driver source).

For the end user, this means the following:

  • Installing the driver manually is unnecessary, as it is now bundled with Metabase.
  • Starting from April 2025, the Metabase team will continue maintaining the driver. Please report new issues in the main Metabase repository.

The ClickHouse team recommends avoiding older Metabase versions (53.x and earlier) with manual driver installation; instead, please use the updated Metabase distribution with the driver built-in.

History

The request for a ClickHouse Metabase driver was formulated in 2016 in Metabase issue #3332. Several impatient ClickHouse users started the development in the main Metabase repo. In March 2019, after releasing the plugin SDK, the Metabase team asked to publish the driver separately in its own repository, and later that month, with Felix Mueller (@enqueue) leading the efforts, the initial version of the driver was out.

The original implementation of the driver was based on the following pull requests:

The source base in these PRs comprises major contributions from these authors:

[!NOTE] Special thanks to Felix Mueller (@enqueue), who was the sole maintainer of the project from 2019 to 2022 before transferring it to ClickHouse.

Starting from November 2022, Serge Klochkov (@slvrtrn) joined as a maintainer.

In early 2023, the repository was transferred to the ClickHouse organization, promoting it as an official integration. Around that time, the driver also became available in Metabase Cloud.

In April 2025, the driver source code was moved to the main Metabase repository. Since Metabase 54, it is now available as a part of the official Metabase bundle.

Contributors

slvrtrn

151 commits

enqueue

57 commits

wotbrew

7 commits

mshustov

6 commits

ClickHouse/metabase-clickhouse-driver

ClickHouse database driver for the Metabase business intelligence front-end

509

stars

243

commits

Clojure

primary language

Jun 13, 2025

updated

analytics
bi-tools
business-intelligence
clickhouse
metabase

README

ClickHouse driver for Metabase


About

The Metabase team promoted the ClickHouse driver to the core level as of Metabase 54 (release notes, driver source).

For the end user, this means the following:

  • Installing the driver manually is unnecessary, as it is now bundled with Metabase.
  • Starting from April 2025, the Metabase team will continue maintaining the driver. Please report new issues in the main Metabase repository.

The ClickHouse team recommends avoiding older Metabase versions (53.x and earlier) with manual driver installation; instead, please use the updated Metabase distribution with the driver built-in.

History

The request for a ClickHouse Metabase driver was formulated in 2016 in Metabase issue #3332. Several impatient ClickHouse users started the development in the main Metabase repo. In March 2019, after releasing the plugin SDK, the Metabase team asked to publish the driver separately in its own repository, and later that month, with Felix Mueller (@enqueue) leading the efforts, the initial version of the driver was out.

The original implementation of the driver was based on the following pull requests:

The source base in these PRs comprises major contributions from these authors:

[!NOTE] Special thanks to Felix Mueller (@enqueue), who was the sole maintainer of the project from 2019 to 2022 before transferring it to ClickHouse.

Starting from November 2022, Serge Klochkov (@slvrtrn) joined as a maintainer.

In early 2023, the repository was transferred to the ClickHouse organization, promoting it as an official integration. Around that time, the driver also became available in Metabase Cloud.

In April 2025, the driver source code was moved to the main Metabase repository. Since Metabase 54, it is now available as a part of the official Metabase bundle.

Contributors

slvrtrn

151 commits

enqueue

57 commits

wotbrew

7 commits

mshustov

6 commits

Languages

Clojure

95.6%

Python

3.6%