kurz: migrace MongoDB do rozhraní API služby Azure Cosmos DB pro MongoDB online pomocí DMS

PLATÍ pro: Azure Cosmos DB API pro MongoDB

Důležité

Než se pustíte do kroků migrace, přečtěte si prosím celý průvodce.

Tato příručka k migraci MongoDB je součástí série při migraci MongoDB. Důležité kroky migrace MongoDB jsou před migrací, migrací a po migraci, jak vidíte níže.

Diagram kroků migrace

přehled migrace online dat z MongoDB na Azure Cosmos DB pomocí DMS

Azure Database Migration Service můžete použít k provedení online (minimálního výpadku) migrace databází z místní nebo cloudové instance MongoDB do Azure Cosmos DB API pro MongoDB.

v tomto kurzu se dozvíte o krocích spojených s používáním Azure Database Migration Service k migraci dat MongoDB do Azure Cosmos DB:

  • Vytvořte instanci služby Azure Database Migration Service.
  • Vytvořte projekt migrace.
  • Zadejte zdroj.
  • Zadejte cíl.
  • Namapujte na cílové databáze.
  • Spuštění migrace
  • Monitorujte migraci.
  • ověřte data v Azure Cosmos DB.
  • Až budete připraveni, dokončete migraci.

v tomto kurzu migrujete datovou sadu v MongoDB hostovaném na virtuálním počítači Azure, abyste Azure Cosmos DB rozhraní API pro MongoDB s minimálními výpadky pomocí Azure Database Migration Service. pokud ještě nemáte nastavený zdroj MongoDB, přečtěte si článek instalace a konfigurace MongoDB na virtuálním počítači s Windows v Azure.

Poznámka

použití Azure Database Migration Service k provedení online migrace vyžaduje vytvoření instance založené na cenové úrovni Premium.

Důležité

Pro optimální prostředí migrace doporučuje Microsoft vytvořit instanci Azure Database Migration Service ve stejné oblasti Azure jako cílová databáze. Přesun dat mezi oblastmi nebo geografickými oblastmi může zpomalit proces migrace.

Tip

Pokud do Azure migrujete databáze pomocí služby Azure Database Migration Service, můžete provést offline nebo online migraci. V případě offline migrace dojde při spuštění migrace k výpadku aplikace. V případě online migrace je doba výpadku omezená na dobu přímé migrace na konci migrace. Doporučujeme otestovat offline migraci a určit, jestli je výpadek přijatelný. Pokud není, proveďte online migraci.

tento článek popisuje online migraci z MongoDB Azure Cosmos DB a rozhraní API pro MongoDB. offline migrace najdete v článku migrace MongoDB do Azure Cosmos DB rozhraní API pro MongoDB v režimu offline pomocí DMS.

Požadavky

Pro absolvování tohoto kurzu je potřeba provést následující:

  • Dokončete kroky před migrací , například odhad propustnosti, výběr klíče oddílu a zásady indexování.

  • vytvořte rozhraní API Azure Cosmos DB pro účet MongoDB a zajistěte, aby byl povolený server SSR (opakování na straně serveru) .

    Poznámka

    DMS se v současné době nepodporuje, pokud migrujete na rozhraní API pro účet MongoDB, který je zřízený v režimu bez serveru.

  • vytvořte Microsoft Azure Virtual Network pro Azure Database Migration Service pomocí modelu nasazení Azure Resource Manager, který zajišťuje připojení typu site-to-site k vašim místním zdrojovým serverům pomocí ExpressRoute nebo VPN.

    Poznámka

    Pokud při instalaci virtuální sítě používáte ExpressRoute s partnerským vztahem k síti Microsoftu, přidejte do podsítě, ve které se služba zřídí, tyto koncové body služby:

    • koncový bod cílové databáze (například SQL koncový bod, Cosmos DB koncový bod atd.)
    • Storage koncový bod
    • Koncový bod služby Service Bus

    Tato konfigurace je nezbytná, protože Azure Database Migration Service nemá připojení k Internetu.

  • Zajistěte, aby pravidla skupiny zabezpečení sítě (NSG) ve virtuální síti neblokovala následující komunikační porty: 53, 443, 445, 9354 a 10000-20000. Další podrobnosti o filtrování provozu NSG virtuální sítě najdete v článku filtrování provozu sítě pomocí skupin zabezpečení sítě.

  • otevřete bránu Windows firewall a umožněte Azure Database Migration Service přístup ke zdrojovému serveru MongoDB, který je ve výchozím nastavení port TCP 27017.

  • Pokud používáte zařízení brány firewall před zdrojovými databázemi, budete možná muset přidat pravidla firewallu, která Azure Database Migration Service umožní přístup ke zdrojovým databázím pro migraci.

konfigurace Azure Cosmos DBch opakování na straně serveru pro efektivní migraci

zákazníci, kteří migrují z Azure Cosmos DB MongoDB, přináší výhody funkcí zásad správného řízení prostředků, což zaručuje schopnost plně využít vaše zřízené zvýšení propustnosti/s. Azure Cosmos DB může v průběhu migrace omezit daný požadavek na službu migrace dat, pokud požadavek překročí zřízené požadavky na kontejner/s. pak se musí tento požadavek opakovat. služba migrace dat je schopná provádět opakované pokusy, ale čas odezvy v rámci směrování sítě mezi službou migrace dat a Azure Cosmos DB dopad na celkovou dobu odezvy tohoto požadavku. Zvýšení doby odezvy pro omezené požadavky může zkrátit celkovou dobu potřebnou k migraci. funkce opakování na straně serveru Azure Cosmos DB umožňuje službě zachytit kódy chyb omezení a opakovat s mnohem nižší dobou odezvy, což výrazně vylepšuje dobu odezvy na žádosti.

funkci opakování na straně serveru můžete najít v okně funkce portálu Azure Cosmos DB.

Snímek obrazovky funkce MongoDB Server-Side opakování

A pokud je zakázaný, doporučujeme ho povolit, jak vidíte níže.

Snímek obrazovky s MongoDB Server-Side zkuste znovu povolit.

Registrace poskytovatele prostředků Microsoft.DataMigration

  1. Přihlaste se k webu Azure Portal. Vyhledejte a vyberte odběry.

    Zobrazení předplatných na portálu

  2. Vyberte předplatné, ve kterém chcete vytvořit instanci Azure Database Migration Service a pak vyberte poskytovatelé prostředků.

    Zobrazení poskytovatelů prostředků

  3. Vyhledejte migraci a pak vyberte zaregistrovat pro migraci Microsoft. data.

    Registrace poskytovatele prostředků

Vytvoření instance

  1. Na webu Azure Portal vyberte + Vytvořit prostředek, vyhledejte „Azure Database Migration Service“ a pak v rozevíracím seznamu vyberte Azure Database Migration Service.

    Azure Marketplace

  2. Na obrazovce Azure Database Migration Service vyberte Vytvořit.

    Vytvoření instance služby Azure Database Migration Service

  3. Na obrazovce Vytvořit službu Migration Service zadejte název služby, předplatné a novou nebo existující skupinu prostředků.

  4. Vyberte umístění, ve kterém chcete vytvořit instanci Azure Database Migration Service.

  5. Vyberte existující virtuální síť nebo vytvořte novou.

    virtuální síť poskytuje Azure Database Migration Service s přístupem ke zdrojové instanci MongoDB a cílovému Azure Cosmos DBmu účtu.

    Další informace o tom, jak vytvořit virtuální síť v Azure Portal, najdete v článku vytvoření virtuální sítě pomocí Azure Portal.

  6. vyberte skladovou položku z Premium cenové úrovně.

    Poznámka

    Online migrace se podporují jenom v případě, že se používá Premium vrstva. Další informace o nákladech a cenových úrovních najdete na stránce s cenami.

    Konfigurace nastavení instance služby Azure Database Migration Service

  7. Vyberte Vytvořit a vytvořte službu.

Vytvoření projektu migrace

Po vytvoření služby ji vyhledejte na webu Azure Portal, otevřete ji a pak vytvořte nový projekt migrace.

  1. Na webu Azure Portal vyberte Všechny služby, vyhledejte „Azure Database Migration Service“ a pak vyberte Služby Azure Database Migration Service.

    Vyhledat všechny instance Azure Database Migration Service

  2. Na obrazovce služby Azure Database Migration Services vyhledejte název instance Azure Database Migration Service, kterou jste vytvořili, a pak vyberte instanci.

    Alternativně můžete zjistit instanci služby Azure Database Migration Service z podokna hledání v Azure Portal.

    Použití podokna hledání v Azure Portal

  3. Vyberte + Nový projekt migrace.

  4. Na obrazovce Nový projekt migrace zadejte název projektu, v textovém poli typ zdrojového serveru vyberte možnost MongoDB, v textovém poli typ CÍLOVÉHO serveru vyberte možnost CosmosDB (MongoDB API) a potom pro možnost zvolit typ aktivity vyberte možnost migrace online dat [Preview].

    Vytvořit Database Migration Service projekt

  5. Vyberte Uložit a potom vyberte vytvořit a spustit aktivitu a vytvořte tak projekt a spusťte aktivitu migrace.

Zadání podrobností o zdroji

  1. Na obrazovce Podrobnosti o zdroji zadejte podrobnosti o připojení pro zdrojový server MongoDB.

    Důležité

    Azure Database Migration Service nepodporuje Azure Cosmos DB jako zdroj.

    Existují tři režimy připojení ke zdroji:

    • Standardní režim, který přijímá plně kvalifikovaný název domény nebo IP adresu, číslo portu a přihlašovací údaje pro připojení.

    • Režim připojovacího řetězce, který přijímá připojovací řetězec MongoDB, jak je popsáno v článku Formát identifikátoru URI připojovacího řetězce.

    • Data ze služby Azure Storage, která přijímá adresu URL SAS kontejneru objektů BLOB. Pokud má kontejner objektů BLOB BSON výpisy paměti vytvořené nástrojem MongoDB bsondump, vyberte objekt blob, který obsahuje bson , a zrušte jeho výběr, pokud kontejner obsahuje soubory JSON.

      Pokud vyberete tuto možnost, ujistěte se, že se připojovací řetězec účtu úložiště zobrazuje ve formátu:

      https://blobnameurl/container?SASKEY
      

      v závislosti na informacích o výpisu typu v Azure Storage mějte na paměti následující podrobnosti.

      • V případě výpisů BSON musí být data v kontejneru objektů BLOB ve formátu bsondump, aby byly datové soubory umístěny do složek pojmenovaných po obsahujících databázích ve formátu Collection. bson. Soubory metadat (pokud existují) by měly být pojmenovány pomocí Format Collection. Metadata. JSON.

      • V případě výpisů JSON musí být soubory v kontejneru objektů BLOB umístěny do složek pojmenovaných po nadřazených databázích. V rámci každé složky databáze musí být datové soubory umístěny do podsložky s názvem "data" a pojmenovány pomocí formátu Collection. JSON. Soubory metadat (pokud existují) musí být umístěny do podsložky s názvem "metadata" a pojmenovány pomocí stejného formátu, Collection. JSON. Soubory metadat musí být ve stejném formátu, který vytvořil nástroj MongoDB bsondump Tool.

    Důležité

    Doporučuje se použít certifikát podepsaný svým držitelem na serveru Mongo. Pokud se ale používá, připojte se prosím k serveru pomocí režimu připojovacího řetězce a ujistěte se, že váš připojovací řetězec má "".

    &sslVerifyCertificate=false
    

    IP adresu můžete použít v situacích, kdy není možné překlad názvů DNS.

    Zadání podrobností o zdroji

  2. Vyberte Uložit.

    Poznámka

    Adresa zdrojového serveru musí být adresa primárního serveru, pokud je zdrojem sada repliky, a směrovač, pokud je zdrojem cluster horizontálně dělené MongoDB. Pro cluster horizontálně dělené MongoDB musí být Azure Database Migration Service schopný připojit se k jednotlivým horizontálních oddílů v clusteru, což může vyžadovat otevření brány firewall na dalších počítačích.

Zadání podrobností o cíli

  1. na obrazovce podrobnosti cíle migrace zadejte podrobnosti o připojení pro cílový Azure Cosmos DB účet, což je předběžně zřízené rozhraní API služby Azure Cosmos DB pro účet MongoDB, na který migrujete data MongoDB.

    Zadání podrobností o cíli

  2. Vyberte Uložit.

Mapování na cílové databáze

  1. Na obrazovce mapování na cílové databáze namapujte zdrojovou a cílovou databázi pro migraci.

    Pokud cílová databáze obsahuje stejný název databáze jako zdrojová databáze, Azure Database Migration Service ve výchozím nastavení vybere cílovou databázi.

    Pokud se řetězec vytvoří vedle názvu databáze, indikuje, že Azure Database Migration Service nebyla nalezena cílová databáze a služba vytvoří databázi za vás.

    Pokud chcete v této fázi migrace sdílet propustnost v databázi, zadejte propustnost RU. v Cosmos DB můžete zřídit propustnost buď na úrovni databáze, nebo jednotlivě pro každou kolekci. Propustnost se měří v jednotkách žádosti (ru). přečtěte si další informace o cenách Azure Cosmos DB.

    Mapování na cílové databáze

  2. Vyberte Uložit.

  3. Na obrazovce nastavení kolekce rozbalte seznam kolekce a potom zkontrolujte seznam kolekcí, které budou migrovány.

    Azure Database Migration Service automaticky vybere všechny kolekce, které existují ve zdrojové instanci MongoDB, které neexistují na cílovém Azure Cosmos DB účtu. Pokud chcete znovu migrovat kolekce, které už obsahují data, musíte na této obrazovce explicitně vybrat kolekce.

    Můžete zadat počet ru, které mají kolekce používat. Ve většině případů by měla stačit hodnota mezi 500 (1000 minimum pro kolekce horizontálně dělené) a 4000. Azure Database Migration Service navrhuje inteligentní výchozí hodnoty na základě velikosti kolekce.

    Poznámka

    Migraci a shromažďování databáze můžete provádět paralelně pomocí několika instancí Azure Database Migration Service v případě potřeby zrychlit spuštění.

    můžete také zadat horizontálních oddílů klíč, který bude využívat dělení v Azure Cosmos DB pro zajištění optimální škálovatelnosti. Nezapomeňte si projít osvědčené postupy pro výběr klíče horizontálních oddílů/partition. Pokud nemáte klíč oddílu, můžete pro lepší propustnost vždy použít _ID jako klíč horizontálních oddílů.

    Vybrat tabulky kolekcí

  4. Vyberte Uložit.

  5. Na obrazovce Shrnutí migrace do textového pole Název aktivity zadejte název aktivity migrace.

    Souhrn migrace

Spuštění migrace

  • Vyberte Spustit migraci.

    Zobrazí se okno aktivita migrace a zobrazí se stav aktivity.

    Stav aktivity

Monitorování migrace

  • Na obrazovce aktivita migrace vyberte aktualizovat , aby se zobrazení aktualizovalo, dokud se stav migrace nezobrazuje jako opakované přehrání.

    Poznámka

    Můžete vybrat aktivitu pro získání podrobností o metrikách migrace na úrovni databáze a kolekce.

    Opětovné přehrání stavu aktivity

ověřit data v Cosmos DB

  1. Proveďte změny ve zdrojové databázi MongoDB.

  2. Připojení ke službě COSMOS DB a ověřte, jestli se data replikují ze zdrojového serveru MongoDB.

    Snímek obrazovky, který ukazuje, kde můžete ověřit, že se data replikují.

Dokončete migraci

  • Až budou všechny dokumenty ze zdroje dostupné v cíli služby COSMOS DB, v místní nabídce aktivity migrace vyberte Dokončit a dokončete migraci.

    Tato akce dokončí přehrávání všech nedokončených změn a dokončí migraci.

    Snímek obrazovky zobrazující možnost nabídky dokončit

Optimalizace po migraci

po migraci dat uložených v databázi MongoDB Azure Cosmos DB k rozhraní API pro MongoDB se můžete připojit k Azure Cosmos DB a spravovat data. můžete také provést další kroky optimalizace po migraci, jako je například optimalizace zásad indexování, aktualizace výchozí úrovně konzistence nebo konfigurace globální distribuce pro účet Azure Cosmos DB. Další informace najdete v článku věnovaném optimalizaci po migraci .

Další zdroje informací

Další kroky