{"id":13695661,"url":"https://github.com/housepower/ClickHouse-Native-JDBC","last_synced_at":"2025-05-03T13:32:47.091Z","repository":{"id":32659788,"uuid":"133296782","full_name":"housepower/ClickHouse-Native-JDBC","owner":"housepower","description":"ClickHouse Native Protocol JDBC implementation","archived":false,"fork":false,"pushed_at":"2023-10-10T01:31:50.000Z","size":2161,"stargazers_count":527,"open_issues_count":33,"forks_count":145,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-11-03T17:34:03.180Z","etag":null,"topics":["analytics","clickhouse","clickhouse-client","database","jdbc","spark","tcp-protocol"],"latest_commit_sha":null,"homepage":"https://housepower.github.io/ClickHouse-Native-JDBC/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/housepower.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-05-14T02:51:07.000Z","updated_at":"2024-11-01T17:27:55.000Z","dependencies_parsed_at":"2023-09-26T14:05:58.492Z","dependency_job_id":"53d2411d-a26e-4c9b-8753-6d85839addc3","html_url":"https://github.com/housepower/ClickHouse-Native-JDBC","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/housepower%2FClickHouse-Native-JDBC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/housepower%2FClickHouse-Native-JDBC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/housepower%2FClickHouse-Native-JDBC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/housepower%2FClickHouse-Native-JDBC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/housepower","download_url":"https://codeload.github.com/housepower/ClickHouse-Native-JDBC/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224364350,"owners_count":17299054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","clickhouse","clickhouse-client","database","jdbc","spark","tcp-protocol"],"created_at":"2024-08-02T18:00:31.955Z","updated_at":"2024-11-12T23:30:42.555Z","avatar_url":"https://github.com/housepower.png","language":"Java","readme":"ClickHouse Native JDBC\n===\n\n[![Build Status](https://github.com/housepower/ClickHouse-Native-JDBC/workflows/build/badge.svg?branch=master)](https://github.com/housepower/ClickHouse-Native-JDBC/actions?query=workflow%3Abuild+branch%3Amaster)\n[![codecov.io](https://codecov.io/github/housepower/ClickHouse-Native-JDBC/coverage.svg?branch=master)](https://codecov.io/github/housepower/ClickHouse-Native-JDBC?branch=master)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.housepower/clickhouse-native-jdbc-parent/badge.svg)](https://search.maven.org/search?q=com.github.housepower)\n[![Total alerts](https://img.shields.io/lgtm/alerts/g/housepower/ClickHouse-Native-JDBC.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/housepower/ClickHouse-Native-JDBC/alerts/)\n[![Language grade: Java](https://img.shields.io/lgtm/grade/java/g/housepower/ClickHouse-Native-JDBC.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/housepower/ClickHouse-Native-JDBC/context:java)\n[![License](https://img.shields.io/github/license/housepower/ClickHouse-Native-JDBC)](https://github.com/housepower/ClickHouse-Native-JDBC/blob/master/LICENSE)\n\nEnglish | [简体中文](README_zh.md)\n\n## [Home Page](https://housepower.github.io/ClickHouse-Native-JDBC/) | [GitHub](https://github.com/housepower/ClickHouse-Native-JDBC) | [Gitee](https://gitee.com/housepower/ClickHouse-Native-JDBC)\n\nA Native JDBC library for accessing [ClickHouse](https://clickhouse.yandex/) in Java, also provide a library for \nintegrating with [Apache Spark](https://github.com/apache/spark/).\n\n## CONTRIBUTE\n\nWe 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](CONTRIBUTE.md).\n\nSupported by [JetBrains Open Source License](https://www.jetbrains.com/?from=ClickHouse-Native-JDBC) 2020-2021. \n\n## JDBC Driver\n\n### Requirements\n\n- Java 8/11. \n\n**Notes:** We only do test with Java LTS versions.\n\n### Differences from [yandex/clickhouse-jdbc](https://github.com/yandex/clickhouse-jdbc)\n\n* Data is organized and compressed by columns.\n* Implemented in the TCP Protocol, with higher performance than HTTP, here is the [benchmark report](docs/dev/benchmark.md).\n\n### Limitations\n\n* Not support insert complex values expression, like `INSERT INTO test_table VALUES(toDate(123456))`, but query is ok.\n* Not support insert non-values format, like `TSV`.\n* Not support more compression method, like `ZSTD`.\n\n### Import\n\n- Gradle\n```groovy\n// (recommended) shaded version, available since 2.3-stable\ncompile \"com.github.housepower:clickhouse-native-jdbc-shaded:${clickhouse_native_jdbc_version}\"\n\n// normal version\ncompile \"com.github.housepower:clickhouse-native-jdbc:${clickhouse_native_jdbc_version}\"\n```\n\n- Maven\n\n```xml\n\u003c!-- (recommended) shaded version, available since 2.3-stable --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.housepower\u003c/groupId\u003e\n    \u003cartifactId\u003eclickhouse-native-jdbc-shaded\u003c/artifactId\u003e\n    \u003cversion\u003e${clickhouse-native-jdbc.version}\u003c/version\u003e\n\u003c/dependency\u003e\n\n\u003c!-- normal version --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.housepower\u003c/groupId\u003e\n    \u003cartifactId\u003eclickhouse-native-jdbc\u003c/artifactId\u003e\n    \u003cversion\u003e${clickhouse-native-jdbc.version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Integration with Spark\n\n### Requirements\n\n- Java 8, Scala 2.11/2.12, Spark 2.4\n- Or Java 8/11, Scala 2.12, Spark 3.0/3.1\n\nFor Spark 3.2, [Spark ClickHouse Connector](https://github.com/housepower/spark-clickhouse-connector) is recommended.\n\n**Notes:** Spark 2.3.x(EOL) should also work fine. Actually we do test on both Java 8 and Java 11, \nbut Spark official support on Java 11 since 3.0.0.\n\n### Import\n\n- Gradle\n\n```groovy\n// available since 2.4.0\ncompile \"com.github.housepower:clickhouse-integration-spark_2.11:${clickhouse_native_jdbc_version}\"\n```\n\n- Maven\n\n```xml\n\u003c!-- available since 2.4.0 --\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.housepower\u003c/groupId\u003e\n    \u003cartifactId\u003eclickhouse-integration-spark_2.11\u003c/artifactId\u003e\n    \u003cversion\u003e${clickhouse-native-jdbc.version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## License\n\nThis project is distributed under the terms of the Apache License (Version 2.0). See [LICENSE](LICENSE) for details.\n","funding_links":[],"categories":["Language bindings"],"sub_categories":["Java"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhousepower%2FClickHouse-Native-JDBC","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhousepower%2FClickHouse-Native-JDBC","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhousepower%2FClickHouse-Native-JDBC/lists"}