com.github.housepower:examples

ClickHouse Native Protocol JDBC implementation

License

License

GroupId

GroupId

com.github.housepower
ArtifactId

ArtifactId

examples
Last Version

Last Version

2.4.4
Release Date

Release Date

Type

Type

jar
Description

Description

ClickHouse Native Protocol JDBC implementation

Download examples

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.housepower/examples/ -->
<dependency>
    <groupId>com.github.housepower</groupId>
    <artifactId>examples</artifactId>
    <version>2.4.4</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.housepower/examples/
implementation 'com.github.housepower:examples:2.4.4'
// https://jarcasting.com/artifacts/com.github.housepower/examples/
implementation ("com.github.housepower:examples:2.4.4")
'com.github.housepower:examples:jar:2.4.4'
<dependency org="com.github.housepower" name="examples" rev="2.4.4">
  <artifact name="examples" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.housepower', module='examples', version='2.4.4')
)
libraryDependencies += "com.github.housepower" % "examples" % "2.4.4"
[com.github.housepower/examples "2.4.4"]

Dependencies

compile (1)

Group / Artifact Type Version
com.github.housepower : clickhouse-native-jdbc jar 2.4.4

Project Modules

There are no modules declared in this project.

ClickHouse Native JDBC

Build Status codecov.io Maven Central Total alerts Language grade: Java License

English | 简体中文

Home Page | GitHub | Gitee

A Native JDBC library for accessing ClickHouse in Java, also provide a library for integrating with Apache Spark.

CONTRIBUTE

We welcome anyone that wants to help out in any way, whether that includes reporting problems, helping with documentations, or contributing code changes to fix bugs, add tests, or implement new features. Please follow Contributing Guide.

Supported by JetBrains Open Source License 2020-2021.

JDBC Driver

Requirements

  • Java 8/11.

Notes: We only do test with Java LTS versions.

Differences from yandex/clickhouse-jdbc

  • Data is organized and compressed by columns.
  • Implemented in the TCP Protocol, with higher performance than HTTP, here is the benchmark report.

Limitations

  • Not support insert complex values expression, like INSERT INTO test_table VALUES(toDate(123456)), but query is ok.
  • Not support insert non-values format, like TSV.
  • Not support more compression method, like ZSTD.

Import

  • Gradle
// (recommended) shaded version, available since 2.3-stable
compile "com.github.housepower:clickhouse-native-jdbc-shaded:${clickhouse_native_jdbc_version}"

// normal version
compile "com.github.housepower:clickhouse-native-jdbc:${clickhouse_native_jdbc_version}"
  • Maven
<!-- (recommended) shaded version, available since 2.3-stable -->
<dependency>
    <groupId>com.github.housepower</groupId>
    <artifactId>clickhouse-native-jdbc-shaded</artifactId>
    <version>${clickhouse-native-jdbc.version}</version>
</dependency>

<!-- normal version -->
<dependency>
    <groupId>com.github.housepower</groupId>
    <artifactId>clickhouse-native-jdbc</artifactId>
    <version>${clickhouse-native-jdbc.version}</version>
</dependency>

Integration with Spark

Requirements

  • Java 8, Scala 2.11/2.12, Spark 2.4.x
  • Or Java 8/11, Scala 2.12, Spark 3.0.x

Notes: Spark 2.3.x(EOL) should also work fine. Actually we do test on both Java 8 and Java 11, but Spark official support on Java 11 since 3.0.0.

Import

  • Gradle
// available since 2.4.0
compile "com.github.housepower:clickhouse-integration-spark_2.11:${clickhouse_native_jdbc_version}"
  • Maven
<!-- available since 2.4.0 -->
<dependency>
    <groupId>com.github.housepower</groupId>
    <artifactId>clickhouse-integration-spark_2.11</artifactId>
    <version>${clickhouse-native-jdbc.version}</version>
</dependency>

License

This project is distributed under the terms of the Apache License (Version 2.0). See LICENSE for details.

com.github.housepower

housepower

Power your ClickHouse

Versions

Version
2.4.4
2.4.3
2.4.2
2.4.1
2.4.0
2.3-stable