﻿==============================================================================
Simba Cassandra JDBC Data Connector Release Notes 
==============================================================================

The release notes provide details of enhancements, features, known issues, and
workflow changes in Simba Cassandra JDBC Connector 2.1.5, as well as the 
version history. 


2.1.5 ========================================================================

Released 2024-05-13

Enhancements & New Features 

 * Updated third-party library

   The connector now uses Snappy-java 1.1.10.5. Previously, the connector used
   version 1.1.2.6.

 * Internal connector improvements

   The connector has been updated with minor internal improvements.


Known Issues 
The following are known issues that you may encounter due to limitations in 
the data source, the connector, or an application. 

 * [CASSJ-192] In some cases, when working with INET data inside UDT or TUPLE
   data, the connector cannot read or insert empty values as empty values.
   
   When this issue occurs, the connector inserts 127.0.0.1 instead of an empty 
   value, and reads empty values as NULL. This behavior is known to occur in 
   the following cases:
   
   - When working with INET columns that are part of UDT or TUPLE values.
   - When working with UDT types that contain INET types, and the 
     FlattenUDTColumn property is set to 0.
 
   If the FlattenUDTColumn property is set to 1, then the connector reads 
   empty values as empty values when working with UDT types that contain INET
   types. However, it still inserts NULL instead of an empty value.

 * [CASSJ-183] When you insert a DECIMAL value, if the scale of the value is 
   greater than the DecimalColumnScale setting, the connector truncates the 
   inserted value without returning any messages about the truncation.
   
   To prevent the connector from truncating DECIMAL values unexpectedly, set 
   the DecimalColumnScale connection property to an appropriate scale.

 * [CASSJ-211] Collections cannot contain nested collections (LIST/MAP/SET) 
   when read as a part of the virtual table.

 * TUPLE data cannot contain collections (LIST/MAP/SET), UDT, or TUPLE types 
   when inserted as data of type VARCHAR.

 * User-defined types (UDT) cannot contain collections (LIST/MAP/SET), UDT, 
   or TUPLE types when inserted as a data of type VARCHAR.

 * The following SQL features are not supported:
   - Sorting or filtering on binary data
   - Arithmetic operations on TIME data
   - Comments in queries

 * The following JDBC features are not supported:
   - Transactions
   - Batch operations

 * CUSTOM data is not supported.
 
 * TUPLE data cannot be expanded into virtual tables.

   The connector reads and writes the raw data as STRING data, and does not 
   retain the underlying subtype data types. 
	
 * Non-key virtual table columns are not nullable.
 
   Cassandra does not support null values in collections. The connector 
   reports non-key columns in virtual tables as not nullable.

   
Workflow Changes =============================================================

The following changes may disrupt workflows from earlier versions.

2.0.16 -----------------------------------------------------------------------

 * [CASSJ-427] Removed support for Java 7.0

   Beginning with this release, the connector no longer supports Java 7.0. For 
   a list of supported JDBC versions, see the Installation and Configuration 
   Guide.


2.0.6 ------------------------------------------------------------------------

 * [CASSJ-267] Removed support for JDBC 4.0 (Java 6)

   Beginning with this release, the connector no longer supports JDBC 4.0 
   (Java 6). For a list of supported JDBC versions, see the Installation and 
   Configuration Guide.
   
   
2.0.2 ------------------------------------------------------------------------

 * Cassandra version support
 
   Beginning with this release, the connector no longer supports connections to
   servers that run Cassandra version 2.0 or earlier. For a list of supported
   Cassandra versions, see the Installation and Configuration Guide. 


Version History ==============================================================

2.1.4 ------------------------------------------------------------------------

Released 2024-01-08

Enhancements & New Features 

 * Updated third-party libraries

   The connector now uses the following third-party libraries:
   - Jackson 2.16.0 (previously 2.15.3)
   - Netty 4.1.104.Final (previously 4.1.100.Final)


2.1.3 ------------------------------------------------------------------------

Released 2023-10-26

Enhancements & New Features 

 * Updated third-party libraries

   The connector now uses the following third-party libraries:
   - Jackson 2.15.3 (previously 2.15.2)
   - Netty 4.1.100.Final (previously 4.1.97.Final)


2.1.2 ------------------------------------------------------------------------

Released 2023-09-25

Enhancements & New Features 

 * Updated third-party library

   The connector now uses Netty version 4.1.97.Final. Previously, the 
   connector used 4.1.94.Final.


2.1.1 ------------------------------------------------------------------------

Released 2023-07-07

Enhancements & New Features

 * [CASSJ-437] Multiple host support 
   
   The connector now supports multiple hosts in the connection URL. To do 
   this, specify a comma-separated list of hostnames or IP addresses and 
   ports. The connector attempts to connect to all the servers concurrently
   and keeps the first connection that is successfully established. The 
   connector does not maintain a connection with any other servers on the
   list. For more information, see the Installation and Configuration Guide. 

 * Updated third-party libraries

   The connector now uses the following third-party libraries:
   - asm 9.5 (previously 5.0.4)
   - guava 32.0.1 (previously 30.0)
   - jackson-annotations 2.15.2 (previously 2.14.1)
   - jackson-core 2.15.2 (previously 2.14.1)
   - jackson-databind 2.15.2 (previously 2.14.1) 
   - javax.json-api 1.1.4 (previously 1.0)
   - jffi 1.3.11 (previously 1.3.0)
   - joda-time 2.12.5 (previously 2.9.9)
   - lz4 1.8.0 (previously 1.7.1)
   - netty 4.1.94.Final (previously 4.1.86.Final)


2.1.0 ------------------------------------------------------------------------

Released 2023-03-15

Enhancements & New Features

 * Updated Cassandra version support
   
   The connector now supports Apache Cassandra versions 3.0 through 4.1. For a
   list of supported Cassandra versions, see the Installation and 
   Configuration Guide.

 
============================================================================== 