Release v0.6.0

WARNING -- ClickHouse CLI Client deprecation

clickhouse-cli-client package is deprecated from version 0.6.0 and it's going to be removed in 0.7.0. We recommend using clickhouse-client instead.

WARNING -- ClickHouse GRPC Client deprecation

clickhouse-grpc-client package is deprecated from version 0.6.0 and it's going to be removed in 0.7.0. We recommend using HTTP protocol instead.

Breaking Changes

• Remove WEB_CONTEXT support - #1512

New Features

• Add support in RowBinaryWithDefaults #1508

Bug Fixes

• Fix faulty node detection in ClickHouseNodes - #1595
• Fix while getting addBatch with an exception drop the all batch #1373
• Fix buffering issue caused by decompress flag not to work #1500

Release v0.5.1-SNAPSHOT

Commits

• [048b9e4]: Fix buffering issue casue decompress not to work (mzitnik) #1500
• [8658147]: Added different content sizes testting (mzitnik) #1500
• [d6cd675]: Disable until web context ping reqests until research is done. (mzitnik) #1500
• [c66377e]: Adding extra logging (mzitnik) #1500
• [a930f62]: Disable ping tests (mzitnik) #1500

Release v0.5.0

0.5.0

Breaking Changes

• ClickHouseByteBuffer can no longer be extended
• rename ClickHouseByteUtils methods by removing LE suffix
• change default databaseTerm from schema to catalog
• remove deprecated API load, dump and connect
• remove use_no_proxy settings

New Features

• Adding new proxy support #1338
• Add support for customer socket factory #1391
• use VarHandle in JDK 9+ to read/write numbers
• Establish secured connection with custom Trust Store file
• Change default HTTP Client to Apache HTTP client #1421

Bug Fixes

• Java client threw confusing error when query is invalid.
• JDBC Driver correctly processes AggregateFunction(Nested(...)) columns
• Incorrect parameter position
• Fix testing framework to support secured clickhouse server

Release v0.4.6

This is a patch release mainly for bug fixes. It's highly recommended to upgrade, especially when you're using nested arrays, or client certificate authentication with password protection.

• 🐛 Bug Fix

  • Too many socket fds generated by Apache HttpClient - by @JackyWoo
  • NoClassDefFoundError with clickhouse-apache-http-client-jdbc - #1319 by @JackyWoo
  • Nested array in tuple array is incorrectly deserialized - #1324
  • Client certificate password exposure in exception - #1331

• ✨ New Feature

  • ClickHouseStatement.setMirroredOutput() for dumping ResultSet
  • ClickHouseResponse.records(Class<?>) for object mapping
  • Two new options(use_compilation & max_mapper_cache) reserved for future usage

Release v0.4.5

Another tiny release trying to unblock some of the work relying on Java client. You don't have to upgrade if you use JDBC or R2DBC driver.

• 💥 BREAKING CHANGES

  • Refactored data processors and response classes to ensure input stream remain intact before first read - performance penalty is ~3%
    • move ClickHouseSimpleRecord to com.clickhouse.data
    • stop reading input stream when instantiating ClickHouseDataProcessor
    • remove createRecord() method in ClickHouseDataProcessor along with some duplicated code

• 🐛 Bug Fix

  • Slow when using Apache Http Client - #1320 by @JackyWoo
  • ClickHouseResponse.getInputStream may return closed input stream
  • ConcurrentModificationException may occur during deserialization - #1327 by @pan3793
  • ClickHouseSslContextProvider is not customizable - #1329

• ✨ New Feature

  • Disabled SQL rewrite for DELETE statement in ClickHouse 23.3+

• 🎨 Misc

  • bump MySQL JDBC driver to 8.0.33 - by @pan3793

Release v0.4.4

Same as v0.4.3 except updated POM for the following changes:

• bump dependencies
• roll back Maven flatten plugin from 1.4.1 to 1.2.7

Release v0.4.3

Warning Please upgrade to v0.4.4 to resolve dependency issue.

This is a tiny release for bug fixing. Please upgrade if your work rely on text-based data format and/or R2DBC driver.

• 🐛 Bug Fix
  • unable to convert empty string to default value when using text-based data format
  • r2dbc driver does not support most client options - #1299
  • incorrect content from Lz4InputStream when using text-based data format - ClickHouse/ClickHouse#48446

Release v0.4.2

This is a minor release with bug fixes and some new features.

• 💥 BREAKING CHANGES

  • Refactored SQL parser to support keywords compression, infile, and outfile

• 🐛 Bug Fix

  • remove duplicated socket options - #1263 by @JackyWoo
  • error while converting Nested values to Java maps
  • incorrect algorithm extracted from PEM - #1274
  • transaction failure introduced in 0.4.0
  • respect node-specific credentials - #1114
  • USE statement does nothing - #1160
  • executeBatch does not support on cluster anymore - #1261

• ✨ New Feature

  • Add credentials overload for Java client - #1265 by @rickysaltzer
  • centralized configuration for JDBC driver using custom server setting custom_jdbc_config - #1290
  • support BEGIN TRANSACTION, COMMIT, and ROLLBACK statements in JDBC driver
  • new options for JDBC driver
    • databaseTerm(catalog or schema, defaults to schema) - #1273
    • externalDatabase(boolean, defaults to true) to enable/disable external database metadata - #1245
    • localFile(boolean, defaults to false) to support INFILE and OUTFILE - #1291

• 🎨 Misc

  • move docs to ClickHouse website as well as bug template and contribution guide - by @mshustov
  • improved error messages for missing dependency
  • replaced default JDBC artifact with shaded jar and more dependencies in provided scope

Release v0.4.1

This is a patch release mainly for bug fixing. It is highly recommended to upgrade if you're using v0.4.0.

• 💥 BREAKING CHANGES

  • changed option names - #1203
    • compress_alogrithm -> compress_algorithm
    • decompress_alogrithm -> decompress_algorithm

• 🐛 Bug Fix

  • incorrect nested array values - #1223
  • broken serde for Nested, which also impacted JSON - #1242
  • broken serde for bitmap64 - #1248
  • gRPC client may complete execution before closing response stream
  • throw StreamCorruptedException instead of generic IOException when deserialization failed (mostly due to server error)

• ✨ New Feature

  • added source in shaded jar for IDE friendly - #1217
  • iterable ClickHouseInputStream, which slightly improved performance of piping - #1238
  • ClickHouseOutputStream.transferBytes() is deprecated and it will be removed in 0.5
  • read() and write() methods in ClickHouseClient - connect() is deprecated and it will be removed in 0.5
  • make all dependencies of JDBC driver optional, along with configuration for building native binary - #1247

• 🎨 Misc

  • added PR template and changelog by @mshustov
  • renamed repository from clickhouse-jdbc to clickhouse-java, and branch from master to main by @mshustov
  • update outdated docs by removing yandex and correcting class names by @mzitnik and @alexey-milovidov

Release v0.4.0

Happy Spring Festival everyone! Apologize for a minor release taking so long :p

This is a feature release with new features, performance improvement, bug fixes, and unfortunately breaking changes.

• 💥 BREAKING CHANGES

  • refactored JdbcTypeMapping to make it extensible - #1075
  • removed legacy driver ru.yandex.* - #1089 by @mzitnik
  • removed most deprecated methods and class members
  • refactored data processor(for serialization and deserialization) and added new classes for unsigned types - #1124
  • refactored ClickHouseRequest/ClickHouseInputStream/ClickHouseOutputStream to better support compression - #1174 & #1189
  • extracted clickhouse-data from clickhouse-client along with new packages - #1197

    com.clickhouse.config  // generic configuration
    com.clickhouse.data    // data processing utilities
    com.clickhouse.logging // generic logging utility

  • added jdk17 in pom and changed build instructions

    mvn -Dj8 clean install # for jdk8, it was 'mvn clean install'
    mvn clean install # for jdk17, it was 'mvn -Drelease clean install'

• 🐛 Bug Fix

  • not able to cancel query when there's session_id - #1035
  • overflow error when handling BigInteger and BigDecimal in ClickHouseLongValue - #1040 by @Blackmorse
  • not handling SimpleAggregateFunction properly - #1054
  • DELETE FROM was rewritten to ALTER TABLE DELETE even when lightweight deletion was enabled - #1063
  • forced headless format for inserting - #1073
  • missing the verb "be" in error messages - #1137 by @fabiencelier
  • write time field data loss precision - #1127 by @gaaraG
  • fixed a few copy-paste error causing problem handling Geo types

• ✨ New Feature

  • added R2DBC driver - #914 by @rernas35
  • enhanced ClickHouseClient for importing and exporting compressed file - #1004
  • added new option custom_settings - #1059
  • enhanced ClickHouseRequestManager to support query/session ID customization - #1074
  • added Apache HTTP Client 5 to support socket options - #1146 by @JackyWoo
  • enhanced clickhouse-grpc-client to support request chunking and compression
    • decompress_alogrithm(request compression): BROTLI[-1,11], BZ2, DEFLATE[0,9], GZIP[-1,9], LZ4[0,18], XZ[0,9], ZSTD[0,22]
    • compress_alogrithm(response decompression): DEFLATE, LZ4, ZSTD
      Note: typo will be fixed in v0.4.1.
  • enhanced clickhouse-http-client to support zstd compression for both request and response
    • decompress_alogrithm(request compression): LZ4[0,18], ZSTD[0,22]
    • compress_alogrithm(response decompression): BROTLI, BZ2, DEFLATE, GZIP, LZ4, XZ, ZSTD
      Note: typo will be fixed in v0.4.1.
  • added stream-based prepared statement - #1163
  • browser-like client name (select distinct http_user_agent from system.query_log) - #1182
  • enhanced ClickHouseRequest by treating input stream and ClickHouseWriter equally - #1200

• 🎨 Misc

  • dropped develop branch, which accidentally removed all open pull requests 😭
  • fixed some issues captured by SonarCloud and LGTM
  • added more tests but the coverage is still very low 🤣
  • enabled nightly build in CI - check out Sonatype OSSRH

    <repositories>
        <repository>
            <id>ossrh</id>
            <name>Sonatype OSSRH</name>
            <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
        </repository>
    </repositories>