ClickHouse/clickhouse-java

Última atividade de origem registrada: 20 de agosto de 2026 às 18:53

Catálogo do SkillsMP atualizado: 29 de outubro de 2026 às 18:30

skills coletadas: 4

Estrelas no GitHub: 1.630
Forks no GitHub: 642

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/ClickHouse/clickhouse-java.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

<div align="center"> <p> <a href="https://github.com/ClickHouse/clickhouse-java/releases/latest"><img src="https://img.shields.io/github/v/release/ClickHouse/clickhouse-java?include_prereleases&label=Latest%20Release&color=green"/></a> <a href="https://github.com/ClickHouse/clickhouse-java/releases/"><img src="https://img.shields.io/github/downloads/ClickHouse/clickhouse-java/latest/total"/></a> </p> <p><img src="https://github.com/ClickHouse/clickhouse-js/blob/a332672bfb70d54dfd27ae1f8f5169a6ffeea780/.static/logo.svg" width="200px" align="center"></p> <h1>ClickHouse Java Client & JDBC Driver</h1> </div> Table of Contents * [About The project](#about-the-project) * [Client Features](#client-features) * [Important](#important) * [Installation](#installation) * [Client V2](#client-v2) * [Artifacts](#artifacts) * [Examples](#examples) * [Client V1](#client-v1) * [Artifacts](#artifacts-1) * [Examples](#examples-1) * [Contributing](#contributing) ## About the Project This is the repository for the Java Client and JDBC Driver for the [ClickHouse database](https://github.com/ClickHouse/ClickHouse), supported by the [ClickHouse](https://clickhouse.com) team. The Java Client is the core component that provides an API to interact with the database via HTTP Protocol. The JDBC driver component implements the JDBC specification and communicates with ClickHouse using the Java Client API. The client and driver work with both ClickHouse Cloud and self-hosted ClickHouse. You can [start a free Cloud trial](https://console.clickhouse.cloud/signUp?utm_medium=referral&utm_source=github&utm_campaign=readme&utm_content=clickhouse-java) or [install ClickHouse](https://clickhouse.com/docs/get-started/setup/install) locally. Historically, there are two versions of both components. The previous version of the Java client required a significant rewrite, so we decided to create a new one, `client-v2`, not to disturb anyone's work and to give time for migration. The JDBC driver also required changes to be compatible with the new client and comply more with JDBC specs, and we created `jdbc-v2`. This component will replace an old version (to keep the artifact name). ## Client Features | Name | Client V2 | Client V1 | Comments |----------------------------------------------|:---------:|:---------:|:---------:| | Http Connection |✔ |✔ | | | Http Compression (LZ4) |✔ |✔ | | | Server Response Compression - LZ4 |✔ |✔ | | | Client Request Compression - LZ4 |✔ |✔ | | | HTTPS |✔ |✔ | | | Client SSL Cert (mTLS) |✔ |✔ | | | Http Proxy with Authentication |✔ |✔ | | | Java Object SerDe |✔ |✗ | | | Connection Pool |✔ |✔ | Apache HTTP Client only | | Named Parameters |✔ |✔ | | | Retry on failure |✔ |✔ | | | Failover |✗ |✔ | | | Load-balancing |✗ |✔ | | | Server auto-discovery |✗ |✔ | | | Log Comment |✔ |✔ | | | Session Roles |✔ |✔ | | | SSL Client Authentication |✔ |✔ | | | Session timezone |✔ |✔ | | ## Important ### Artifact Changes in 0.9.0 (June) We are going to retire some JDBC artifacts (actually only classifiers) in *0.9.0*. Here is the list: | Artifact | Classifier | Comments | |-----------------|---------|----------------------| | clickhouse-jdbc | shaded | Use one with `all` classifier instead | | clickhouse-jdbc | http | | | clickhouse-jdbc | shaded-all | Use one with `all` classifier instead | Artifact `com.clickhouse:clickhouse-jdbc` remains untouched. Artifact `com.clickhouse:clickhouse-jdbc:0.9.0:all` will contain all required classes. ### Upcoming deprecations: | Component | Version | Comment | |--------------------------------|---------|--------------------------------------------------| | ClickHouse Java v1 | TBC | We'll be deprecating Java v1 in 2025 | ## Installation Releases: Maven Central (web site https://mvnrepository.com/artifact/com.clickhouse) Nightly Builds: https://s01.oss.sonatype.org/content/repositories/snapshots/com/clickhouse/ ## Client V2 ### Artifacts | Component | Maven Central Link | Javadoc Link | Documentation Link | |---------------------------|--------------------|--------------|---------------------| | ClickHouse Java Client V2 | [![Maven Central](https://img.shields.io/maven-central/v/com.clickhouse/client-v2)](https://mvnrepository.com/artifact/com.clickhouse/client-v2) | [![javadoc](https://javadoc.io/badge2/com.clickhouse/client-v2/javadoc.svg)](https://javadoc.io/doc/com.clickhouse/client-v2) | [docs](https://clickhouse.com/docs/integrations/java) | ### Examples [Begin-with Usage Examples](../../tree/main/examples/client-v2) [Spring Demo Service](https://github.com/ClickHouse/clickhouse-java/tree/main/examples/demo-spring-service) ## JDBC Driver ### Artifacts | Component | Maven Central Link | Javadoc Link | Documentation Link | |-----------|--------------------|--------------|--------------------| | ClickHouse JDBC Driver | [![Maven Central](https://img.shields.io/maven-central/v/com.clickhouse/clickhouse-jdbc)](https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc) |[![javadoc](https://javadoc.io/badge2/com.clickhouse/clickhouse-jdbc/javadoc.svg)](https://javadoc.io/doc/com.clickhouse/clickhouse-jdbc)|[docs](https://clickhouse.com/docs/integrations/language-clients/java/jdbc)| ### Examples See [JDBC examples](../../tree/main/examples/jdbc) ## R2DBC Driver ### Artifacts | Component | Maven Central Link | Javadoc Link | Documentation Link | |-----------|--------------------|--------------|--------------------| | ClickHouse R2DBC Driver | [![Maven Central](https://img.shields.io/maven-central/v/com.clickhouse/clickhouse-r2dbc)](https://mvnrepository.com/artifact/com.clickhouse/clickhouse-r2dbc) | [![javadoc](https://javadoc.io/badge2/com.clickhouse/clickhouse-r2dbc/javadoc.svg)](https://javadoc.io/doc/com.clickhouse/clickhouse-r2dbc) | [docs](https://clickhouse.com/docs/integrations/java/r2dbc)| ### Misc Artifacts | Component | Maven Central Link | Javadoc Link | |-----------|--------------------|--------------| | ClickHouse Java Unified Client | [![Maven Central](https://img.shields.io/maven-central/v/com.clickhouse/clickhouse-client)](https://mvnrepository.com/artifact/com.clickhouse/clickhouse-client) | [![javadoc](https://javadoc.io/badge2/com.clickhouse/clickhouse-client/javadoc.svg)](https://javadoc.io/doc/com.clickhouse/clickhouse-client) | | ClickHouse Java HTTP Client | [![Maven Central](https://img.shields.io/maven-central/v/com.clickhouse/clickhouse-http-client)](https://mvnrepository.com/artifact/com.clickhouse/clickhouse-http-client) | [![javadoc](https://javadoc.io/badge2/com.clickhouse/clickhouse-http-client/javadoc.svg)](https://javadoc.io/doc/com.clickhouse/clickhouse-http-client) | ## Compatibility - All projects in this repo are tested with all [active LTS versions](https://github.com/ClickHouse/ClickHouse/pulls?q=is%3Aopen+is%3Apr+label%3Arelease) of ClickHouse. - [Support policy](https://github.com/ClickHouse/ClickHouse/blob/master/SECURITY.md#security-change-log-and-support) - We recommend to upgrade client continuously to not miss security fixes and new improvements - If you have an issue with migration - create and issue and we will respond! ## Contributing Please see our [contributing guide](./CONTRIBUTING.md).

Carregando o README do repositório…

Skills neste repositório

Desenvolvedores de software Analistas de garantia de qualidade de software e testadores Desenvolvedores web

3 categorias ocupacionais · 100% classificado

skill

ocupação

descrição

atualizado

write-doc-examples

Desenvolvedores web

Write, rewrite, and format documentation code snippets into reusable, production-ready methods with necessary library imports and clean linting. Use when writing, updating, or formatting Java code examples in integration guides and documentation (such as…

Idioma do texto original: inglês

2026-08-20

triage-issues

Desenvolvedores de software

Analyzes a single GitHub issue at a time. Reads the description, defines labels and priority, researches additional information, and provides a short but detailed report. Use when the user asks to triage an issue, analyze a bug report, or categorize a GitHub…

Idioma do texto original: inglês

2026-06-16

update-keyword-engine-lists

Desenvolvedores de software

Update ALLOWED_KEYWORD_ALIASES in ClickHouseSqlUtils.java and ENGINE_TO_TABLE_TYPE in DatabaseMetaDataImpl.java from failing test output. Use when StatementSQLTest.testAllowedKeywordAliasesMatchSystemKeywords or…

Idioma do texto original: inglês

2026-05-27

code-review

Analistas de garantia de qualidade de software e testadores

Review changes in clickhouse-java for correctness, compatibility, API stability, and missing tests. Use when reviewing pull requests, commits, diffs, patches, or when the user asks for a code review.

Idioma do texto original: inglês

2026-03-30

Mostrando 4 de 4 skills coletadas.