Online migrace MongoDB do Azure DocumentDB s využitím rozšíření migrace Azure DocumentDB (Public Preview)

V tomto kurzu použijete rozšíření migrace Azure DocumentDB v editoru Visual Studio Code k vytváření a správě úloh migrace z místní nebo cloudové instance MongoDB do Azure DocumentDB. Toto rozšíření poskytuje vývojářské rozhraní pro provádění migrací bez přerušení služeb. Rozšíření eliminuje potřebu další infrastruktury a nabízí zabezpečené připojení, nulové náklady a podrobnou kontrolu nad tím, které databáze a kolekce se mají migrovat.

Tento článek se zaměřuje na použití integrovaného pracovního postupu rozšíření ke zjednodušení kroků migrace přímo v editoru Visual Studio Code. Tento přístup je ideální pro scénáře, ve kterých chcete zefektivnit a spravovat prostředí s minimální složitostí a maximální spolehlivostí.

Požadavky

• Předplatné Azure

  • Pokud ještě předplatné Azure nemáte, vytvořte si bezplatný účet.

• Existující cluster Azure DocumentDB

  • Pokud cluster nemáte, vytvořte nový cluster.

• Nainstalujte na svůj počítač Azure DocumentDB Migration Extension. Tím se automaticky nainstaluje její předpoklad, rozšíření DocumentDB pro Visual Studio Code .

Před zahájením migrace připravte svůj účet Azure DocumentDB a stávající instanci MongoDB na migraci.

Instance MongoDB (zdroj)

• Dokončete posouzení premigrace a zjistěte, jestli mezi vaší zdrojovou instancí a cílovým účtem existují nekompatibility a upozornění.
• Přidejte uživatele s oprávněními readAnyDatabaseclusterMonitor , pokud ještě neexistuje. Tyto přihlašovací údaje použijete při vytváření úloh migrace v rozšíření.

Azure DocumentDB (cíl)

• Shromážděte přihlašovací údaje účtu Azure DocumentDB.
• Ujistěte se, že uživatel má oprávnění createCollection, dropCollection, createIndex, insert a listCollections.

Důležité

Ověřování Microsoft Entra ID se v současné době nepodporuje v migračních úlohách. Použijte nativní ověřování DocumentDB.

Provedení migrace

Připojení ke zdroji

1. Otevřete documentDB pro rozšíření VS Code .
2. Přidejte server MongoDB, který chcete migrovat, do seznamu připojení databáze dokumentů .
3. Vyberte Přidat nové připojení.
4. Na navigačním panelu vyberte Připojovací řetězec.
5. Vložte připojovací řetězec: mongodb://<YOUR_USERNAME>:<YOUR_PASSWORD>@localhost:10260/?tls=true&tlsAllowInvalidCertificates=true&authMechanism=SCRAM-SHA-256
6. Ze seznamu připojení DocumentDB vyberte připojení a rozbalte ho pro navázání spojení.

Vyvolání rozšíření migrace

Rozšíření migrace můžete vyvolat z připojení k DocumentDB.

1. Klikněte pravým tlačítkem myši na rozbalené (připojené) připojení.

2. V místní nabídce vyberte Data Migration.

   

3. Na paletě příkazů vyberte Migrovat do Azure DocumentDB .

   

4. Průvodce migrací vás provede procesem.

Vytvořte úlohu migrace

Úloha migrace se používá k migraci skupiny kolekcí ze zdroje do cílové databáze Azure DocumentDB. Průvodce pro vytvoření úlohy migrace má šest kroků.

Krok 1: Vytvoření úlohy

V tomto kroku zadáte základní podrobnosti pro úlohu.

• Název úlohy: Zadejte popisný název pro identifikaci úlohy migrace.

• Režim migrace: Vyberte režim migrace, který je nejvhodnější pro váš případ použití.

  • Online migrace kopíruje sběrná data a zajišťuje replikaci aktualizací během procesu. Tato metoda je výhodná s minimálními výpadky, což umožňuje nepřetržitý provoz pro provozní kontinuitu. Tuto možnost použijte, pokud jsou probíhající operace zásadní a snížení výpadků je prioritou.
  • Offline migrace zachytává snímek databáze na začátku a nabízí jednodušší a předvídatelný přístup. Funguje dobře, když používáte statickou kopii databáze, je přijatelná a aktualizace v reálném čase nejsou nezbytné.

  Důležité

  Aby se zajistilo úspěšné online migrace z MongoDB, musí být na zdrojovém serveru MongoDB povolená možnost ChangeStream. Bez changeStreamu se nezachytí žádné změny dat po počáteční migraci. Režim online migrace proto používejte pouze v případě, že je na zdrojovém serveru MongoDB povolená možnost ChangeStream.

• Možnosti připojení: V závislosti na mandátu vaší organizace k zabezpečení a nastavení sítě zvolte možnost Veřejná a soukromá.

  • Použijte veřejný , pokud jsou zdrojové a cílové servery přístupné přes internet prostřednictvím veřejných IP adres. Umožňuje podporu služeb, které vyžadují externí přístupnost.
  • Privátní použijte, pokud jsou zdrojové nebo cílové servery přístupné výhradně prostřednictvím privátních IP adres ve virtuální síti. Zvyšuje zabezpečení tím, že eliminuje vystavení veřejnému internetu.

Pokračujte výběrem tlačítka Další.

Krok 2: Výběr cíle

V tomto kroku vyberete existující účet Azure DocumentDB a zadáte jeho připojovací řetězec.

1. Ve výběrovém seznamu vyberte předplatné, skupinu prostředků a účet Azure DocumentDB.

2. Zadejte připojovací řetězec k účtu Azure DocumentDB.

3. Zkontrolujte, zda je IP adresa uvedená na obrazovce povolená na firewallu Azure DocumentDB.

4. Pokračujte výběrem tlačítka Další.

Krok 3: Výběr služby Database Migration Service (DMS)

Azure Database Migration Service je služba, která migruje data do datových platforem Azure a z datových platforem Azure pomocí cloudové infrastruktury pro přenos dat, a ne spoléhá na místní prostředky. V rozevíracím seznamu zvolte existující instanci služby Azure Database Migration Service nebo vyberte Vytvořit DMS a vytvořte novou službu migrace.

Důležité

Ujistěte se, že je ve vašem předplatném zaregistrovaný poskytovatel prostředků Microsoft.DataMigration. Stačí to udělat jenom jednou pro každé předplatné.

Pokračujte výběrem tlačítka Další.

Krok 4: Konfigurace připojení

Tato obrazovka závisí na režimu připojení, který jste zvolili v kroku 1.

Veřejné připojení

Ve veřejném připojení se úloha migrace připojí ke zdroji a cíli pomocí veřejného internetu. Abyste umožnili komunikaci, musíte aktualizovat zdrojový a cílový firewall. Pokud chcete povolit komunikaci ze serverů DMS, přidejte IP adresy uvedené na obrazovce do zdrojových a cílových firewallů. Další informace najdete v tématu Konfigurace brány firewall clusteru Azure DocumentDB .

Privátní připojení

V privátním připojení se úloha migrace spouští v rámci své virtuální sítě. K bezpečné komunikaci s vaší virtuální sítí používáme propojování virtuálních sítí.

1. Vyberte předplatné, skupinu prostředků a virtuální síť z rozevíracích seznamů.

2. Spuštěním skriptu PowerShellu na obrazovce povolte integraci virtuální sítě.

3. Pokračujte výběrem tlačítka Další.

Krok 5: Výběr kolekcí

V tomto kroku vyberete kolekce, které se mají zahrnout do migračního úkolu. Vyberte ze seznamu kolekcí pomocí nabízených možností hledání. Kolekce, které již v cíli existují, jsou automaticky označeny ano ve sloupci Existuje v cíli .

Návod

Nezapomeňte vybrat všechny kolekce, které chcete zahrnout, protože po vytvoření úlohy migrace není možné přidat seznam kolekcí.

Pokračujte výběrem tlačítka Další.

Krok 6: Potvrzení a spuštění

Před výběrem Zahájit migraci zkontrolujte podrobnosti migrace. Pokud je potřeba aktualizovat podrobnosti, použijte tlačítko Upravit podrobnosti .

Po úspěšném vytvoření úlohy migrace budete automaticky přesměrováni na stránku Zobrazit existující úlohy .

Návod

Úlohy migrace dat se spouštějí ve službě Azure Database Migration Service. Proto během migrace dat nemusíte být připojení ke zdrojovému a cílovému prostředí. Stav se na řídicím panelu aktualizuje v častých intervalech.

Monitorování existujících úloh migrace

Pomocí karty Zobrazit existující úlohy můžete monitorovat stav migrace inicializovaných úloh. Úlohy jsou uvedené na základě vybraného DMS. Ke změně výběru použijte tlačítko Změnit DMS .

Stav se automaticky aktualizuje v častých intervalech. Offline úlohy se automaticky dokončí, jakmile se vybrané snímky kolekce zkopírují do cíle. Online migrace však musí být provedeny ručně.

Pokud chcete zobrazit stav kolekce, vyberte řádek z tabulky.

Monitorování online migrací

Online migrace, na rozdíl od offline migrací, se automaticky nedokončí. Místo toho běží nepřetržitě, dokud nejsou manuálně ukončeny výběrem Cutover.

Pokud chcete online migraci dokončit, postupujte podle těchto kroků v daném pořadí:

1. Tlačítko Cutover se povolí, jakmile je dokončeno počáteční načítání dat pro všechny kolekce. V této fázi je úloha ve fázi replikace a průběžně kopíruje aktualizace ze zdrojové instance do cílové instance, aby se zachovala aktuálnost s nejnovějšími změnami.

2. Až budete připraveni provést přímou migraci, zastavte všechny příchozí transakce do migrovaných zdrojových kolekcí.

3. Mezera Replikace je zobrazena jako časová mezera mezi poslední aktualizací a aktuálním časem.

4. Monitorujte změny replikace v tabulce a počkejte, až se metrika Počet přehrání změn replikace stabilizuje. Stabilní metrika Změny replikace byly provedeny znamená, že všechny aktualizace ze zdroje se úspěšně zkopírují do cíle.

5. Vyberte Cutover, když je rozdíl replikace minimální pro všechny kolekce a metrika změny replikace jsou přehrány je stabilní.

6. Ručně ověřte, že počet řádků je stejný mezi zdrojovými a cílovými kolekcemi.

Poznámka:

Provedení operace přepnutí bez ověření, že zdroj a cíl jsou synchronizovány, může vést ke ztrátě dat.

Zaregistrujte poskytovatele prostředků Microsoft.DataMigration ve vašem předplatném.

Pokud chcete zajistit, aby byl poskytovatel prostředků Microsoft.DataMigration ve vašem předplatném zaregistrovaný, můžete postupovat takto:

Azure Portal

1. Přejděte na web Azure Portal a přejděte do svého předplatného.

2. V nabídce vlevo vyberte v části Nastaveníposkytovatele prostředků.

3. Vyhledejte Microsoft.DataMigration ve vyhledávacím poli v horní části.

4. Pokud není zaregistrovaný, vyberte ho a vyberte tlačítko Zaregistrovat .

Azure CLI (příkazový řádek nástroje Azure)

1. Otevřete Azure Cloud Shell nebo místní terminál.

2. Spuštěním následujícího příkazu zaregistrujte poskytovatele prostředků:

   az provider register --namespace Microsoft.DataMigration
   

PowerShell

1. Otevřete Azure Cloud Shell nebo místní PowerShell.

2. Spuštěním následujícího příkazu zaregistrujte poskytovatele prostředků:

   Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"
   

časté otázky

Proč v kroku výběru kolekce chybí zobrazení, když Azure DocumentDB podporuje zobrazení?

Azure DocumentDB podporuje vytváření nových zobrazení. Rozšíření migrace ale neposkytuje podporu pro migraci existujících zobrazení.

Po dokončení migrace můžete zobrazení kdykoli znovu vytvořit.

Které kolekce a databáze se při migraci z MongoDB do Azure DocumentDB přeskočí?

Následující databáze a kolekce jsou považovány za interní pro MongoDB:

Kategorie	Description
Databáze	admin, lokální, nastavení systému
kolekce	Libovolná kolekce s předponou system.

Spouští se úlohy migrace místně na mém počítači?

Databáze a kolekce jsou uvedeny přímo v uživatelském rozhraní průvodce pomocí příkazů spouštěných z místního klienta VS Code. Tato funkce vyžaduje síťové připojení mezi počítačem se systémem VS Code a zdrojovým i cílovým prostředím.

Úlohy migrace dat provádí služba Azure Database Migration Service (DMS). DMS je služba hostovaná v Azure, která orchestruje a spravuje aktivity přesunu dat. Po vytvoření úloh migrace už nemusíte udržovat připojení ke zdrojovému a cílovému prostředí.

Můžu během migrace přejmenovat databáze a kolekce?

Rozšíření nepodporuje přejmenování databáze a kolekce během migrace.

Jak mám nakonfigurovat brány firewall zdrojového serveru, aby nedocházelo k problémům s připojením?

Požadovaná konfigurace sítě závisí na vybraném režimu připojení:

• Veřejný režim: Musíte povolit IP adresy zobrazené v průvodci na obou zdrojových i cílových firewallech, aby byla umožněna komunikace.
• Privátní režim: Musíte povolit integraci virtuální sítě , aby servery DMS mohly bezpečně komunikovat se zdrojovými a cílovými koncovými body v rámci virtuální sítě.

Také se odkazujte na VS Code connectivity.

Kolik databází a kolekcí můžu migrovat v rámci jedné migrace?

Do jedné migrace můžete zahrnout až 25 kolekcí . Pro migraci dalších kolekcí ale můžete vytvořit a spustit několik úloh migrace .

Kolik úloh migrace můžu spustit současně?

Při použití veřejného přístupu můžete spustit více úloh migrace. Při použití privátního přístupu však může jedna virtuální síť podporovat současně pouze jednu aktivní úlohu. Pokud chcete spouštět více úloh s privátním přístupem, musíte pro každou úlohu použít jinou virtuální síť .

Jaký typ protokolů rozšíření generuje?

Rozšíření zaznamenává chyby, upozornění a další diagnostické protokoly ve výchozím adresáři protokolů:

• Windows - C:\Users\<username>\.dmamongo\logs\
• Linux - ~/.dmamongo/logs
• macOS - /Users/<username>/.dmamongo/logs

Další kroky

Vytvoření webové aplikace Node.js