All Collections
Migrating
Migrate or Import Data to Atlas
Migrate or Import Data to Atlas

Methods for migrating a non-relational database to Atlas

B
Written by Brie Wolf
Updated over a week ago

In this article you'll learn:

Bring data from existing MongoDB deployments, JSON, or CSV files into deployments in Atlas using either:

  1. Live migration where Atlas assists you, or

  2. Tools for a self-guided migration of data from your existing deployments into Atlas

Which migration option is right for you?

Live Migration

  1. Cannot afford a lot of downtime

  2. Dedicated cluster (M10 and above)

Self-Guided

  1. You have a small dataset

  2. The cluster you are migrating is on a shared tier (M0/M2/M5) or a serverless cluster

  3. You have a large dataset that can have more downtime

  4. Live Migrate doesn’t support your configuration

Tools for Migrating to Atlas based on Cluster Configuration

Choose between different tools for data migration and import for common cluster configurations:

Source Cluster Configuration

Import Strategy

MongoDB deployment that is managed by Cloud Manager or Ops Manager

Use live migration (push) where Cloud Manager or Ops Manager pushes data to Atlas using a secure link token without requiring access to the source cluster through the cluster's firewall

MongoDB deployment that is not managed by Cloud Manager or Ops Manager

Use live migration (pull) where Atlas pulls data from the source deployment and requires access to the source deployment through the deployment's firewall

Shared multi-tenant cluster

Cluster where you have no access to the oplog

Cluster that runs a MongoDB version that is no longer supported

Use mongodump and mongorestore to seed a MongoDB Atlas cluster with data from an existing MongoDB standalone or replica set

Standard "single shard" sharded cluster MongoDB deployment in Compose

Live Migration for Compose to MongoDB Atlas

Migrate a MongoDB Replica Set from AWS to MongoDB Atlas

Live Migration for AWS to MongoDB Atlas

For a guided minimal-downtime migration procedure, see Replica Set Live Migration or Sharded Cluster Live Migration.

Self-Managed Migration Tools

Self-managed tools (also known as backup-and-restore) are great options if:

  1. You have a small dataset

  2. The cluster you are migrating is on a shared tier (M0/M2/M5) or a serverless cluster

  3. You have a large dataset that can have more downtime

Note: These are the only options available for shared cluster migrations.

Tool

Description

Seed an Atlas cluster with a BSON data backup dump of an existing MongoDB deployment. mongorestore does not restore system.profile collection data.

Load data from a JSON or a CSV file into an Atlas cluster. mongoimport uses strict mode representation for certain BSON types.

Use a GUI to load data from a JSON or a CSV file into an Atlas cluster.

Migrate your sharded cluster or a replica set into an Atlas cluster with minimal downtime. Mongosync supports heterogeneous migrations (e.g. from a replica set to sharded cluster, or from N shards to M shards), as well as many other features.

Supports MongoDB versions 6.0+

You can also restore from an Atlas cluster backup data to another Atlas cluster. For information, see Restore Your Database Deployment.

Additional Resources

Did this answer your question?