Skip to main content

Update Java SDK 3.x to Java SDK 4.x by 31 August 2024

Published date: August 17, 2021

Because Azure Cosmos DB Java SDK v4 has up to 20% enhanced throughput, TCP-based direct mode, bug fixes, and provide support for the latest backend features, we’ll retire 3.x version of the Azure Cosmos DB Java SDK for SQL API on 31 August 2024. We recommend you make the switch early to gain the enhanced benefits of Azure Cosmos DB Java SDK 4.x. Start using SDK 4.x for net-new subscriptions/accounts.

In addition to current features you already use, here’s a quick comparison between Azure Cosmos DB Java SDK 3.x and Azure Cosmos DB Java SDK 4.x:

Java SDK 3.x

Java SDK 4.x

  • HTTP-based direct mode
  • ~20% improved throughput with TCP
  • Manual throughput mode only
  • All modes including autoscale supported

 

After 31 August 2024, if you prefer not to upgrade, requests sent from 3.x SDK will continue to be served by the Azure Cosmos DB service. No further updates will be made for 3.x version of the Azure Cosmos DB Java SDK for SQL API. 

Required action

Please follow the steps to migrate your application to use the Azure Cosmos DB Java SDK version 4.
 

Help and support

If you have questions, get answers from community experts in Microsoft Q&A. If you have a support plan and you need technical help, create a support request.

  • Azure Cosmos DB
  • Retirements

Related Products