Skip to content
This repository was archived by the owner on Apr 28, 2025. It is now read-only.

ClickHouse database driver for the Metabase business intelligence front-end

License

Notifications You must be signed in to change notification settings

ClickHouse/metabase-clickhouse-driver

Repository files navigation

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.