CosmosClient vs DocumentClient

Question

What's the difference between CosmosClient and DocumentClient, in Java. Should I prefer one over the other, and why?

Answer 1

Simply put, CosmosClient is part of new SDK for Azure Cosmos DB SQL API while DocumentClient is part of the old SDK (when Cosmos DB SQL API was called DocumentDB).

Old SDK Github Repo: https://github.com/Azure/azure-documentdb-java

New SDK Github Repo: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/cosmos/azure-cosmos

Other big difference is the the new SDK supports both async and sync whereas the older SDK only supports sync.

Considering the old SDK has not been updated in quite some time, the recommendation would be to use the newer one.