如何將AzureCosmosDBAPIforMongoDB遷移至阿里雲 - ApsaraDB for MongoDB

注意事項

該操作為全量遷移，為避免遷移前後資料不一致，遷移開始前請停止資料庫寫入。
如果您之前使用mongodump命令對資料庫進行過備份操作，請將備份在dump檔案夾下的檔案移動至其他目錄。確保預設的dump備份檔案夾為空白，否則將會覆蓋該檔案夾下之前備份的檔案。
請在安裝有MongoDB服務的伺服器上執行mongodump和mongorestore命令，並非在mongo shell環境下執行。

資料庫帳號許可權要求

執行個體類型	帳號許可權
Azure Cosmos DB	read
目的MongoDB執行個體	readWrite

環境準備

建立ApsaraDB for MongoDB執行個體，詳情請參見建立執行個體。
說明
- 執行個體的儲存空間要大於Azure Cosmos DB。
- 執行個體的資料庫版本選用4.0及以上版本。
設定阿里雲MongoDB資料庫的資料庫密碼，詳情請參見設定密碼。
在某個伺服器上安裝MongoDB程式，詳情請參見安裝MongoDB。
說明
- 請安裝MongoDB 3.0以上版本。
- 該伺服器僅作為資料備份與恢複的臨時中轉平台，遷移操作完成後不再需要。
- 備份目錄所在分區的可用磁碟空間要大於Azure Cosmos DB。
本案例將MongoDB服務安裝在Linux伺服器上進行示範。

遷移步驟

登入Azure門戶。
在左側導覽列單擊Azure Cosmos DB。
在Azure Cosmos DB頁面，單擊需要遷移的Cosmos DB 賬戶名稱。
在賬戶詳情頁，單擊Connection String。
單擊Read-only Keys頁簽，查看串連該資料庫所需的資訊。

圖 1. Azure串連資訊頁面顯示串連該資料庫所需的欄位，包括 HOST（格式為 xxx.documents.azure.cn）、PORT（值為 10255）、USERNAME、PRIMARY PASSWORD、SECONDARY PASSWORD、PRIMARY CONNECTION STRING、SECONDARY CONNECTION STRING 以及 SSL（值為 true）。其中 HOST、USERNAME 和 PRIMARY PASSWORD 是需要重點關注的串連資訊。

說明
遷移資料時使用唯讀許可權的帳號密碼資訊即可。
在安裝有MongoDB服務的Linux伺服器上執行以下命令進行資料備份，將資料備份至該伺服器上。
```
mongodump --host <HOST>:10255 --authenticationDatabase admin -u <USERNAME> -p <PRIMARY PASSWORD> --ssl --sslAllowInvalidCertificates
```
說明
將<HOST>、<USERNAME>和<PRIMARY PASSWORD>更換為Azure串連資訊中對應選項的值。

等待備份完成，Azure Cosmos DB的資料庫將備份至目前的目錄下dump檔案夾中。
擷取阿里雲MongoDB資料庫的Primary節點串連地址，詳情請參見執行個體串連說明。
在安裝有MongoDB服務的Linux伺服器上執行以下語句將資料庫資料全部匯入至阿里雲MongoDB資料庫。
```
 mongorestore --host <mongodb_host>:3717 --authenticationDatabase admin -u <username> -p <password> dump
```
說明
- <mongodb_host>：MongoDB執行個體的Primary節點串連地址。
- <username>：登入MongoDB執行個體的資料庫使用者名稱。
- <password>：登入MongoDB執行個體的資料庫密碼。

等待資料恢複完成，Azure Cosmos DB API for MongoDB資料庫即遷移至阿里雲MongoDB資料庫中。