You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Review various options to migrate your data from other MongoDB sources to Azure Cosmos DB for MongoDB vCore.
3
+
titleSuffix: vCore-based Azure Cosmos DB for MongoDB
4
+
description: Review various options to migrate your data from other MongoDB sources to vCore-based Azure Cosmos DB for MongoDB.
5
5
author: sandeep-nair
6
6
ms.author: sandnair
7
7
ms.reviewer: sidandrews
8
8
ms.service: cosmos-db
9
9
ms.subservice: mongodb-vcore
10
10
ms.topic: conceptual
11
11
ms.date: 11/17/2023
12
-
# CustomerIntent: As a MongoDB user, I want to understand the various options available to migrate my data to Azure Cosmos DB for MongoDB vCore, so that I can make an informed decision about which option is best for my use case.
12
+
# CustomerIntent: As a MongoDB user, I want to understand the various options available to migrate my data to vCore-based Azure Cosmos DB for MongoDB, so that I can make an informed decision about which option is best for my use case.
13
13
---
14
14
15
-
# What are the options to migrate data from MongoDB to Azure Cosmos DB for MongoDB vCore?
15
+
# What are the options to migrate data from MongoDB to vCore-based Azure Cosmos DB for MongoDB?
16
16
17
-
This document describes the various options to lift and shift your MongoDB workloads to Azure Cosmos DB for MongoDB vCore offering.
17
+
This document describes the various options to lift and shift your MongoDB workloads to vCore-based Azure Cosmos DB for MongoDB offering.
18
+
19
+
Migrations can be done in two ways:
20
+
21
+
- Offline Migration: A snapshot based bulk copy from source to target. New data added/updated/deleted on the source after the snapshot isn't copied to the target. The application downtime required depends on the time taken for the bulk copy activity to complete.
22
+
23
+
- Online Migration: Apart from the bulk data copy activity done in the offline migration, a change stream monitors all additions/updates/deletes. After the bulk data copy is completed, the data in the change stream is copied to the target to ensure that all updates made during the migration process are also transferred to the target. The application downtime required is minimal.
18
24
19
25
## Azure Data Studio (Online)
20
26
21
-
The [The MongoDB migration extension for Azure Data Studio](/azure-data-studio/extensions/database-migration-for-mongo-extension) is the preferred tool in migrating your MongoDB workloads to the API for MongoDB vCore.
27
+
The [MongoDB migration extension for Azure Data Studio](/azure-data-studio/extensions/database-migration-for-mongo-extension) is the preferred tool in migrating your MongoDB workloads to the vCore-based Azure Cosmos DB for MongoDB.
22
28
23
29
The migration process has two phases:
24
30
@@ -38,7 +44,7 @@ Use the graphical user interface to manage the entire migration process from st
38
44
39
45
## Native MongoDB tools (Offline)
40
46
41
-
You can use the native MongoDB tools such as *mongodump/mongorestore*, *mongoexport/mongoimport* to migrate datasets offline (without replicating live changes) to Azure Cosmos DB for MongoDB vCore offering.
47
+
You can use the native MongoDB tools such as *mongodump/mongorestore*, *mongoexport/mongoimport* to migrate datasets offline (without replicating live changes) to vCore-based Azure Cosmos DB for MongoDB offering.
42
48
43
49
| Scenario | MongoDB native tool |
44
50
| --- | --- |
@@ -47,23 +53,30 @@ You can use the native MongoDB tools such as *mongodump/mongorestore*, *mongoexp
47
53
48
54
-*mongoexport/mongoimport* is the best pair of migration tools for migrating a subset of your MongoDB database.
49
55
-*mongoexport* exports your existing data to a human-readable JSON or CSV file. *mongoexport* takes an argument specifying the subset of your existing data to export.
50
-
-*mongoimport* opens a JSON or CSV file and inserts the content into the target database instance (Azure Cosmos DB for MongoDB vCore in this case.).
51
-
- JSON and CSV aren't a compact format; you could incur excess network charges as *mongoimport* sends data to Azure Cosmos DB for MongoDB vCore.
52
-
-*mongodump/mongorestore* is the best pair of migration tools for migrating your entire MongoDB database. The compact BSON format makes more efficient use of network resources as the data is inserted into Azure Cosmos DB for MongoDB vCore.
56
+
-*mongoimport* opens a JSON or CSV file and inserts the content into the target database instance (vCore-based Azure Cosmos DB for MongoDB in this case.).
57
+
- JSON and CSV aren't a compact format; you could incur excess network charges as *mongoimport* sends data to vCore-based Azure Cosmos DB for MongoDB.
58
+
-*mongodump/mongorestore* is the best pair of migration tools for migrating your entire MongoDB database. The compact BSON format makes more efficient use of network resources as the data is inserted into vCore-based Azure Cosmos DB for MongoDB.
53
59
-*mongodump* exports your existing data as a BSON file.
54
-
-*mongorestore* imports your BSON file dump into Azure Cosmos DB for MongoDB vCore.
60
+
-*mongorestore* imports your BSON file dump into vCore-based Azure Cosmos DB for MongoDB.
55
61
56
62
> [!NOTE]
57
63
> The MongoDB native tools can move data only as fast as the host hardware allows.
58
64
59
65
## Data migration using Azure Databricks (Offline/Online)
60
66
61
-
Migrating using Azure Databricks offers full control of the migration rate and data transformation. This method can also support large datasets that are in TBs in size.
67
+
Migrating using Azure Databricks offers full control of the migration rate and data transformation. This method can also support large datasets that are in TBs in size. The spark migration utility operates as a job within Databricks.
68
+
69
+
70
+
This tool supports the following MongoDB sources:
71
+
- MongoDB VM
72
+
- MongoDB Atlas
73
+
- AWS DocumentDB
74
+
- Azure Cosmos DB MongoDB RU (Offline only)
75
+
76
+
[Sign up for Azure Cosmos DB for MongoDB Spark Migration](https://forms.office.com/r/cLSRNugFSp) to gain access to the Spark Migration Tool GitHub repository. The repository offers detailed, step-by-step instructions for migrating your workloads from various Mongo sources to vCore-based Azure Cosmos DB for MongoDB.
62
77
63
-
-[Azure Databricks](https://azure.microsoft.com/services/databricks/) is a platform as a service (PaaS) offering for [Apache Spark](https://spark.apache.org/). You can use Azure Databricks to do an offline/online migration of databases from MongoDB to Azure Cosmos DB for MongoDB.
64
-
- Here's how you can [migrate data to Azure Cosmos DB for MongoDB vCore offline using Azure Databricks](../migrate-databricks.md#provision-an-azure-databricks-cluster)
65
78
66
79
## Related content
67
80
68
-
- Migrate data to Azure Cosmos DB for MongoDB vCore [using native MongoDB tools](how-to-migrate-native-tools.md).
69
-
- Migrate data to Azure Cosmos DB for MongoDB vCore [using Azure Databricks](../migrate-databricks.md).
81
+
- Migrate data to vCore-based Azure Cosmos DB for MongoDB using [native MongoDB tools](how-to-migrate-native-tools.md).
82
+
- Migrate data to vCore-based Azure Cosmos DB for MongoDB using the [MongoDB migration extension for Azure Data Studio](/azure-data-studio/extensions/database-migration-for-mongo-extension).
0 commit comments