Skip to content

Commit eb3ad1d

Browse files
Merge pull request #277363 from seesharprun/patch-8
Cosmos DB | Update NoSQL Couchbase migration guide
2 parents 7d387c0 + e8ec679 commit eb3ad1d

File tree

1 file changed

+7
-9
lines changed

1 file changed

+7
-9
lines changed

articles/cosmos-db/nosql/couchbase-cosmos-migration.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.custom: devx-track-java, devx-track-extended-java
1313
# Migrate from CouchBase to Azure Cosmos DB for NoSQL
1414
[!INCLUDE[NoSQL](../includes/appliesto-nosql.md)]
1515

16-
Azure Cosmos DB is a scalable, globally distributed, fully managed database. It provides guaranteed low latency access to your data. To learn more about Azure Cosmos DB, see the [overview](../introduction.md) article. This article provides instructions to migrate Java applications that are connected to Couchbase to a API for NoSQL account in Azure Cosmos DB.
16+
Azure Cosmos DB is a scalable, globally distributed, fully managed database. It provides guaranteed low latency access to your data. To learn more about Azure Cosmos DB, see the [overview](../introduction.md) article. This article provides instructions to migrate Java applications that are connected to Couchbase to an API for NoSQL account in Azure Cosmos DB.
1717

1818
## Differences in nomenclature
1919

@@ -32,7 +32,7 @@ The following are the key features that work differently in Azure Cosmos DB when
3232

3333
* Azure Cosmos DB scales by using the partitioning or sharding technique. Which means it splits the data into multiple shards/partitions. These partitions/shards are created based on the partition key property that you provide. You can select the partition key to optimize read as well write operations or read/write optimized too. To learn more, see the [partitioning](../partitioning-overview.md) article.
3434

35-
* In Azure Cosmos DB, it is not required for the top-level hierarchy to denote the collection because the collection name already exists. This feature makes the JSON structure much simpler. The following is an example that shows differences in the data model between Couchbase and Azure Cosmos DB:
35+
* In Azure Cosmos DB, it isn't required for the top-level hierarchy to denote the collection because the collection name already exists. This feature makes the JSON structure simpler. The following is an example that shows differences in the data model between Couchbase and Azure Cosmos DB:
3636

3737
**Couchbase**: Document ID = "99FF4444"
3838

@@ -95,7 +95,7 @@ The following are the key features that work differently in Azure Cosmos DB when
9595

9696
## Java SDK support
9797

98-
Azure Cosmos DB has following SDKs to support different Java frameworks:
98+
Azure Cosmos DB has following software development kits (SDKs) to support different Java frameworks:
9999

100100
* Async SDK
101101
* Spring Boot SDK
@@ -104,7 +104,7 @@ The following sections describe when to use each of these SDKs. Consider an exam
104104

105105
## Couchbase as document repository & spring data-based custom queries
106106

107-
If the workload that you are migrating is based on Spring Boot Based SDK, then you can use the following steps:
107+
If the workload that you're migrating is based on Spring Boot Based SDK, then you can use the following steps:
108108

109109
1. Add parent to the POM.xml file:
110110

@@ -170,7 +170,7 @@ Consider the following code snippet, where doc object will have ID and partition
170170

171171
### Read Operation
172172

173-
You can read the document with or without specifying the partition key. If you don’t specify the partition key, then it is treated as a cross-partition query. Consider the following code samples, first one will perform operation using ID and partition key field. Second example uses a regular field & without specifying the partition key field.
173+
You can read the document with or without specifying the partition key. If you don’t specify the partition key, then it's treated as a cross-partition query. Consider the following code samples, first one will perform operation using ID and partition key field. Second example uses a regular field & without specifying the partition key field.
174174

175175
* ```_repo.findByIdAndName(objDoc.getId(),objDoc.getName());```
176176
* ```_repo.findAllByStatus(objDoc.getStatus());```
@@ -192,7 +192,7 @@ You can notice the following changes in your N1QL queries:
192192
* Instead of "ANY" now you can do a join on subdocument and refer it with a dedicated alias such as "m". Once you have created alias for a subdocument you need to use alias. For example, m.Country.
193193

194194
* The sequence of OFFSET is different in Azure Cosmos DB query, first you need to specify OFFSET then LIMIT.
195-
It is recommended not to use Spring Data SDK if you are using maximum custom defined queries as it can have unnecessary overhead at the client side while passing the query to Azure Cosmos DB. Instead we have a direct Async Java SDK, which can be utilized much efficiently in this case.
195+
It is recommended not to use Spring Data SDK if you're using maximum custom defined queries as it can have unnecessary overhead at the client side while passing the query to Azure Cosmos DB. Instead we have a direct Async Java SDK, which can be utilized much efficiently in this case.
196196

197197
### Read operation
198198

@@ -426,9 +426,7 @@ Then subscribe to mono, refer mono subscription snippet in insert operation. The
426426

427427
## Data Migration
428428

429-
There are two ways to migrate data.
430-
431-
* **Use Azure Data Factory:** This is the most recommended method to migrate the data. Configure the source as Couchbase and sink as Azure Cosmos DB for NoSQL, see the Azure [Azure Cosmos DB Data Factory connector](../../data-factory/connector-azure-cosmos-db.md) article for detailed steps.
429+
Use **Azure Data Factory** to migrate data. This is the most recommended method to migrate the data. Configure the source as Couchbase and sink as Azure Cosmos DB for NoSQL, see the Azure [Azure Cosmos DB Data Factory connector](../../data-factory/connector-azure-cosmos-db.md) article for detailed steps.
432430

433431
## Next Steps
434432

0 commit comments

Comments
 (0)