The Azure Code Samples are currently available in English

Developing a Java app using Azure Cosmos DB Async Java SDK

Azure Cosmos DB is a globally distributed multi-model database. One of the supported APIs is the SQL API, which provides a JSON document model with SQL querying and JavaScript procedural logic. This sample shows you how to use the Azure Cosmos DB with the SQL API to store and access data from a Java application.

Getting Started


  • Before you can run this sample, you must have the following prerequisites:

    • An active Azure account. If you don't have one, you can sign up for a free account. Alternatively, you can use the Azure Cosmos DB Emulator for this tutorial. As emulator https certificate is self signed, you need to import its certificate to java trusted cert store as explained here.
    • JDK 1.8+
    • Maven


  • Then, clone this repository using
git clone
  • From a command prompt or shell, run the following command to compile and resolve dependencies.
cd azure-cosmos-db-sql-api-async-java-getting-started
cd azure-cosmosdb-get-started
mvn clean package
  • From a command prompt or shell, run the following command to run the application.

About the code

The code included in this sample is intended to get you quickly started with a Java application that connects to Azure Cosmos DB with the SQL API.

More information