Rozšíření migrace azure Cosmos DB pro MongoDB pro Azure Data Studio (Preview)

Rozšíření migrace Azure Cosmos DB pro MongoDB vám pomůže při migraci úloh MongoDB do služby Azure Cosmos DB. Toto rozšíření můžete použít k:

  • Spusťte komplexní posouzení úloh a zjistěte potřebné akce, které je potřeba provést při migraci úloh do služby Azure Cosmos DB založené na virtuálních jádrech pro MongoDB.
  • Proveďte operaci migrace s vybranými databázemi a kolekcemi do služby Azure Cosmos DB založené na virtuálních jádrech pro MongoDB.

Důležité

V současné době toto rozšíření nepodporuje následující scénáře:

  • Migrace, kde je povolený zdrojový nebo cílový účet, je povolený privátní koncový bod.
  • Online/offline migrace pro Azure Cosmos DB založené na RU pro MongoDB

Další informace o alternativních řešeních pro virtuální jádro rozhraní API pro MongoDB najdete v tématu Možnosti migrace.

Požadavky

  • Existující účet služby Azure Cosmos DB pro MongoDB založený na virtuálních jádrech.
  • Nejnovější verze nástroje Azure Data Studio
  • MongoDB s verzí 3.2 nebo vyšší.
  • Přidejte výjimky brány firewall do zdrojového účtu MongoDB a cílového účtu služby Azure Cosmos DB pro MongoDB založeného na virtuálních jádrech pro příjem připojení z globálních datacenter Azure.
  • Pokud službu Database Migration Service používáte poprvé, ujistěte se, že je ve vašem předplatném zaregistrovaný poskytovatel prostředků Microsoft.DataMigration.

Příprava

Před zahájením migrace proveďte předběžné plánování a rozhodování o migraci před tím, než skutečně přesunete data.

Registrace 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 klikněte na tlačítko Zaregistrovat.

Azure CLI:

  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"

Instalace rozšíření

Než začnete s migrací, nainstalujte rozšíření migrace Azure Cosmos DB for MongoDB do nástroje Azure Data Studio.

  1. Otevřete správce rozšíření v Nástroji Azure Data Studio. Buď vyberte ikonu rozšíření, nebo v nabídce Zobrazit vyberte Rozšíření .

  2. Do vyhledávacího panelu zadejte Cosmos.

  3. Vyberte rozšíření Migrace služby Azure Cosmos DB pro MongoDB a zobrazte jeho podrobnosti.

    Snímek obrazovky s tlačítkem instalace rozšíření migrace Azure Cosmos DB pro MongoDB

  4. Vyberte volbu Instalovat.

Konfigurace nastavení rozšíření

Po instalaci rozšíření můžete nakonfigurovat některá nastavení rozšíření. Tento krok je nepovinný. Pokud nejsou explicitně nakonfigurovaná žádná nastavení, použije rozšíření výchozí nastavení.

  1. Přejděte na rozšíření a vyberte Azure Cosmos DB Migration for MongoDB, vyberte ikonu spravovat nastavení a pak vyberte nastavení rozšíření.

    Snímek obrazovky s výběrem nastavení rozšíření

  2. V části Nastavení rozšíření pro toto rozšíření zadejte Assessment path umístění, kde jsou uložena metadata posouzení. Pokud necháte prázdné, použije se výchozí umístění.

Připojení ke zdroji MongoDB

K prvnímu připojení k existující zdrojové instanci MongoDB použijte rozšíření. Před zahájením této části se ujistěte, že máte přihlašovací údaje pro připojení ke zdroji připravené.

  1. Na řádku nabídek vyhledejte ikonu připojení a vyberte Nové připojení.

    Snímek obrazovky s řádkem nabídek připojení v rozšíření

  2. V podokně Připojení vyplňte následující pole:

    Hodnota
    Typ připojení: Azure Cosmos DB for MongoDB
    Připojovací řetězec nebo parametry Použijte připojovací řetězec nebo parametry pro existující zdrojová instance MongoDB.
    Skupina serverů Default
    Název (nepovinný) Zadejte jedinečný název tohoto připojení.
  3. Vyberte Připojit.

  4. Otevřete místní nabídku nového připojení v podokně Připojení. Pak vyberte Spravovat.

    Snímek obrazovky Spravovat databázi

  5. Vyberte migraci služby Azure Cosmos DB.

    Snímek obrazovky databáze Posouzení migrace

Spuštění posouzení

Posouzení prozkoumá vaše aktuální datové aktiva a využití MongoDB. Funkce posouzení pak vygeneruje komplexní sestavu, která vám pomůže identifikovat potřebné akce, které je potřeba provést před migrací úloh do Azure Cosmos DB for MongoDB.

  1. Vyhledejte a přejděte na kartu Řídicí panel . Pak vyberte Posoudit a migrovat databáze.

    Snímek obrazovky s kartou Řídicí panel v rámci funkce migrace rozšíření

  2. Dokončete průvodce a uveďte podrobnosti rozšíření, aby bylo možné provést posouzení.

    Snímek obrazovky s podrobnostmi posouzení před ověřením přihlašovacích údajů

    1. Do pole Název posouzení zadejte název.

    2. V rozevíracím seznamu Nabídky vyberte cílový účet Služby Azure Cosmos DB pro MongoDB.

    3. Zadejte cestu k protokolům MongoDB.

      Tip

      Toto pole je volitelné, ale zadání cesty k protokolům vede k podrobnějším zjištěním na úrovni kolekce. Pokud není zadaná složka protokolu, nástroj k posouzení použije podrobnosti z serverStatus příkazu.

      Příkaz serverStatus vrátí využití funkcí pouze od posledního restartování, takže byste měli zajistit, aby od posledního restartování serveru uplynula dostatečná doba, abyste získali posouzení, které přesně odpovídá vaší skutečné úloze.

    4. Zadejte cestu k protokolům hodnocení dat.

      Tip

      I když je toto pole volitelné, poskytnutí protokolů hodnocení dat může přinést podrobnější přehledy o úloze. Tyto protokoly se získávají skenováním dat a čtením podrobných protokolů. Posouzení dat běží nezávisle jako rozhraní příkazového řádku před zahájením posouzení migrace a výsledný kód JSON se pak zadá sem. Tady si stáhněte rozhraní příkazového řádku pro posouzení dat.

    5. Výběrem možnosti Spustit ověření ověřte vstupy posouzení.

  3. Po úspěšném ověření vyberte Spustit posouzení a spusťte posouzení.

    Snímek obrazovky s podrobnostmi posouzení po ověření přihlašovacích údajů

  4. V závislosti na velikosti zdrojového serveru trvá posouzení několik minut. Než budete pokračovat, počkejte na dokončení posouzení.

    Snímek obrazovky s probíhajícím novým posouzením

  5. Po dokončení posouzení byste teď měli mít sestavu posouzení.

    Snímek obrazovky s novou sestavou posouzení zdrojové instance MongoDB

  6. V sestavě posouzení vyberte název instance a zkontrolujte seznam problémů v rámci celého serveru. Výběrem konkrétní databáze zobrazíte problémy, které se vztahují pouze na vybranou databázi.

    Snímek obrazovky s novou sestavou posouzení pro vybranou databázi ve zdrojové instanci MongoDB

  7. Výběrem možnosti Stáhnout sestavu získáte konsolidovanou sestavu ke stažení.

  8. Projděte si sestavu posouzení a identifikujte všechny akce, které potřebujete k bezproblémové migraci úloh ve službě Azure Cosmos DB pro MongoDB. Než přejdete k dalšímu kroku, ujistěte se, že se zpracovávají všechny blokující problémy hlášené v posouzení. Pokud dojde k nějakým nevyřešeným problémům, můžete proces ukončit a zpracovat později. Jakmile se problémy vyřeší, můžete se vrátit a restartovat proces posouzení a migrace.

Provedení migrace

Teď pomocí sestavy posouzení proveďte migraci dat ze zdrojové instance MongoDB do cílového účtu služby Azure Cosmos DB pro MongoDB založeného na virtuálních jádrech.

  1. Na obrazovce sestavy posouzení vyberte všechny databáze, které chcete migrovat. Pak vyberte Další.

    Snímek obrazovky s databází vybranou pro migraci

  2. Zpřesněním seznamů vyberte cílový účet Služby Azure Cosmos DB pro MongoDB filtrováním podle předplatného a skupiny prostředků. Pak zadejte přihlašovací údaje pro připojení potřebné k připojení k účtu.

    Snímek obrazovky s výběrem cílového účtu Služby Azure Cosmos DB pro MongoDB

  3. Výběrem možnosti Test připojení ověřte přihlašovací údaje pro účet Azure Cosmos DB pro MongoDB. Výběrem možnosti Další přejdete na mapování kolekcí ze zdroje na cíl.

  4. V seznamu mapování zvolte Možnost Přeskočit nebo Migrovat pro každou kolekci. Kolekce, které už v cíli existují, se automaticky označí ikonou a ve výchozím nastavení se nastaví na Přeskočit . Výběrem možnosti Další nakonfigurujte službu Azure Database Migration Service (DMS).

    Snímek obrazovky s mapováním kolekcí ze zdroje na cíl

    Upozorňující

    Když se rozhodnete migrovat existující kolekci, přepíše se celá kolekce, což vede k nenapravitelné ztrátě dat. Při výběru této možnosti buďte opatrní.

  5. V rozevíracím seznamu zvolte existující instanci služby Azure Database Migration Service nebo vyberte Vytvořit nový a vytvořte novou službu migrace. 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.

    Snímek obrazovky s možností zvolit službu migrace

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

    • Online migrace kopíruje data shromažďování dat a zajišťuje také 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é.
  7. Výběrem možnosti Další zobrazíte souhrn migrace. Po kontrole a potvrzení podrobností vyberte Vytvořit schéma a vytvořte prostředky v cílovém účtu.

    Snímek obrazovky s možností zobrazit souhrn migrace

  8. Výběrem možnosti Spustit migraci zahájíte přenos dat pomocí vybrané služby migrace.

    Snímek obrazovky s možností spustit migraci pomocí služby migrace

  9. V místní nabídce Potvrdit nastavení ověřte, že nastavení brány firewall splňuje požadavky. Potvrďte tlačítkem OK.

    Snímek obrazovky s automaticky otevíraného okna Potvrdit nastavení a ověřením nastavení brány firewall

Úlohy migrace dat se spouští ve službě Azure Database Migration Service, takže 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.

Poznámka:

Pokud jste pro migraci vybrali více než 50 kolekcí, úloha migrace bude dávková do více úloh ve službě migrace, z nichž každý obsahuje maximálně 50 kolekcí.

  1. Po inicializaci úloh monitorujte stav migrace na stránce řídicího panelu.

    Snímek obrazovky řídicího panelu se stavem migrace

  2. Pokud chcete zobrazit další podrobnosti, vyberte konkrétní migraci ze seznamu migrací.

Monitorování offline migrací

Po dokončení všech úloh migrace dat se stav automaticky aktualizuje.

Snímek obrazovky kolekcí se stavem migrace

Jakmile se data úspěšně zkopírují ze zdroje do cíle, stav offline migrací značí úspěch.

Snímek obrazovky s úspěšným stavem migrace

  • Změňte připojovací řetězec v aplikacích tak, aby odkazovat na cílový účet.

Monitorování online migrací

Online migrace, na rozdíl od offline migrací, se automaticky nedokončí. Místo toho běží nepřetržitě, dokud nebudou ručně finalizovány výběrem možnosti Přímá migrace.

Snímek obrazovky se stavem online migrace

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

  1. Tlačítko Přímé migrace se povolí po dokončení počátečního načtení dat pro všechny kolekce. Migrace je aktuálně ve fázi replikace a průběžně kopíruje aktualizace ze zdrojové instance do cílové instance, aby byla aktuální 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. Monitorujte změny replikace v tabulce a počkejte, až se metrika Změny replikace přehrávala. Stabilní metrika Změny replikace přehrávala značí, že všechny aktualizace ze zdroje se úspěšně zkopírují do cíle.

  4. Výběr přímé migrace , pokud je mezera replikace minimální pro všechny kolekce a metrika Změny replikace přehrávala je stabilní.

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

  6. V automaticky otevíraných dialogech Vyberte Dokončit přímou migraci.
    Snímek obrazovky s místní možností přímé migrace online

    Poznámka:

    Provedení přímé operace bez ověření synchronizace zdroje a cíle může vést ke ztrátě dat.

  7. Počkejte, až se stav změní na Úspěch.

  8. Aktualizujte připojovací řetězec v aplikacích tak, aby odkazovat na cílový účet.

Zobrazení předchozích migrací a posouzení

Často je užitečné zkontrolovat předchozí posouzení a migrace. Toto rozšíření poskytuje rozhraní pro kontrolu souhrnů minulých posouzení a migrací. Rozšíření také poskytuje možnost kontrolovat podrobné historické sestavy posouzení.

  1. Pokud chcete zobrazit předchozí migrace, vyberte na panelu nástrojů kartu Migrace . Seznam migrací obsahuje všechny migrace, které byly inicializovány na aktuálním počítači. Pokud chcete získat další podrobnosti, můžete vybrat konkrétní migraci v seznamu.

    Snímek obrazovky se seznamem všech migrací vytvořených pomocí rozšíření

  2. Pokud chcete zobrazit předchozí posouzení, vyberte na panelu nástrojů kartu Posouzení . Seznam posouzení obsahuje všechna posouzení, která byla zahájena na aktuálním počítači.

    Snímek obrazovky se seznamem všech posouzení provedených pomocí rozšíření

Další krok