你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 MongoDB 本机工具将 MongoDB 脱机迁移到 Azure Cosmos DB for MongoDB vCore

适用对象： MongoDB vCore

在本教程中，可以使用 MongoDB 本机工具将数据库从 MongoDB 的本地或云实例脱机（一次性）迁移到 Azure Cosmos DB for MongoDB vCore。 MongoDB 本机工具是一组二进制文件，有助于对现有 MongoDB 实例进行数据操作。 此文档的重点是使用 mongoexport/mongoimport 或 mongodump/mongorestore 将数据从 MongoDB 实例中迁移出来 。 由于本机工具使用连接字符串连接到 MongoDB，因此可以在任意位置运行这些工具。 对于不考虑总迁移时间的小型数据集，本机工具可能是最简单的解决方案。

先决条件

• 现有的 Azure Cosmos DB for MongoDB vCore 群集。
  • 如果没有 Azure 订阅，请免费创建一个帐户。
  • 如果具有现有 Azure 订阅，则创建新的 Azure Cosmos DB for MongoDB vCore 群集。
• 计算机上已安装 MongoDB 本机工具。

准备

在开始迁移之前，请确保已准备好 Azure Cosmos DB for MongoDB 帐户和用于迁移的现有 MongoDB 实例。

• MongoDB 实例（源）
  • 完成预迁移评估以确定源实例和目标帐户之间是否存在不兼容和警告的列表。
  • 请确保你的 MongoDB 本机工具版本与现有的（源）MongoDB 实例匹配。
    • 如果 MongoDB 实例的版本与 Azure Cosmos DB for MongoDB vCore 的版本不同，则请安装这两个 MongoDB 本机工具版本，并分别为 MongoDB 和 Azure Cosmos DB for MongoDB vCore 使用适当的工具版本。
  • 添加具有 readWrite 权限的用户，除非已存在这样的用户。 最终将此凭据与 mongoexport 和 mongodump 工具配合使用。
• Azure Cosmos DB for MongoDB vCore（目标）
  • 收集 Azure Cosmos DB for MongoDB vCore 帐户凭据。
  • 配置 Azure Cosmos DB for MongoDB vCore 上的防火墙设置。

提示

建议在 MongoDB 实例所在的同一网络中运行这些工具，以避免进一步的防火墙问题。

选择适当的 MongoDB 本机工具

为脱机迁移选择正确的 MongoDB 本机工具时，需要考虑一些高级注意事项。

执行迁移

使用首选本机工具将集合从源 MongoDB 实例迁移到目标 Azure Cosmos DB for MongoDB vCore 帐户。 有关选择工具的详细信息，请参阅本机 MongoDB 工具

提示

如果只想要将小型 JSON 文件导入 Azure Cosmos DB for MongoDB vCore，则 mongoimport 工具是用于引入数据的快速解决方案。

1. 若要从源 MongoDB 实例导出数据，请打开终端并使用此处列出的三种方法中的任何一种。

   • 指定要连接到和导出 JSON 记录的 --host、--username 和 --password 自变量。

     mongoexport \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --db <database-name> \
         --collection <collection-name> \
         --out <filename>.json
     

   • 通过添加 --query 自变量导出 MongoDB 数据的子集。 此参数确保该工具仅导出与筛选器匹配的文档。

     mongoexport \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --db <database-name> \
         --collection <collection-name> \
         --query '{ "quantity": { "$gte": 15 } }' \
         --out <filename>.json
     

   • 从 Azure Cosmos DB for MongoDB vCore 导出数据。

     mongoexport \
         --uri <target-connection-string>
         --db <database-name> \
         --collection <collection-name> \
         --query '{ "quantity": { "$gte": 15 } }' \
         --out <filename>.json
     

2. 将以前导出的文件导入目标 Azure Cosmos DB for MongoDB vCore 帐户。

   mongoimport \
       --file <filename>.json \
       --type json \
       --db <database-name> \
       --collection <collection-name> \
       --ssl \
       --uri <target-connection-string>
   

3. 监视 mongoimport 的终端输出。 输出会向终端打印文本行，并显示导入操作的最新状态。

1. 若要在 MongoDB 实例中创建所有数据的数据转储，请打开终端并使用此处列出的三种方法中的任何一种。

   • 指定 --host、--username 和 --password 自变量，以将数据转储为本机 BSON。

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --out <dump-directory>
     

   • 指定 --db 和 --collection 自变量以缩小要转储的数据的范围：

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \    
         --db <database-name> \
         --out <dump-directory>
     

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \    
         --db <database-name> \
         --collection <collection-name> \
         --out <dump-directory>
     

   • 在 Azure Cosmos DB for MongoDB vCore 中创建所有数据的数据转储。

     mongodump \
         --uri <target-connection-string> \
         --out <dump-directory>
     

2. 请注意，该工具创建了一个目录，并转储了本机 BSON 数据。 文件和文件夹根据数据库和集合名称组织到资源层次结构中。 每个数据库都是一个文件夹，每个集合都是一个 .bson 文件。

3. 通过指定集合的特定 BSON 文件，将任何特定集合的内容还原到 Azure Cosmos DB for MongoDB vCore 帐户中。 文件名是使用此语法构造的：<dump-directory>/<database-name>/<collection-name>.bson。

   mongorestore \ 
       --ssl \
       --uri <target-connection-string> \
       <dump-directory>/<database-name>/<collection-name>.bson
   

   注意

   还可以从转储目录/目录还原一个或多个特定的集合。 例如，以下操作从转储目录/目录中的相应数据文件还原单个集合。 mongorestore --nsInclude=test.purchaseorders <dump-directory>/

4. 监视 mongoimport 的终端输出。 输出会向终端打印文本行，显示还原操作的最新状态。

下一步

编译 Node.js Web 应用程序