Brand

DataStax C/C++ Driver

Attention: Viewing documentation for version
Download

2.3.0

March 14, 2016

Features

  • Added support for materialized view schema metadata.
  • Added support for secondary index schema metadata.
  • Added cluster key order to table schema metadata via cass_table_meta_clustering_key_order().
  • Added frozen flag to CassDataType via cass_data_type_is_frozen().
  • Added support getting the connected cluster’’s Cassandra version via cass_schema_meta_version().
  • Added blacklist, whitelist DC, and blacklist DC load balancing policies. Thanks to Walid Aitamer (waitamer).

Other

  • Fixed the control connection to only become “ready” during the initial connection process.
  • Fixed assertion in data type comparison for collection/tuple types.
  • Fixed reference count issue in cass_collection_new_from_data_type()
  • Fixed retry consistency levels for batches. Batches now correctly use the downgraded consistency levels supplied from retry policies.
  • Fixed function name typo: cass_data_sub_type_count() to cass_data_type_sub_type_count(). The old spelling is still present, but deprecated.
  • Fixed cass::VersionNumber to handle tick-tock release version where only “major.minor” are provided.
  • Fixed function cass_session_connect_keyspace() to correctly return an error when the keyspace is invalid.
  • Fixed invalid logic in schema metadata swap method which could cause unecessary copy-on-writes.
  • Fixed bottleneck in cass::Session by using copy-on-write instead of a highly contended lock to track the current keyspace.
  • Changed “major/minor” to “major_version/minor_version” in cass::VersionNumber to avoid naming conflicts on some platforms.

2.2.2

December 14, 2015

Features

  • Added basic support for Cassandra 3.0. The driver supports Cassandra 3.0 schema metadata for keyspaces, tables, columns, user types, functions, and aggregates.

Other

  • Changed the default consistency from CASS_CONSISTENCY_LOCAL_QUORUM to CASS_CONSISTENCY_LOCAL_ONE

2.2.1

November 19, 2015

Other

  • Fixed issue where cass_data_type_sub_data_type() was always referencing a NULL pointer
  • Fixed cass::Atomic (intrinsic) for 32-bit MSVC

2.2.0

October 29, 2015

Features

  • Refactored the schema metadata API (CassSchema) to use concrete types (CassKeyspaceMeta, CassTableMeta, etc.) instead of the single CassSchemaMeta type.
  • Added support for UDF/UDA schema metadata
  • Added support for whitelist filtering i.e. whitelist load balancing policy

Other

  • Fixed Address::compare() issue that cause invalid comparisons for IPv4
  • Fixed issue that caused StreamManager to generate invalid stream IDs in Windows release builds.
  • Fixed issue where cass_cluster_set_protocol_version() would return an error for protocol versions higher than v3
  • Changed the default consistency from CASS_CONSISTENCY_ONE to CASS_CONSISTENCY_LOCAL_QUORUM
  • When using prepared statements with protocol v4 (and higher) the driver will use partition key metadata returned in the prepared response instead of using schema metadata.
  • Improved the performance of UUID to string and UUID from string conversions

2.2.0-beta1

September 21, 2015

Features

  • Added support for Cassandra 2.2 data types tinyint and smallint (cass_int8_t and cass_int16_t)
  • Added cass_uint32_t support for the Cassandra 2.2 date data type
  • Added functions to convert from Unix Epoch time (in seconds) to and from the Cassandra date and time types
  • Added support for sending and recieving custom payloads to and from Cassandra
  • Added support for server-side warnings
  • Added new error response functions to handle the ‘Read_failure’, ‘Write_failure’, ‘Function_failure’, and ‘Already_exists’ errors

Other

  • Fixed SSL ring buffer memory leak
  • Fixed potential memory issue caused by using named parameters
  • Fixed hanging issue when calling cass_session_get_metrics()
  • Fixed hanging issue caused by cass::MPMCQueue memory race
  • Fixed invalid state assertion in cass::Handler
  • Fixed UDTs with text fields
  • A value of null is no longer implictly used for unbound statement parameters. An error is returned (CASS_ERROR_LIB_PARAMETER_UNSET) for Cassandra 2.1 and earlier or the UNSET value is used for Cassandra 2.2 and later

2.1.0

August 11, 2015

Features

  • Added support for retry policies
  • Added support for client-side timestamps
  • Exposed raw paging state token via cass_result_paging_state_token() and it can be added to a statement using cass_statement_set_paging_state_token()
  • Added support for enabling/disabling schema metadata using cass_cluster_set_use_schema()

Other

  • Connections that timeout will not disconnect an entire conneciton pool
  • TCP_NODELAY is enabled by default
  • Connections now support using 32,767 stream IDs when using the CQL Native Protocol v3
  • cass_uuid_min_from_time() and cass_uuid_max_from_time() now correctly considers the time parameter as epoch time

2.1.0-beta

July 7, 2015

Features

  • Added support for tuples and UDTs
  • Added support for nested collections
  • Added support for named parameters when using simple queries (non-prepared)
  • Added support for protocol version 3 (and schema changes)

Other

  • Fixed SSL error handling
  • Added libuv read buffer caching in cass::Connection

2.0.1

May 15, 2015

Other

  • Removed logging thread. cass_log_cleanup() and cass_log_set_queue_size() are now deprecated. A logging callback registered with cass_log_set_callback() will now be called on mulitple threads concurrently.
  • Fixed an issue where the driver might crash/hang when system.local contains no entries
  • Fixed an issue where the driver might hang under high-load due to missing memory fence before uv_async_send() in cass::AsyncQueue::enqueue()

2.0.0

April 23, 2015

Features

  • Added latency-aware load balancing. To enable use: cass_cluster_set_latency_aware_routing()
  • Added performance metrics. To get metrics use: cass_session_get_metrics()
  • Added CassInet string conversion functions: cass_inet_string() and cass_inet_to_string()

Other

  • Removed internal dependency on Boost. Optional: Boost Atomic can still be used as an implementation for internal atomic operations and memory fences.
  • Removed wrapper types CassString, CassBytes and CassDecimal
  • Added string length functions (functions with the suffix “_n”) for all functions that previously took a null-terminated or CassString parameter.
  • Added missing cass_statement_bind_null_by_name() function
  • Fixed issue where time-based UUIDs (CassUuid v4) had the incorrect time on 32-bit systems

1.0.1

Mar 2, 2015

Other

  • Added testing documentation
  • Added docmentation for the varint data type
  • Added a contributing document
  • Added version defines to cassandra.h
  • Fixed an issue where connections were attempted against decommissioned nodes
  • Fixed an issue where an invalid key index was used for a single entry token-aware routing key
  • Improved build error output when an incompatabile version of Boost is used to build the driver

1.0.0

Feb 2, 2015

Features

  • Libuv 1.x supported

Other

  • cass_cluster_set_num_threads_io() now returns an error code
  • Fixed an issue where a node in a remote DC could reconnect even if it was supposed to be ignored.
  • Reduced the defaults for IO worker threads (1), core connections (1), and max connections (2).
  • Fixed crash caused by a null token-aware key value.

1.0.0-rc1

Dec 22, 2014

Features

  • Added global logging. Logging is no longer configured per session.
  • DC-aware load balancing policy is now the default and uses the DC of the first connected contact point. The DC-aware policy now has settings to control the number of remote hosts used in each DC (after exhausting the hosts in the local DC) and whether to ignore local consistency levels.
  • Added socket options for TCP nodelay and keepalive: cass_cluster_set_tcp_nodelay() and cass_cluster_set_tcp_keepalive().

Other

  • CassSession objects must now be explictly allocated/freed using cass_session_new() and cass_session_free(). cass_cluster_connect() has been removed and replaced by cass_session_connect().
  • SIGPIPE is ignored on driver threads
  • Connection timeout now covers the entire connection handshake instead of just the socket connection.
  • UUID API has been updated to use explict state via CassUuidGen instead of using internal global state. See cass_uuid_gen_new() and corresponding functions.

1.0.0-beta5

Nov 20, 2014

Features

  • Added SSL support
  • Added token-aware load balancing. It’s enable by default. It can be disable using cass_cluster_set_token_aware_routing().
  • Added functions to get schema metadata, cass_session_get_schema() can be use to get a snapshot of the schema metadata and cass_meta_*() functions can be used to retrieve detailed information about keyspaces, tables, and columns.

Other

  • Significantly improved request throughput by batching socket writes. Batch sizes can be configured using the function cass_cluster_set_max_requests_per_flush(). The default is 128 because the maximum write size is bounded by the number of pipelined requests per connection (for version 1 and 2 of the native protocol).
  • Added backpressure mechanism that can be configured for by the number of outstanding bytes and the number of requests on a connection. These can be configured using cass_cluster_set_write_bytes_high_water_mark(), cass_cluster_set_write_bytes_low_water_mark(), cass_cluster_set_pending_requests_high_water_mark(), and cass_cluster_set_pending_requests_low_water_mark().
  • Fixed a crash caused by a request timing out followed by a call to the conneciton read callback then the write callback.
  • Fixed an issue that prevented the driver from recovering from a full cluster outage.
  • Fixed an issue that allowed uv_queue_work() to be called from an application thread.
  • Added logic to prevent redundant node refreshes when estabilishing a new connection from multiple IO workers.
  • Fixed a crash caused by Cassandra 2.1.0 not returning metadata on execute requests.
  • Fixed a memory leak that could leak request handlers if the control connection ran out of stream ids.
  • Fixed a crash caused by calling an invalid timeout callback when waiting for connection to become available in a pool.
  • Build will use an external version of Boost if present.

1.0.0-beta4

Sep 11, 2014

Features

  • Added node discovery and now handle topology/status change events
  • Queries that modify schema wait for cluster schema agreement
  • Added DC aware load balancing policy. The default policy is set to round robin.
  • Added new methods to configure the load balancing policy, cass_cluster_set_load_balance_round_robin() and cass_cluster_set_load_balance_dc_aware()
  • It is now possible for a session future to return an error when connecting to a cluster. This can occur when the driver is unable to connect to any contact points or the provided authentication credentials are invalid.

1.0.0-beta3

Aug 13, 2014

Features

  • Added callbacks to futures, cass_future_set_callback()
  • Added plaintext authentication support, cass_cluster_set_credentials()
  • Added map iterator, cass_iterator_from_map(), key and value pairs can be retreived using cass_iterator_get_map_key() and cass_iterator_get_map_value()
  • Values can be bound by name (statements created from prepared statments only)
  • Values can be retreived by name from result sets

Other

  • Reduced overhead of prepared statements
  • Small performance improvement for all queries via reduced allocations

1.0.0-beta2

Jul 17, 2014

Features

  • Removed C++1x dependency
  • Support for Cassandra 1.2 (native protocol version 1)
  • Support for automatic paging
  • Added method to set serial consistency on statement
  • Added batch type to batches
  • Exposed options cass_cluster_set_max_pending_requests(), cass_cluster_set_max_simultaneous_creation(), and cass_cluster_set_max_simultaneous_requests_threshold()
  • Added cass_result_column_name() to get column name from a result set

Bug Fixes

  • Fixed StreamManager so it no longer causes stack corruption
  • Fixed issue where connections would log “’Timed out during startup’ error on startup for …” when a Session was closed while a connection was during its startup process
  • Fixed Row and collections iterator so they return the first and last item properly
  • Improved logic for creating new connections so it’s based request throughput

Other

  • Removed the setopt method added set methods for all options
  • Removed the getopt method
  • cass_batch_new() and cass_collection_new() no longer take a consistency parameter
  • cass_collection_new() now requires a colleciton type parameter
  • is_map parameter removed from cass_statement_bind_collection()

1.0.0-beta1

Jun 16, 2014

Features

  • Support for Cassandra 2.0 (native protocol version 2)
  • Support for prepared and batch statements
  • Support for collections