JDBC Driver for Azure Cosmos DB

Build 22.0.8462


General Changes

  • Added the Default column to the sys_procedureparameters table.
  • Added the IsPath column to the sys_procedureparameters table.
09/23/20228301Azure Cosmos DBAdded
  • Added the FileStream input for the CreateSchema stored procedure. It streams the contents of the created schema if no FileName is set.
08/19/20228266Azure Cosmos DBAdded
  • Added the FileData output for the CreateSchema stored procedure. It pushes the generated schema encoded in Base64 only if the FileName input is not set.
  • We now support handling the keyword "COLLATE" as standard function name as well.
  • The method GetJDBCMinorVersion() and GetJDBCMajorVersion() return 4.2 as the supported JDBC major / minor version.
07/28/20228179Azure Cosmos DBChanged
  • Changed provider name to Azure Cosmos DB.
  • Removed support for JRE 1.6. JRE 1.8 and above is now required.
  • The method DatabaseMetaData.getTypeInfo() now returns all the data types the driver supports. Previously it was returning only a portion of the data types. The returns types include: tinyint, smallint, int, bigint, float, double, numeric, decimal, bit, date, datetime, time, varchar, binary, uuid.
  • Correct the return value of method DatabaseMetaData.supportsOuterJoins(), it used to return the wrong value.
01/14/20228049Azure Cosmos DBAdded
  • Added support for the AzureAD and AzureServicePrincipal authentication methods.
12/14/20218018Azure Cosmos DBAdded
  • Added the new connection property UseRidAsPK. Since CosmosDB allows you to use both _rid and id fields as unique values for retrieving resource data, you can set this property to false to switch using the id column as primary key instead the default _rid.
12/07/20218011Azure Cosmos DBAdded
  • Added support for the 'RawValue' TypeDetectionScheme. Setting the TypeDetectionScheme to 'RawValue' will push each document as a single aggregate on a column named JsonData, along with its resource identifier on the separate Primary Key column.
  • Support for JDK 17
10/10/20217953Azure Cosmos DBAdded
  • Added support for Batch Insert, Update and Delete operations.
  • Added support to dynamically control the number of parallel batch CUD requests to prevent exceeding the limit Max Requests Units Per Second, which can be configured via the MaxWriteThroughput connection property.
  • Removed IS_READONLY, IS_KEY, NUMERIC_PRECISION, DECIMAL_DIGITS from DatabaseMetadata.GetColumns() as they are not part of the JDBC Specification. This information is still available via other metadata calls.
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
  • Added the KeySeq column to the sys_foreignkeys table.
  • Added the new sys_primarykeys system table.
  • Updated the Literal Function Names for relative date/datetime functions. Previously relative date/datetime functions resolved to a different value when used in the projection vs te predicate. Ie: SELECT LAST_MONTH() AS lm, Col FROM Table WHERE Col > LAST_MONTH(). Formerly the two LAST_MONTH() methods would resolve to different datetimes. Now they will match.
  • As a replacement for the previous behavior, the relative date/datetime functions in the criteria may have an 'L' appended to them. Ie: WHERE col > L_LAST_MONTH(). This will continue to resolve to the same values that previously were calculated in the criteria. Note that the "L_" prefix will only work in the predicate - it not available for the projection.
  • Added the TCP Logging Module for the logging information happening on the TCP wire protocol. The transport bytes that are incoming and ongoing will be logged at verbosity=5.
06/14/20217835Azure Cosmos DBAdded
  • Added the SetPartitionKeyAsPK connection property, which controls whether or not to use the collection's Partition Key field as part of a composite Primary Key for the corresponding exposed table.
  • Added support for handling client side formulas during insert / update. For example: UPDATE Table SET Col1 = Concat(Col1, " - ", Col2) WHERE Col2 LIKE 'A%'
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
  • Non-conditional updates between two columns is now available to all drivers. For example: UPDATE Table SET Col1=Col2

  • Reduced the length to 255 for varchar primary key and foreign key columns.
  • Updated implicit and metadata caching to improve performance and support for multiple connections. Old metadata caches are not compatible - you would need to generate new metadata caches if you are currently using CacheMetadata.
  • Updated index naming convention to avoid duplicates
  • Updated and standardized Getting Started connection help.
  • Added the Advanced Features section to the help of all drivers.
  • Categorized connection property listings in the help for all editions.
04/15 /20217775GeneralChanged
  • Kerberos authentication is updated to use TCP by default, but will fall back to UDP if a TCP connection cannot be established

Copyright (c) 2023 CData Software, Inc. - All rights reserved.
Build 22.0.8462