共用方式為


適用於 Azure Data Studio 的 Azure Cosmos DB for MongoDB 移轉延伸項目(預覽版)

Azure Cosmos DB for MongoDB 延伸項目,可協助將 MongoDB 工作負載移轉至 Azure Cosmos DB。 您可以使用此延伸項目來執行以下動作:

  • 對工作負載執行端對端評定,並找出將工作負載移轉到以 vCore 為基礎的 Azure Cosmos DB for MongoDB 所需採取的必要動作。
  • 使用選取的資料庫和集合來執行移轉作業,以虛擬核心型的 Azure Cosmos DB for MongoDB。

重要

目前此延伸項目不支援下列案例:

  • 來源或目標帳戶已啟用私人端點的移轉。
  • 適用於 RU 型 Azure Cosmos DB for MongoDB 的線上/離線移轉。

如需適用於 MongoDB 虛擬核心 API 的替代解決方案的詳細資訊,請參閱移轉選項

必要條件

  • 以現有虛擬核心型的 Azure Cosmos DB for MongoDB 帳戶。
  • 最新版本的 Azure Data Studio
  • 執行版本 3.2 或更新版本的 MongoDB
  • 將防火牆例外狀況新增至來源 MongoDB 和虛擬核心型的 Azure Cosmos DB for MongoDB 目標帳戶,以接受來自全域 Azure 資料中心的連線。
  • 如果您第一次使用資料移轉服務,請確定 Microsoft.DataMigration 資源提供者已在您的訂閱中註冊

準備

在開始移轉之前,請在實際移動任何資料之前對移轉進行前期規劃和決策。

在您的訂用帳戶註冊 Microsoft.DataMigration 資源提供者

若要確保您的訂用帳戶中已註冊 Microsoft.DataMigration 資源提供者,您可以遵循以下步驟:

Azure 入口網站︰

  1. 前往 Azure 入口網站,然後瀏覽至訂用帳戶。
  2. 在左側選單中,選擇「設定」之下的「資源提供者」。
  3. 在頂端的搜尋框中搜尋 Microsoft.DataMigration。
  4. 如果未註冊,請選取它,然後按下「註冊」按鈕。

Azure CLI:

  1. 開啟 Azure Cloud Shell 或本機。
  2. 執行下列命令以註冊資源提供者:
az provider register --namespace Microsoft.DataMigration

PowerShell:

  1. 開啟 Azure Cloud Shell 或本機的 PowerShell。
  2. 執行下列命令以註冊資源提供者:
Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

安裝延伸項目

在開始移轉之前,請先在 Azure Data Studio 中安裝 Azure Cosmos DB for MongoDB 移轉延伸項目。

  1. 在 Azure Data Studio 中開啟延伸項目管理員。 您可以選取延伸模組圖示,或在「檢視」功能表中選取延伸項目

  2. 在搜尋列中輸入 Cosmos

  3. 選取 [適用於 MongoDB 的 Azure Cosmos 資料庫遷移] 延伸模組,並檢視其詳細資料。

    Azure Cosmos DB for MongoDB 移轉延伸項目安裝按鈕的螢幕擷取畫面。

  4. 選取 [安裝]。

進行延伸模組設定

安裝延伸模組之後,您可以進行某些延伸模組設定。 此為選用步驟。 如果未明確設定任何設定,延伸模組會使用預設設定。

  1. 移至延伸模組,然後選取 [適用於 MongoDB 的 Azure Cosmos 資料庫遷移]、選取 [管理設定] 圖示,然後選取 [延伸模組設定]。

    延伸項目設定選項的螢幕擷取畫面。

  2. 在此處延伸模組的延伸模組設定下,提供 Assessment path 以變更儲存評定中繼資料的位置。 如果保留空白,則會使用預設位置。

連線到 MongoDB 來源

第一次使用延伸項目連接到現有的 MongoDB 來源執行個體。 請確定您已準備好來源的連線認證,再開始本章節。

  1. 在選單列中找到連接圖示,然後選擇新連接

    延伸模組中 [連線] 選單列的螢幕擷取畫面。

  2. 連線窗格中,填寫以下欄位:

    連線類型 Azure Cosmos DB for MongoDB
    連接字串參數 針對現有的來源 MongoDB 執行個體使用連接字串或參數。
    伺服器群組 Default
    名稱 (選擇性) 為此連接提供唯一的名稱
  3. 選取 Connect

  4. 在 [連線] 窗格開啟新連線的特色選單。 然後選取 [管理]

    顯示 [管理資料庫] 畫面的螢幕擷取畫面。

  5. 選取 [Azure Cosmos DB 移轉]

    顯示移轉評定資料庫畫面的螢幕擷取畫面。

執行評估

評定會檢查您目前的 MongoDB 資料資產和使用率。 然後,評定功能會產生完整的報告,以協助您識別將工作負載移轉至 Azure Cosmos DB for MongoDB 之前所要採取的必要動作。

  1. 找出並流覽至 [儀表板] 索引標籤。然後,選取 [評定及移轉資料庫]

    延伸模組移轉功能內 [儀表板] 索引標籤的螢幕擷取畫面。

  2. 完成精靈以提供延伸項目的詳細資料,以便執行評定。

    驗證認證之前評定詳細資料的螢幕擷取畫面。

    1. 在 [評定名稱] 欄位,輸入標題。

    2. 供應項目下拉式功能表選取目標 Azure Cosmos DB for MongoDB 帳戶。

    3. 提供 MongoDB 記錄的路徑。

      提示

      這是選擇性欄位,但指定記錄路徑會導致在集合層級產生更細微的結果。 未指定記錄檔資料夾時,此工具會使用 serverStatus 命令的詳細資料來執行評定。

      serverStatus 命令僅傳回自上次重新啟動以來的功能使用方式,因此您需要確保自上次伺服器重新啟動以來已經過去了足夠的時間才能取得準確反映實際工作負載的評定。

    4. 提供資料評定記錄的路徑。

      提示

      雖然此欄位是選用,但提供資料評定記錄可以產生更詳細的工作負載深入解析。 這些記錄是藉由掃描資料和讀取詳細資訊記錄來取得。 在起始移轉評定之前,資料評定會以 CLI 獨立執行,然後在這裡提供產生的 JSON。 在這裡下載資料評定 CLI。

    5. 選擇 [執行驗證] 來驗證評定輸入。

  3. 驗證成功後,選取 [開始評定] 以執行評定。

    驗證認證之後評定詳細資料的螢幕擷取畫面。

  4. 根據來源伺服器的大小,評定程序可能需要一些時間。 等待評定完成後再繼續。

    正在進行中的新評定的螢幕擷取畫面。

  5. 評定完成之後,您現在應該會有評定報告。

    來源 MongoDB 執行個體的新評定報告的螢幕擷取畫面。

  6. 在評定報告中,選取執行個體名稱以檢閱整個伺服器的問題清單。 選取特定資料庫,以檢視僅適用於所選資料庫的問題。

    來源 MongoDB 執行個體內所選資料庫之新評定報告的螢幕擷取畫面。

  7. 選取 [下載報表] 以取得合併的可下載報告。

  8. 研究評定報告,以確定在 Azure Cosmos DB for MongoDB 順暢移轉工作負載所需的任何動作。 在進行下一個步驟之前,請確定會處理評定中報告的所有執行問題。 如果有任何未解決的問題,您可以退出該流程並稍後處理。 一旦解決問題,您就可以返回並重新啟動評定和移轉程序。

執行移轉

現在,使用評定報告,將您的資料從來源 MongoDB 執行個體移轉至虛擬核心型的 Azure Cosmos DB for MongoDB 帳戶。

  1. 在評定報告畫面中,選取您打算移轉的任何資料庫。 然後選取下一步

    選取要移轉的資料庫的螢幕擷取畫面。

  2. 透過按訂用帳戶和資源群組進行篩選,以選取目標 Azure Cosmos DB for MongoDB 帳戶的清單。 然後提供連線到帳戶所需的連線認證。

    選取目標 Azure Cosmos DB for MongoDB 帳戶的螢幕擷取畫面。

  3. 選取 [測試連接],以驗證 Azure Cosmos DB for MongoDB 帳戶的認證。 選取 [下一步] 以瀏覽至從來源到目標集合的對應。

  4. 針對對應清單中的每個集合選擇 [略過] 或 [移轉]。 已存在於目標中的集合會自動標示為圖示,並預設設定為 [略過]。 選取 [下一步] 以設定 Azure 資料庫移轉服務 (DMS)。

    從來源對應至目標之集合的螢幕擷取畫面。

    警告

    選擇 移轉 現有集合將覆寫整個集合,導致無法復原的資料遺失。 選擇此選項時請謹慎。

  5. 從下拉式功能表選擇現有的 Azure 資料庫移轉服務 執行個體,或選取「建立新的」以建立新的移轉服務。 Azure 資料庫移轉服務是一項使用雲端基礎結構進行資料傳輸的服務,而不是依賴本機資源,將資料移轉到 Azure 資料平台或從 Azure 資料平台移轉資料的服務。

    選擇移轉服務之選項的螢幕擷取畫面。

  6. 選取最適合您使用案例的移轉模式。

    • 線上移轉會複製收集資料,確保在此過程也複寫更新。 此方法的優點是停機時間最短,允許連續運作以實現商務持續性。 當進行中的作業很重要時,並且優先考慮減少停機時間時,請使用此選項。
    • 離線移轉會在一開始擷取資料庫的快照集,並提供更簡單且可預測的方法。 當使用資料庫的靜態複本是可接受的,而且即時更新並非必要時,它運作良好。
  7. 選取 [下一步] 以查看移轉摘要。 檢閱並確認詳細資料之後,請選取 [建立結構描述] 以在目標帳戶建立資源。

    檢視移轉摘要選項的螢幕擷取畫面。

  8. 選取 [開始移轉] 以使用選取的移轉服務啟動資料傳輸。

    使用移轉服務開始移轉選項的螢幕擷取畫面。

  9. 在 [確認設定] 快顯視窗,確認您的防火牆設定是否符合需求。 選取確定以確認。

    [確認設定] 快顯視窗的螢幕擷取畫面,以驗證您的防火牆設定。

資料移轉工作會在 Azure 資料庫移轉服務執行,因此您不需要在資料移轉期間連線到來源和目標環境。 儀表板上的狀態會以頻繁的間隔更新

注意

如果您選取了 50 多個要移轉的集合,移轉作業將會批次處理到移轉服務的多個作業,每個作業最多包含 50 個集合。

  1. 在初始化作業之後,在儀表板頁面監視移轉狀態。

    具有移轉狀態的儀表板螢幕擷取畫面。

  2. 若要檢視更多詳細資料,請從移轉清單中選取特定的移轉。

監視離線移轉

一旦完成所有資料移轉工作,狀態就會自動更新。

具有移轉狀態集合的螢幕擷取畫面。

成功將資料從來源複製到目標之後,離線移轉狀態表示成功。

成功移轉狀態的螢幕擷取畫面。

  • 將應用程式的連接字串變更為指向目標帳戶。

監視線上移轉

與離線移轉不同,線上移轉不會自動完成。 相反地,它們會持續執行,直到選取 [完全移轉] 手動完成為止。

線上移轉狀態的螢幕擷取畫面。

若要完成線上移轉,請依照指定順序執行下列步驟:

  1. [完全移轉] 按鈕會在所有集合完成初始資料載入後啟用。 移轉目前處於複寫階段,會持續將更新從來源執行個體複製到目標執行個體,以保持最新變更的最新狀態。

  2. 準備好執行移轉完全移轉時,請停止移轉來源集合的所有傳入異動。

  3. 監視資料表中的複寫變更,並等候「複寫變更播放」計量穩定。 穩定的「復寫變更已播放」計量表示來源的所有更新都已成功複製到目標。

  4. 當所有集合的複寫差距最小,且 [複寫變更播放] 計量穩定時,請選取 [完全移轉]

  5. 手動驗證來源與目標集合之間的資料列計數是否相同。

  6. 在快顯對話方塊。 選取[完成完全移轉]
    線上移轉完全移轉快顯視窗的螢幕擷取畫面。

    注意

    執行完全移轉作業而不驗證來源和目標同步有可能導致資料遺失。

  7. 等待狀態變更為 [成功]

  8. 更新應用程式中的連接字串以指向目標帳戶。

檢視過去的移轉和評定

檢視過去的評定和移轉通常很有用。 延伸項目提供一個介面來檢閱過去評定和移轉的摘要。 延伸項目也提供檢閱詳細歷程評定報告的功能。

  1. 若要檢視過去的移轉,請選取工具列中的 [移轉] 索引標籤。 移轉清單包含目前機器上啟動的所有移轉。 您可以在清單中選取特定的移轉,以取得更多詳細資料。

    使用延伸項目建立的所有移轉清單的螢幕擷取畫面。

  2. 若要檢視過去的評定,請選取工具列中的 [評定] 索引標籤。 評定清單包含目前機器上啟動的所有評定。

    使用延伸項目執行的所有評定清單的螢幕擷取畫面。

後續步驟