Download ClickHouse JDBC Driver
What Is a JDBC Driver?
A JDBC driver is a Java library file (.jar) that enables Java applications — including DbSchema — to communicate with a database over a standard API. The driver translates generic JDBC calls into the network protocol understood by ClickHouse, so you never have to write low-level socket code. Drivers are typically distributed by the database vendor or as open-source projects.
Understanding the JDBC URL
Every JDBC driver identifies the target database through a connection URL. The URL encodes the hostname, port, database name, and any driver-specific parameters as a single string. The exact syntax varies per driver — the details for ClickHouse are listed in the section below.
Download the ClickHouse JDBC Driver
ClickHouse is a high-performance columnar OLAP database developed by Yandex, optimized for real-time analytical queries over billions of rows. It is used by companies like Cloudflare, Uber, and eBay for log analytics, business intelligence, and event tracking.
ClickHouse JDBC Driver Details
- Required File(s): clickhouse-jdbc-xxx.jar
- Java Driver Class: com.clickhouse.jdbc.ClickHouseDriver
- JDBC URL: jdbc:clickhouse://host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database]?key1=value1&key2=value2]
- Website: ClickHouse Java Driver on GitHub
The driver is built on top of the native ClickHouse Java Driver.
For connecting to multiple hosts you can pass a URL like: jdbc:clickhouse://host1:8123,host2:8123/my_database?user=admin&password=secret&ssl=true
Downloading the ClickHouse JDBC Driver
Download ClickHouse JDBC Driver
The driver archive is a zip file. Unzip the downloaded archive to get the driver files. The driver source code can be found on the GitHub repository. Check the GitHub link for details on how to use the driver and configure SSL.
DbSchema and ClickHouse
DbSchema renders ClickHouse tables, MaterializedViews, and Distributed table engines in the schema diagram. Use the Visual Query Builder to compose analytical queries with GROUP BY, HAVING, and window functions against ClickHouse's columnar storage.
Have connection issues? Contact the DbSchema team for help.
Explore ClickHouse Visually with DbSchema
Once the JDBC driver is configured, DbSchema connects to your ClickHouse database and gives you a full graphical workbench — no command-line required. Available as a free Community Edition and a full-featured PRO Edition. No registration needed to get started.
Interactive ER Diagrams
Reverse-engineer your ClickHouse schema into a drag-and-drop ER diagram. Arrange tables visually, add new columns, define foreign keys, and let DbSchema generate the DDL — all without writing SQL by hand.
Visual Query Builder
Compose ClickHouse queries by clicking on tables and columns — no SQL knowledge required. Add joins, filters, groupings, and aggregations through a point-and-click interface, then copy the generated SQL or run it directly against the live database.
Relational Data Explorer
Browse ClickHouse table data and follow foreign key relationships across tables in a single view. Edit cells inline, filter rows, and paginate through large datasets — all without leaving the explorer.
Schema Synchronization
Compare your ClickHouse schema across development, staging, and production environments. DbSchema generates the exact ALTER statements needed to close the gap and lets you review every change before executing — reducing the risk of unintended schema drift.
SQL Editor
Write and execute ClickHouse queries in the integrated SQL editor with schema-aware autocomplete, syntax highlighting, and instant result display. Run scripts, inspect execution plans, and export results to CSV or JSON from a single interface.
HTML Schema Documentation
Generate a static HTML site documenting every table, column, type, index, and relationship in your ClickHouse schema. Share it with your team or embed it in your project wiki — no extra tooling required.
For the full feature list and edition comparison, visit the DbSchema PRO Edition page.