Skip to main content

Retiring version Async 2.x of the Azure Cosmos DB Java SDK on 31 August 2024

Published date: August 25, 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 service features, we’ll retire Async 2.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 Async 2.x Azure Cosmos DB Java SDK and Azure Cosmos DB Java SDK 4.x:

Async 2.x Java SDK

Java SDK 4.x

  • Async database requests only
  • Bundles sync & async functionality
  • 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 Async 2.x version of the Azure Cosmos DB Java SDK will continue to be served by the Azure Cosmos DB service. No further updates will be made for Async 2.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