使用 MongoDB 原生工具將 MongoDB 離線移轉至 Azure Cosmos DB for MongoDB 虛擬核心

發行項
03/27/2024

適用於： MongoDB 虛擬核心

在此教學課程中，您會使用 MongoDB 原生工具，在離線狀態下將資料庫從內部部署或雲端的 MongoDB 執行個體 (單次) 移轉至 Azure Cosmos DB for MongoDB 虛擬核心I。 MongoDB 原生工具是一組二進位檔，可協助您在現有的 MongoDB 執行個體上進行資料操作。本文件的重點在於使用 mongoexport/mongoimport 或mongodump/mongorestore，將資料從 MongoDB 執行個體中向外移轉。由於原生工具會使用連接字串連線至 MongoDB，因此您可以在任何位置執行這些工具。對於不需考量總移轉時間的小型資料集，原生工具可能是最簡單的解決方案。

必要條件

現有的 Azure Cosmos DB for MongoDB 虛擬核心叢集。
- 如果您沒有 Azure 訂用帳戶，請建立免費帳戶。
- 如果您有現有的 Azure 訂用帳戶，請建立新的 Azure Cosmos DB for MongoDB 虛擬核心叢集。
安裝在機器上的 MongoDB 原生工具。

準備

開始移轉之前，請確定您已備妥 Azure Cosmos DB for MongoDB 虛擬核心帳戶和現有的 MongoDB 執行個體，以進行移轉。

MongoDB 執行個體 (來源)
- 完成預先移轉評估，以確認來源執行個體與目標帳戶之間是否有不相容和警告的清單。
- 確定您的 MongoDB 原生工具符合與現有 (來源) MongoDB 執行個體相同的版本。
  - 如果 MongoDB 執行個體的版本與 Azure Cosmos DB for MongoDB 虛擬核心不同，請同時安裝 MongoDB 原生工具版本，並分別使用適用於 MongoDB 和 Azure Cosmos DB for MongoDB 虛擬核心的適當工具版本。
- 新增具有 readWrite 權限的使用者 (除非已有權限)。最終，您會將此認證搭配用於 mongoexport 和 mongodump 工具。
Azure Cosmos DB for MongoDB 虛擬核心 (目標)
- 收集 Azure Cosmos DB for MongoDB 虛擬核心帳戶的認證。
- 在 Azure Cosmos DB for MongoDB 虛擬核心上設定防火牆設定。

提示

建議您在與 MongoDB 執行個體相同的網路中執行這些工具，以避免發生其他防火牆問題。

選擇適當的 MongoDB 原生工具

為您的離線移轉選擇正確的 MongoDB 原生工具時，需考量一些高階注意事項。

執行移轉。

使用您慣用的原生工具，將集合從來源 MongoDB 執行個體移轉至目標 Azure Cosmos DB for MongoDB 虛擬核心帳戶。如需選取工具的詳細資訊，請參閱原生 MongoDB 工具

提示

如果您只是想要將小型 JSON 檔案匯入 Azure Cosmos DB for MongoDB 虛擬核心中，mongoimport 工具將是擷取資料的快速解決方案。

mongoexport/mongoimport
mongodump/mongorestore

若要從來源 MongoDB 執行個體匯出資料，請開啟終端機，並從此處所列的三種方法中任意擇一使用。

指定 --host、--username 和 --password 引數以連接並匯出 JSON 記錄。

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 虛擬核心匯出資料。

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

將先前匯出的檔案匯入目標 Azure Cosmos DB for MongoDB 虛擬核心帳戶中。

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

監視來自 mongoimport 的終端機輸出。輸出會將文字行列印至終端機，其中包含匯入作業狀態的更新。

若要在 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 虛擬核心中建立所有資料的資料傾印。
```
mongodump \
    --uri <target-connection-string> \
    --out <dump-directory>
```

您會看到工具建立了一個目錄，其中包含已傾印的原生 BSON 資料。檔案和資料夾會根據資料庫和集合名稱組織到資源階層中。每個資料庫都是資料夾，每個集合都是 .bson 檔案。
藉由指定集合的特定 BSON 檔案，將任何特定集合的內容還原至 Azure Cosmos DB for MongoDB 虛擬核心帳戶中。檔案名稱會使用此語法建構：<dump-directory>/<database-name>/<collection-name>.bson。
```
mongorestore \ 
   --db <database-name> \
   --collection <collection-name> \
   --ssl \
   --uri <target-connection-string> \
   <dump-directory>/<database-name>/<collection-name>.bson
```
監視來自 mongoimport 的終端機輸出。輸出會將文字行列印至終端機，其中包含還原作業狀態的更新。

後續步驟

建置 Node.js Web 應用程式

共用方式為