{"id":2850,"date":"2018-04-18T00:00:00","date_gmt":"2018-04-18T00:00:00","guid":{"rendered":"https:\/\/azure.microsoft.com\/blog\/spring-data-azure-cosmos-db-nosql-data-access-on-azure"},"modified":"2025-07-02T06:04:51","modified_gmt":"2025-07-02T13:04:51","slug":"spring-data-azure-cosmos-db-nosql-data-access-on-azure","status":"publish","type":"post","link":"https:\/\/azure.microsoft.com\/en-us\/blog\/spring-data-azure-cosmos-db-nosql-data-access-on-azure\/","title":{"rendered":"Spring Data Azure Cosmos DB: NoSQL data access on Azure"},"content":{"rendered":"\n

We are pleased to announce that Spring Data Azure Cosmos DB<\/a> is now available to provide essential Spring Data support for Azure Cosmos DB<\/a> using SQL API<\/a>. Azure Cosmos DB is Microsoft\u2019s globally distributed, multi-model database service with exceptional scalability and performance.<\/p>\n\n\n\n

With Spring Data Azure Cosmos DB, Java developers now can get started quickly to build NoSQL data access for their apps on Azure. It offers a Spring-based programming model for data access, while keeping the special traits of the underlying data store with Azure Cosmos DB. Features of Spring Data Azure Cosmos DB include a POJO centric model for interacting with an Azure Cosmos DB Collection, and an extensible repository style data access layer.<\/p>\n\n\n\n

Getting started<\/h2>\n\n\n\n

Download the Spring Data Azure Cosmos DB Sample Project<\/a> to get started. The sample illustrates the process to use annotation to interact with Collection, customize a query operation with specific fields, and expose a discoverable REST API for clients.<\/p>\n\n\n\n

Create a new database instance<\/h3>\n\n\n\n

To get started, first create a new database instance<\/a> by using the Azure portal. You can find Azure Cosmos DB<\/strong> in Databases and choose SQL (Document DB) <\/strong>for the API. When your database has been created, you can find the URI and keys on the overview page. The values will be used to configure your Spring Boot application.<\/p>\n\n\n

\"graphical<\/figure>\n\n\n\n

Configure your project<\/h3>\n\n\n\n

You can create a simple Spring Boot application using Spring Initializr<\/a>, and locate the pom.xml file in the directory of your app. In the pom.xml file add spring-data-cosmosdb<\/em> to list of dependencies. spring-data-cosmosdb<\/em> is published in Maven Central Repository<\/a>. Please refer to this tutorial for detailed steps of configuration for database connection<\/a>.<\/p>\n\n\n

\n\n    com.microsoft.azure<\/groupId>\n    spring-data-cosmosdb<\/artifactId>\n    2.0.3<\/version>\n<\/dependency>\n<\/pre><\/div>\n\n\n
Features of Spring Data Azure Cosmos DB<\/h2>\n\n\n\n
Using Spring Data Azure Cosmos DB<\/a>, you can get started quickly to build NoSQL data access for their apps on Azure.<\/p>\n\n\n\n
Use Annotation to interact with Collection<\/h3>\n\n\n\n
@Id annotation:<\/strong> Annotate a field in domain class with @Id, this field will be mapped to document id in Azure Cosmos DB.<\/p>\n\n\n\n
@Document annotation:<\/strong> By default, collection name will use the name of the domain class. To customize it, add annotation @Document(collection=”yourCollectionName”)<\/em>.<\/p>\n\n\n
\n@Document(collection = \"mycollection\")\npublic class User {\n    @Id\n    private String id;\n    private String email;\n    private String name;\n    private Address address;\n    private List roleList;\n   ...\n}\n<\/pre><\/div>\n\n\n
Customize query operation<\/h3>\n\n\n\n
Customized query is useful for building constraining queries over entities of the repository. You can extend the basic DocumentDbRepository<\/em> for different business logics.<\/p>\n\n\n
\npublic interface UserRepository extends DocumentDbRepository {\n\n    List findByName(String firstName);\n    List findByEmailAndAddress(String email, Address address);\n    ...\n}\n<\/pre><\/div>\n\n\n
Exposes a discoverable REST API<\/h3>\n\n\n\n
@RepositoryRestResource Annotation:<\/strong> expose a discoverable REST API for your domain model.<\/p>\n\n\n
\n@Repository\n@RepositoryRestResource(collectionResourceRel = \"user\", path = \"user\")\npublic interface UserRepository extends DocumentDbRepository {\n\n    List findByName(String firstName);\n    ...\n\n}\n<\/pre><\/div>\n\n\n
For more advanced features, please visit our GitHub Repo<\/a>.<\/p>\n\n\n\n
Next steps<\/h2>\n\n\n\n
For more information about using Spring on Azure, visit the following pages:<\/p>\n\n\n\n