CHANGES.txt

This page is an archive of old release.
See the [releases page](https://github.com/treasure-data/td-client-java/releases) for the latest release notes.

Release 1.0.0 - 2023-01-24
 - Upgrade to Guava 31.1
 - Breaking: Use Java Optional instead of Guava Optional

Release 0.9.7 - 2023-01-19
 - Support showDatabase API

Release 0.9.6 - 2021-08-19
 - Use jittering by default for http request retires
 - Handle timeout exception after getting JSON responses
 
Release 0.9.5 - 2021-02-18
 - Fixes the schema update to properly use physical column names #165
 - Removed API key validation endpoint

Release 0.9.4 - 2020-10-20
 - Fix Jackson vulnerabilities (#141)
 - Add retry pattern for StreamResetException (#160)

Release 0.9.3 - 2020-08-20
 - [Internal API Update] Support query params in PUT request [#156]

Release 0.9.2 - 2020-08-05
 - Upgrade okhttp to 3.14.7
 - Upgrade jackson-databind to 2.9.10.4
 - Merge multiple User-Agent header [#154]

Release 0.9.1 - 2020-04-01
 - Upgrade Guava to 24.1.1-jre
 - Upgrade Jackson to 2.9.10
 - Upgrade okhttp to 3.12.10
 - Miscellaneous internal fixes 

Release 0.9.0 - 2019-06-06
 - Upgrade to jackson 2.9.9

Release 0.8.13 - 2019-04-02
 - Support idempotent key in createTable (#132)

Release 0.8.12 - 2019-03-25
 - Upgrade to jackson-databind 2.8.11.3 to fix a potential security vulnerability.
 - Upgrade to okhttp 3.12.0
 - Add support to API key validation endpoint [#130]
 - [internal] Upgrade the checkstyle plugin version 

Release 0.8.11 - 2019-02-26
 - Support engine_version parameter

Release 0.8.10 - 2019-01-23
 - Fix `listJobs` method with `from_to` method [#123]

Release 0.8.9 - 2018-12-17
 - Support msgpack.gz file import api
 - Support msgpack.gz bytes stream import api

Release 0.8.8 - 2018-11-19
 - Return optional values for table distribution
 - Suppress redundant warning messages

Release 0.8.7 - 2018-10-30
 - Support table distribution API

Release 0.8.6 - 2018-08-29
 - Support `numRecords` attribute for `TDJob`. [#113]
 - Support new parameters for `TDExportResultJobRequest`. [#114]

Release 0.8.5 - 2018-08-15
 - Support result_export jobs. [#107]

Release 0.8.4 - 2018-04-24
 - Suppress stack trace upon 409 conflict 

Release 0.8.3 - 2018-03-29
 - Add resource pool name in performing bulk import

Release 0.8.2 - 2018-03-01
 - Internal constructor method change. No need to upgrade if you are using 0.8.1.

Release 0.8.1 - 2017-12-22
 - updateTableSchema accept optional parameter ignoreDuplicate which ignores duplicated columns

Release 0.8.0 - 2017-11-02
 - [NOTICE] From this version, td-client-java requires Java 8
 - Using OkHttp as an internal http client instead of jetty-client 9.2.x. This reduces the number of dependencies.
 - Added TDHttpResponseHandler to customize request/response handling
 - Deprecated some config parameters (requestTimeout, idleTimeout, response/requestBufferSize, maxContentLength), and add readTimeout.

Release 0.7.41 - 2017-08-04
  - Change TDClient#appendTableSchema to not send column alias for append-schema API [#97](https://github.com/treasure-data/td-client-java/pull/97)

Release 0.7.40 - 2017-08-01
  - Upgrade `jetty-client` to 9.2.22.v20170606

Release 0.7.39 - 2017-07-27
  - Catch and retry for most SocketException while requesting to TD API.

Release 0.7.38 - 2017-06-28
  - Add TDClient#appendTableSchema and TDClient#changeTableSchema

Release 0.7.37 - 2017-06-23
  - Add TDClient#showTable to get a table information

Release 0.7.36 - 2017-05-08
  - Fix TDExportFileFormatType.JSON_LINE_GZ.

Release 0.7.35 - 2017-04-04
  - Support pool_name parameter at Presto query

Release 0.7.34 - 2017-03-10
  - Add result_connection_id and result_connection_settings parameters to Presto and Hive jobs.
  - Add lookupConnection method to the API.

Release 0.7.33 - 2017-02-26
  - Support various jackson mapping type

Release 0.7.32 - 2017-01-18
  - Add `id` field to `TDSavedQuery`.

Release 0.7.31 - 2017-01-10
  - Allow configuring http request body max-content-length

Release 0.7.30 - 2016-12-07
  - Add method to start saved queries by id.
  - Fix legacy apikey format support.
  - Respect `Retry-After` response headers.

Release 0.7.29 - 2016-10-30
  - Add request timeout configuration.

Release 0.7.28 - 2016-09-12
  - Method visibility fixes.

Release 0.7.27 - 2016-09-09
  - Make request and response buffer sizes configurable.
  - Make request headers configurable.
  - Name http client threads.

Release 0.7.26 - 2016-08-19
  - Add domain key support to partial delete jobs.

Release 0.7.25 - 2016-08-08
  - Add domain key support for export jobs and saved queries
  - Load endpoint, port and usessl from td.conf
  - Allow setting arbitrary `Authorization` HTTP header.
  - Customizable HTTP request success classification.

Release 0.7.24 - 2016-07-27
  - Handle SSLException and retry if it is uncategorized or protocol error
  - Add type property to TDJob model class
  - Upgrade msgpack-core to 0.8.8

Release 0.7.23 - 2016-07-19
  - Fix TDClientBuilder setter return types
  - Upgrade jackson to 2.6.7
  - Add method to get job status by domain key

Release 0.7.22 - 2016-06-22
  - Fix API access retry on TimeoutException

Release 0.7.21 - 2016-06-20
  - Add pig job support

Release 0.7.20 - 2016-06-17
  - Add method to get current user
  - Add method to list users in current account
  - Add domain key to data connection sessions

Release 0.7.19 - 2016-05-27
  - Add request retry on EOFException (connection interruption)

Release 0.7.18 - 2016-05-26
  - Add method to fetch saved/scheduled query job history.
  - Add support for domain keys in job submission. Domain keys can be used to implement idempotent job submission and retries.
  - Fix HTTP request path segment escaping.

Release 0.7.17 - 2016-05-19
  - Fix starting a Data Connector Bulk Load Session Job with a specified scheduled time

Release 0.7.16 - 2016-05-19
  - Add methods for starting a Data Connector Bulk Load Session Job

Release 0.7.15 - 2016-05-13
  - [minor] Fix TDColumn JSON format

Release 0.7.14 - 2016-05-12
  - [minor] Fix TDColumn JSON serde

Release 0.7.13 - 2016-05-10
  - Added saved query API
    - [Usage examples](https://github.com/treasure-data/td-client-java/blob/2f6467242a92316b953ea37a594bbd4993adc044/src/test/java/com/treasuredata/client/Example.java#L110)
  - Upgrade jackson to 2.6.2
  - (alpha) Allow setting a scheduled time in job submission.

Release 0.7.12 - 2016-03-20
  - [minor] Add TDClientConfig.Type enum to list the available config parameters

Release 0.7.11 - 2016-03-29
  - Suppress warning logs for 40x HTTP status responces

Release 0.7.10 - 2016-03-10
  - Fix td-client version message

Release 0.7.9 - 2016-03-03
  - Add startSavedQuery API
  - Fix version name log

Release 0.7.8 - 2016-03-01
  - Add updateSchema API
  - Reduced info logs
  - Enable setting priority to performBulkImportSession

Release 0.7.7 - 2016-02-26
  - Add table export job support

Release 0.7.6 - 2016-02-18
  - Changed TDClientBuilder to be a public class

Release 0.7.5 - 2016-02-16
  - Add support for bulkload jobs

Release 0.7.4 - 2016-02-03
  - TDColumn data becomes serializable

Release 0.7.3 - 2016-01-20
  - Minor modifications to the internal code
  - Removed the dependency to org.msgpack:msgpack-core

Release 0.5.10 - 2015-12-25
  - Hotfix release for 0.5.x
  - Fix POST request to support large query string [#22](https://github.com/treasure-data/td-client-java/pull/22)

Release 0.7.2 - 2015-12-07
  - Provide td-client-java-(version)-jar-with-dependencies.jar as a standalone jar
  - Remove logback jar from the dependencies

Release 0.7.1 - 2015-12-07
  - Changed not to set the retry_limit value in TDJobRequest by default

Release 0.7.0 - 2015-11-30
  - Introduced TDClient.newBuilder() for the ease of configuration.
  - Add TDClient.newClient() method
  - Configuration precedence change: Properties > $HOME/.td/td.conf > System Properties > Environment Variable (only for TD_API_KEY)

Release 0.6.2 - 2015-11-26
  - Fix TDJob result schema retrieval

Release 0.6.1, 0.5.9 - 2015-11-25
  - Add pool_name parameter to TDJobRequest

Release 0.6.0 - 2015/09/29
  This is a major upgrade from 0.5.0 to simplify the td-client APIs.
  You can still use the previous version (0.5.x, released under `com.treasuredata` group) and
  this version (0.6.0, released as `com.treasuredata.client` group) within the same code. For
  the complete migration, rewriting your application code is necessary. For general usage of
  the new version, please look at the examples in README file.
  Changes in 0.6.0 includes
   - Use of https connections by default
   - Configuration parameter name changes (See README.md for details)
     - Support reading configurations from $(HOME)/.td/td.conf file
   - Switched to Jetty-client based implementation
   - Added TDClientException as a base class of all exceptions thrown by TDClient
   - Reduced the number of model classes. See `com.treasuredata.client.model` package.
   - Improved the API request retry mechanism
   - Improved the test coverage
   - Dropped Java6 support. Java7 or higher is necessary.

Release 0.5.6 - 20XX/XX/XX
  IMPROVEMENTS
    Escapes ' 's (spaces) included in URL path or the parameters to '%20'
    Changes the default API endpoint: api.treasure-data.com to api.treasuredata.com

Release 0.5.5 - 2014/11/11
  IMPROVEMENTS
    Removes ca-bundle.jks.

Release 0.5.4 - 2014/10/28
  BUG FIXES
    Fixes NullPointerException. NPE occurs within submitJob method if user's query string is null (or not set).

Release 0.5.3 - 2014/10/14
  IMPROVEMENTS
    Changes BulkImportClientAdaptorImpl: fixed handling 404 and 409 errors within createSession method with NotFouneException/ConflictException. If the method receives 404 and 409, it doesn't retry.

Release 0.5.2 - 2014/09/05
  IMPROVEMENTS
    Addes model classes: AuthenticationException. If HttpClient recieves 401 from API server as HTTP response, It throws AuthenticationException, which is extended to HttpClientException.
    Adds new priority field to PerformSessionRequest model class.
    Changes DefaultClientAdaptorImpl: fixed handling 409 error within createTable method with NotFouneException. If the method receives 409, it doesn't retry.
    Changes DefaultClientAdaptorImpl: fixed handling 401 error within createTable method with AuthenticationException. If the method receives 401, it doesn't retry.
    changes DefaultClientAdaptorImpl#authenticate method. It should not retry to send request for authenticating user and the password if it failed once.

Release 0.5.1 - 2014/07/23
  IMPROVEMENTS
    changes BulkImportClient#uploadPart method. It should not retry to send same request if 422.

Release 0.5.0 - 2014/07/22
  NEW FEATURES
    Addes model classes: ConflictException and NotFoundException. If HttpClient recieves 409 from API server as HTTP response, It throws ConflictException, which is extended to HttpClientException. If 404, NotFoundException is thrown.

  IMPROVEMENTS
    Changes groupID: com.treasure_data to com.treasuredata
    Changes td-client-java's Maven repo: maven.treasure-data.com to Sonatype

Release 0.4.3 - 2014/07/01
  IMPROVEMENTS
    changes DefaultClientAdaptorImpl#authenticate method. It should not retry to send request for authenticating user and the password if it failed once.
    changes BulkImportClient#createSession method. It should not retry to send request for creating bulk_import session if the database or table doesn't exist.

Release 0.4.2 - 2014/06/03
  IMPROVEMENTS
    Uses server certificates for accessing api.treasuredata.com via HTTPS

Release 0.4.1 - 2014/05/06
  IMPROVEMENTS
    Improves BulkImportClient#showSession method. It never retries showSession operations when the bulk import session is not found '404'.

Release 0.4.0 - 2014/04/23
  IMPROVEMENTS
    Changes http connection implementation and default protocol: 'http' to 'https'.

Release 0.3.6 - 2014/03/11
  BUG FIXES
    TDClient#importData should be able to accept both of double and long types of 'elapsed_time' value in http JSON response.

Release 0.3.5 - 2014/02/14
  BUG FIXES
    Fixes bug: NPE occurs when BulkImportClient#showSession method is used for 'uploading' status sessions.

Release 0.3.4 - 2014/01/31
  NEW FEATURES
    Adds BulkImportClient#showSession(String).
    Supports Presto query type

Release 0.3.3 - 2013/12/17
  BUG FIXES
    Fixes bug: 'user' and 'password' in TreasureDataClient#authenticate() method were not URL-encoded.
    Fixes bug: 'props' field in HttpConnectionImpl class is never accessed.

Release 0.3.2 - 2013/12/06
  IMPROVEMENTS
    HttpConnectionImpl should not ignore error of MessageDigest.getInstance("SHA-1")

Release 0.3.1 - 2013/11/19
  BUG FIXES
    Fixes bug: BulkImportClient#uploadPart(..) doesn't work.

Release 0.3.0 - 2013/11/12
  IMPROVEMENTS
    Improves TreasureDataClient implementation. The methods that are declared in the class have features for retrying those requests automatically.

  BUG FIXES
    Fixes bug: TreasureDataClient#createTable(..) returns Table object.

Release 0.2.15 - 2013/10/29
  NEW FEATURES
    Adds TreasureDataClient#createItemTable(..). It allows users to create new item tables.

  IMPROVEMENTS
    Improves TreasureDataClient#submitJob, killJob, showJob, showJobStatus and getJobResult methods to retry those requests automatically.

Release 0.2.14 - 2013/10/23
  NEW FEATURES
    TableSchema model class supports float type.

Release 0.2.13 - 2013/10/15
  BUG FIXES
    Fixes bug: TreasureDataClient#addTableSchema(..) doesn't work if some schemas are appended to table of null table schema.

Release 0.2.12 - 2013/10/14
  BUG FIXES
    Fixes bug: HttpConnectionImpl#getErrorMessage() throws NPE when HttpURLConnection#getErrorStream() returns null.

Release 0.2.11 - 2013/10/11
  MAINTENANCE
    Changed Treasure Data internal authentication protocol

Release 0.2.10 - 2013/10/11
  BUG FIXES
    Fixed internal authentication protocol introduced in 0.2.9

Release 0.2.9 - 2013/10/11
  MAINTENANCE
    Added a Treasure Data internal authentication protocol

Release 0.2.8 - 2013/09/12
  NEW FEATURES
    Adds new API: showTableSchema and setTableSchema methods in TreasureDataClient class
    Adds new API: addTableSchema and removeTableSchema methods in TreasureDataClient class
    Adds new API: showJobStatus method in TreasureDataClient class

Release 0.2.7 - 2013/08/21
  NEW FEATURES
    Supports Impala query type

Release 0.2.6 - 2013/05/28
  NEW FEATURES
    Adds 'overwrite' mode to TreasureDataClient#renameTable(..)

Release 0.2.5 - 2013/05/28
  NEW FEATURES
    Adds new API: renameTable method in TreasureDataClient class
    Adds new API: new constructor in Job class: it allows users to configurate 'priority' and 'retry_limit' parameters for jobs

Release 0.2.4 - 2013/03/26
  IMPROVEMENTS
    Adds debug info. to JobSummary class

Release 0.2.3 - 2013/03/19
  IMPROVEMENTS
    Changes exception messages DefaultClientAdaptorImpl and BulkImportClientAdaptorImpl classes again

Release 0.2.2 - 2013/03/19
  IMPROVEMENTS
    Changes exception messages DefaultClientAdaptorImpl and BulkImportClientAdaptorImpl classes

Release 0.2.1 - 2013/03/18
  IMPROVEMENTS
    Adds new methods to SessionSummary class: get{Valid,Error}{Parts,Records}()
    Adds HttpConnectionImpl#getErrorMessage() for user-friendly log messages

Release 0.2.0 - 2013/02/18
  IMPROVEMENTS
    Changes JobResult and JobResult2 API
    Changes return value of TreasureDataClient#getServerStatus(..)
    Adds system properties for setting 'read timeout' to td-client
    Adds HttpClientException

Release 0.1.3 - 2013/01/15
  NEW FEATURES
    Adds new API: prepare{CSV,TSV}Part methods in BulkImportClient class
    Adds new API: supports swapTable method in TreasureDataClient class
    Adds new API: supports RetryClient, which is to retry http requests
    Adds new model JobResult2 class

  IMPROVEMENTS
    Adds {database,table} name validations to {createDatabase,createTable} methods
    Changes default format of job result: msgpack to msgpack.gz

Release 0.1.2 - 2012/07/18
  NEW FEATURES
    Adds new API: supports bulk import operation

Release 0.1.1 - 2012/07/09
  NEW FEATURES
    Adds new API: deletePartialTable method in TreasureDataClient class

  BUG FIXMES
    Fixes bug: cannot submit query strings with Job API

Release 0.1.0 - 2012/05/01