This topic describes how to migrate data from Amazon DynamoDB to ApsaraDB for MongoDB by using mongoimport, which is built in MongoDB for data restoration. You can install a MongoDB database on a local server or in an ECS instance as an intermediary, and then use mongoimport to migrate data from an Amazon DynamoDB instance to an ApsaraDB for MongoDB instance.


An ApsaraDB for MongoDB instance is created. For more information, see Create an instance or Create a sharded cluster instance.


  • This is full data migration. Incremental data migration is not supported. To ensure data consistency, we recommend that you do not write data to the source database before you migrate data.
  • Run the mongoimport command on the local server. Do not run this command in the mongo shell.

Term mapping

Term in Amazon DynamoDB Term in ApsaraDB for MongoDB
Table Collection
Item Document
Attribute Field


Install a MongoDB database on the local server. Make sure that the version of the database is the same as the database version of the ApsaraDB for MongoDB instance. This server plays an intermediary role during data migration. This example installs MongoDB on Ubuntu.

  1. Install the MongoDB database on the local server. For more information, visit Install MongoDB.
    Note This server plays an intermediary role in both data backup and restoration. The server is no longer required after the migration is complete.
  2. Add the public IP address of the local server to a whitelist of the ApsaraDB for MongoDB instance. For more information, see Configure a whitelist.


  1. Log on to the Amazon DynamoDB console.
  2. In the left-side navigation pane, click Tables.
  3. Select the table you want to migrate. For this example, select customer.Select an Amazon DynamoDB table
  4. Select the data you want to migrate and export it to a .csv file.Select Amazon DynamoDB data to be migrated
    1. Click the Items tab.
    2. Select the items you want to migrate.
    3. Choose Actions > Export to .csv.
  5. Copy the exported .csv file to the local server described in Preparation.
  6. Log on to the ApsaraDB for MongoDB console to obtain the public endpoint of the ApsaraDB for MongoDB instance.
    Note You must apply for a public endpoint manually. For more information, see Apply for a public address.
  7. On the local server, run the following command to import the backup files to an ApsaraDB for MongoDB database:
    mongoimport --host <mongodb_host:port> --authenticationDatabase admin -u <username> --db <database> --collection <collection> --file <filename>  --type csv --headerline                    
    • <mongodb_host:port>: the public endpoint of the primary node in the replica set instance of ApsaraDB for MongoDB, or the public endpoint of a mongos in the sharded cluster instance of ApsaraDB for MongoDB.
    • <username>: the username of the destination database in the ApsaraDB for MongoDB instance. The initial username is root. This user must have read/write permissions on the destination database.
    • <database>: the name of the authentication database. It is the database where the database user is created. If the database username is root, enter admin.
    • <collection>: the name of the collection to import data to.
    • <filename>: the path and name of the .csv file.
    Example: Import data from the customer.csv file to the customer collection in the mongodbtest database.
    mongoimport --host --authenticationDatabase admin -u root --db mongodbtest --collection customer --file ~/download/customer.csv  --type csv --headerline
  8. When Enter password: is displayed, enter the password of the ApsaraDB for MongoDB database user and press Enter.
    Note If you want to migrate data of other tables, repeat Steps 3 to 8.

After data import is complete, the data of the source Amazon DynamoDB instance is migrated to the destination ApsaraDB for MongoDB instance.

What to do next

To improve the performance of data operations, we recommend that you create indexes after you import data. For more information, visit db.collection.createIndex.