ClickHouse/metabase-clickhouse-driver

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:

• metabase#8491
• metabase#8722
• metabase#9469

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

• @tsl-karlp
• Andrew Grigorev (@ei-grad)
• Bogdan Mukvich (@Badya)
• Felix Mueller (@enqueue)

[!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.