https://github.com/ClickHouse/metabase-clickhouse-driver
ClickHouse database driver for the Metabase business intelligence front-end
https://github.com/ClickHouse/metabase-clickhouse-driver
analytics bi-tools business-intelligence clickhouse metabase
Last synced: about 2 months ago
JSON representation
ClickHouse database driver for the Metabase business intelligence front-end
- Host: GitHub
- URL: https://github.com/ClickHouse/metabase-clickhouse-driver
- Owner: ClickHouse
- License: apache-2.0
- Created: 2019-03-11T23:01:26.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-21T14:46:19.000Z (8 months ago)
- Last Synced: 2024-10-22T00:38:32.808Z (8 months ago)
- Topics: analytics, bi-tools, business-intelligence, clickhouse, metabase
- Language: Clojure
- Homepage:
- Size: 505 KB
- Stars: 477
- Watchers: 18
- Forks: 92
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS.md
Awesome Lists containing this project
- awesome-clickhouse - ClickHouse/metabase-clickhouse-driver - A ClickHouse database driver enabling integration with the Metabase business intelligence front-end for data visualization and querying. (Language bindings / Java)
- awesome-repositories - ClickHouse/metabase-clickhouse-driver - ClickHouse database driver for the Metabase business intelligence front-end (Clojure)
- awesome-metabase - Clickhouse
- awesome-metabase - Clickhouse
README
ClickHouse driver for Metabase
## About
The Metabase team promoted the ClickHouse driver to the core level as of Metabase 54 ([release notes](https://github.com/metabase/metabase/releases/tag/v0.54.1), [driver source](https://github.com/metabase/metabase/tree/v0.54.x/modules/drivers/clickhouse)).
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](https://github.com/metabase/metabase/issues).
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](https://github.com/metabase/metabase/issues/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](https://github.com/metabase/metabase/pull/8491#issuecomment-471721980) in its own repository, and later that month, with Felix Mueller ([@enqueue](https://github.com/enqueue)) leading the efforts, the [initial version of the driver](https://github.com/ClickHouse/metabase-clickhouse-driver/releases/tag/v0.1) was out.
The original implementation of the driver was based on the following pull requests:
- [metabase#8491](https://github.com/metabase/metabase/pull/8491)
- [metabase#8722](https://github.com/metabase/metabase/pull/8722)
- [metabase#9469](https://github.com/metabase/metabase/pull/9469)
The source base in these PRs comprises major contributions from these authors:
- [@tsl-karlp](https://github.com/tsl-karlp)
- Andrew Grigorev ([@ei-grad](https://github.com/ei-grad))
- Bogdan Mukvich ([@Badya](https://github.com/Badya))
- Felix Mueller ([@enqueue](https://github.com/enqueue))
> [!NOTE]
> Special thanks to Felix Mueller ([@enqueue](https://github.com/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](https://github.com/slvrtrn)) joined as a maintainer.
In early 2023, the repository was transferred to the ClickHouse organization, promoting it as an [official integration](https://clickhouse.com/blog/metabase-clickhouse-plugin-ga-release). Around that time, the driver also became available in [Metabase Cloud](https://www.metabase.com/cloud).
In April 2025, the driver source code [was moved](https://github.com/metabase/metabase/pull/54740) to the main Metabase repository. Since [Metabase 54](https://github.com/metabase/metabase/releases/tag/v0.54.1), it is now available as a part of the official Metabase bundle.