{"id":6972,"date":"2023-11-15T08:00:11","date_gmt":"2023-11-15T16:00:11","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cosmosdb\/?p=6972"},"modified":"2026-07-21T11:03:19","modified_gmt":"2026-07-21T18:03:19","slug":"migrate-vcore-mongodb-extension","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cosmosdb\/migrate-vcore-mongodb-extension\/","title":{"rendered":"New Offline Migration Feature in Azure Cosmos DB for MongoDB Migration Extension for Azure Data Studio"},"content":{"rendered":"<p><em>Editor&#8217;s note (November 2025): Azure Cosmos DB for MongoDB (vCore) has been renamed to Azure DocumentDB. This article was originally published before the rename, so it uses the product name that was current at the time. While the product name has changed, the technical concepts discussed in this article remain applicable unless otherwise noted. For the latest Azure DocumentDB announcements, features, and technical guidance, visit the <a href=\"https:\/\/devblogs.microsoft.com\/documentdb\">Azure DocumentDB Dev Blog.<\/a><\/em><\/p>\n<p><em>Editor&#8217;s note (June 2026): Azure DocumentDB Migration Extension for VS Code is now generally available. <a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/documentdb\/how-to-migrate-vs-code-extension\">Read more how to migrate MongoDB workloads to Azure DocumentDB.\u00a0<\/a><\/em><\/p>\n<p>In April 2023, we announced the public preview for end-to-end <a href=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/migration-assessment-for-mongodb-to-azure-cosmos-db-for-mongodb\/\" target=\"_blank\" rel=\"noopener\">assessment in Azure Cosmos DB Migration for MongoDB extension in Azure Data Studio. <\/a>We have recently added the offline migration capability of MongoDB to Azure Cosmos DB MongoDB vCore to the same extension. With this additional capability, you can run an end-to-end assessment followed by migration with just a 7-step wizard. The platform manages the whole migration process and uses Azure cloud resources for a fast and efficient process. You don\u2019t need to set up or configure any additional resources for the migrations.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/mongo_migration.png\"><img decoding=\"async\" class=\"wp-image-6026 size-full aligncenter\" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/mongo_migration.png\" alt=\"Mongo Migration using Azure Data Studio extension\" width=\"550\" height=\"282\" \/><\/a><\/p>\n<p>The migration process is as simple as a copy-paste activity. Here are the steps involved:<\/p>\n<ol>\n<li>Select the source.<\/li>\n<li>Select the destination.<\/li>\n<li>Review the assessment report and decide if you are good for migrations.<\/li>\n<li>Migrate everything or identify the databases and collections you want to migrate.<\/li>\n<li>Press the migrate button.<\/li>\n<\/ol>\n<p>After capturing the migration configuration from the wizard, the remaining process is executed on Azure cloud resources for a fast and efficient migration. You can monitor the progress of the migration using Azure Cosmos DB Migration for MongoDB extension in Azure Data Studio. It is not necessary to be connected during the migration process.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91.jpg\"><img decoding=\"async\" class=\"aligncenter wp-image-7260 \" src=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-300x300.jpg\" alt=\"Data Migration\" width=\"457\" height=\"457\" srcset=\"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-300x300.jpg 300w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-150x150.jpg 150w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-768x768.jpg 768w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-24x24.jpg 24w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-48x48.jpg 48w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91-96x96.jpg 96w, https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-content\/uploads\/sites\/52\/2023\/11\/8253fee4-f5d1-476d-b08d-408d819f1f91.jpg 1024w\" sizes=\"(max-width: 457px) 100vw, 457px\" \/><\/a><\/p>\n<p>Try out the step-by-step guide on <a href=\"https:\/\/learn.microsoft.com\/azure-data-studio\/extensions\/database-migration-for-mongo-extension\" target=\"_blank\" rel=\"noopener\">how to migrate Mongo DB to Azure Cosmos DB MongoDB using Azure Cosmos DB Migration for MongoDB extension<\/a>.<\/p>\n<p>In the next few months, we will introduce online migrations and migration support for Azure Cosmos DB Mongo RU offering.<\/p>\n<p>If you have any questions related to migrations or Azure Cosmos DB Mongo DB, feel free to reach out to Microsoft at <a href=\"mailto:cdbmigrationsupport@microsoft.com\" target=\"_blank\" rel=\"noopener\">cdbmigrationsupport@microsoft.com<\/a>.<\/p>\n<h3 aria-level=\"2\"><b><span data-contrast=\"auto\">About Azure Cosmos DB<\/span><\/b><span data-ccp-props=\"{&quot;134245418&quot;:true,&quot;134245529&quot;:true,&quot;335559738&quot;:0,&quot;335559739&quot;:120}\">\u00a0<\/span><\/h3>\n<p><a href=\"https:\/\/azure.microsoft.com\/products\/cosmos-db\/\" target=\"_blank\" rel=\"noopener\"><span data-contrast=\"none\">Azure Cosmos DB<\/span><\/a><span data-contrast=\"none\"> is a fully managed NoSQL and relational database for modern app development with SLA-backed speed and availability, automatic and instant scalability, and support for open-source PostgreSQL, MongoDB, and Apache Cassandra. To stay in the loop on Azure Cosmos DB updates, follow us on <\/span><a href=\"https:\/\/twitter.com\/AzureCosmosDB\" target=\"_blank\" rel=\"noopener\"><span data-contrast=\"none\">Twitter<\/span><\/a><span data-contrast=\"none\">, <\/span><a href=\"https:\/\/www.youtube.com\/AzureCosmosDB\" target=\"_blank\" rel=\"noopener\"><span data-contrast=\"none\">YouTube<\/span><\/a><span data-contrast=\"none\">, and <\/span><a href=\"https:\/\/www.linkedin.com\/company\/azure-cosmos-db\/\" target=\"_blank\" rel=\"noopener\"><span data-contrast=\"none\">LinkedIn<\/span><\/a><span data-contrast=\"none\">.<\/span><span data-ccp-props=\"{&quot;335559739&quot;:240}\">\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Editor&#8217;s note (November 2025): Azure Cosmos DB for MongoDB (vCore) has been renamed to Azure DocumentDB. This article was originally published before the rename, so it uses the product name that was current at the time. While the product name has changed, the technical concepts discussed in this article remain applicable unless otherwise noted. For [&hellip;]<\/p>\n","protected":false},"author":96034,"featured_media":7260,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[12,15,996],"tags":[1768,286,1870],"class_list":["post-6972","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcements","category-mongodb-api","category-migration","tag-azure-cosmos-db-api-for-mongodb","tag-migration","tag-vcore"],"acf":[],"blog_post_summary":"<p>Editor&#8217;s note (November 2025): Azure Cosmos DB for MongoDB (vCore) has been renamed to Azure DocumentDB. This article was originally published before the rename, so it uses the product name that was current at the time. While the product name has changed, the technical concepts discussed in this article remain applicable unless otherwise noted. For [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/6972","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/users\/96034"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/comments?post=6972"}],"version-history":[{"count":2,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/6972\/revisions"}],"predecessor-version":[{"id":12743,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/posts\/6972\/revisions\/12743"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/media\/7260"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/media?parent=6972"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/categories?post=6972"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cosmosdb\/wp-json\/wp\/v2\/tags?post=6972"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}