Kurz: Offline migrace MongoDB do rozhraní API služby Azure Cosmos DB pro MongoDB

PLATÍ pro: Azure Cosmos DB API pro MongoDB

Důležité

Než provedete kroky migrace, přečtěte si prosím celý tento průvodce.

Tento průvodce migrací MongoDB je součástí série o migraci MongoDB. Důležitými kroky migrace MongoDB jsou před migrací,migrací a po migraci,jak je znázorněno níže.

Diagram kroků migrace

Přehled offline migrace dat z MongoDB do Azure Cosmos DB pomocí DMS

Použijte Azure Database Migration Service k provedení offline jednorázové migrace databází z místní nebo cloudové instance MongoDB do rozhraní API služby Azure Cosmos DB pro MongoDB.

V tomto kurzu se naučíte:

  • Vytvořte instanci služby Azure Database Migration Service.
  • Vytvořte projekt migrace pomocí Azure Database Migration Service.
  • Spuštění migrace
  • Monitorujte migraci.

V tomto kurzu budete migrovat datovou sadu v MongoDB hostovanou na virtuálním počítači Azure. Pomocí Azure Database Migration Service migrujete datovou sadu do rozhraní API služby Azure Cosmos DB pro MongoDB. Pokud ještě nemáte nastavený zdroj MongoDB, najdete informace v tématu Instalace a konfigurace MongoDB na virtuálním počítači Windows Azure.

Požadavky

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

  • Proveďte kroky před migrací, například odhad propustnosti a výběr klíče oddílu.

  • Vytvořte účet pro rozhraní API služby Azure Cosmos DB pro MongoDB.

    Poznámka

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

  • Vytvořte Microsoft Azure Virtual Network pro Azure Database Migration Service pomocí Azure Resource Manager. Tento model nasazení poskytuje připojení typu site-to-site k místním zdrojovým serverům pomocí Azure ExpressRoute nebo VPN. Další informace o vytvoření virtuální sítě najdete v dokumentaci k Azure Virtual Network, zejména v článcích s podrobnými podrobnostmi o rychlém startu.

    Poznámka

    Pokud při nastavování virtuální sítě používáte ExpressRoute s partnerským vztahem sítě s Microsoftem, přidejte následující koncové body služby do podsítě, ve které bude služba zřízená:

    • Cílový koncový bod databáze (například koncový SQL nebo koncový bod azure Cosmos DB)
    • Storage koncový bod
    • Koncový bod služby Service Bus

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

  • Ujistěte se, že pravidla skupiny zabezpečení sítě (NSG) pro vaši virtuální síť neblokují následující komunikační porty: 53, 443, 445, 9354 a 10000–20000. Další informace viz Filtrování provozu sítě s použitím skupin zabezpečení sít.

  • Otevřete bránu firewall Windows, aby Azure Database Migration Service přístup ke zdrojovému serveru MongoDB, což je ve výchozím nastavení port TCP 27017.

  • Pokud před zdrojovou databází používáte zařízení brány firewall, možná budete muset přidat pravidla brány firewall, Azure Database Migration Service přístup ke zdrojové databázi pro migraci.

Konfigurace funkce Opakování na straně serveru

Pokud migrujete z MongoDB do Azure Cosmos DB, můžete využít možnosti zásad správného řízení prostředků. Díky těmto možnostem můžete plně využít zřízené jednotky žádostí (RU/s) propustnosti. Azure Cosmos DB může během Database Migration Service o omezení konkrétního požadavku na správu, pokud tento požadavek překročí počet RU/s zřízený kontejnerem. Pak je potřeba tento požadavek zopakovat.

Database Migration Service dokáže provádět opakování. Je důležité si uvědomit, že doba odezvy, která je součástí segmentu směrování sítě mezi Database Migration Service a Azure Cosmos DB, ovlivňuje celkovou dobu odezvy tohoto požadavku. Zlepšení doby odezvy pro omezování požadavků může zkrátit celkovou dobu potřebnou k migraci.

Funkce Opakování na straně serveru služby Azure Cosmos DB umožňuje službě zachytit kódy chyb omezování a opakovat pokus s mnohem nižší dobu odezvy, což výrazně zlepšuje dobu odezvy na požadavky.

Pokud chcete použít opakování na straně serveru, na portálu Azure Cosmos DB vyberte > Funkce. Zkuste to znovu na straně serveru.

Snímek obrazovky, který ukazuje, kde najít funkci Opakování na straně serveru

Pokud je tato funkce zakázaná, vyberte Povolit.

Snímek obrazovky, který ukazuje, jak povolit opakování na straně serveru

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.

    Snímek obrazovky znázorňuje Azure Marketplace

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

    Snímek obrazovky, který znázorňuje, jak vytvořit instanci Azure Database Migration Service

  3. V okně 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 přístup ke zdrojové instanci MongoDB a cílovému účtu Azure Cosmos DB.

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

  6. Vyberte cenovou úroveň.

    Další informace o nákladech a cenových úrovních najdete na stránce s cenami.

    Snímek obrazovky znázorňuje nastavení konfigurace pro instanci Azure Database Migration Service

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

Vytvoření projektu migrace

Po vytvoření služby ji vyhledejte v Azure Portal a otevřete ji. 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.

    Snímek obrazovky, který ukazuje, jak vyhledat všechny instance Azure Database Migration Service

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

  3. Vyberte + New Migration Project.

  4. V části Nový projekt migrace zadejte název projektu a do textového pole Typ zdrojového serveru vyberte MongoDB. V textovém poli Typ cílového serveru vyberte CosmosDB (MongoDB API) a pak v části Zvolte typ aktivity vyberte Offline migrace dat.

    Snímek obrazovky znázorňuje možnosti projektu

  5. Vyberte Vytvořit a spustit aktivitu a vytvořte projekt a spusťte aktivitu migrace.

Zadání podrobností o zdroji

  1. Na obrazovce Podrobnosti o zdroji zadejte podrobnosti o připojení ke zdrojovému serveru 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ímají adresu URL SAS kontejneru objektů blob. Select Blob contains BSON dumps if the blob container has BSON dumps produced by the MongoDB bsondump tool. Tuto možnost nevyberte, pokud kontejner obsahuje soubory JSON.

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

      https://blobnameurl/container?SASKEY
      

      Tento připojovací řetězec SAS kontejneru objektů blob najdete v Azure Storage Exploreru. Vytvoření SAS pro dotyčný kontejner vám poskytne adresu URL v požadovaném formátu.

      Na základě informací o výpisu typu v Azure Storage mějte na paměti následující:

      • Pro výpisy BSON musí být data v kontejneru objektů blob ve formátu bsondump. Umístěte datové soubory do složek pojmenovaných podle obsahujících databází ve formátu collection.bson. Všechny soubory metadat pojmete ve formátu collection.metadata.json.

      • Pro výpisy JSON musí být soubory v kontejneru objektů blob umístěny do složek pojmenovaných podle obsahujících databází. V každé složce databáze musí být datové soubory umístěné v podsložce s názvem data a pojmenované ve formátu collection.json. Všechny soubory metadat umístěte do podsložky s názvem metadata a s názvem ve stejném formátu jako collection.json. Soubory metadat musí být ve stejném formátu jako nástroj bsondump MongoDB.

    Důležité

    Nedoporučujeme používat certifikát podepsaný svým držitelem na serveru MongoDB. Pokud ho musíte použít, připojte se k serveru pomocí režimu připojovacího řetězce a ujistěte se, že připojovací řetězec obsahuje uvozovky ("").

    &sslVerifyCertificate=false
    

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

    Snímek obrazovky znázorňující zadání podrobností o zdroji

  2. Vyberte Uložit.

Zadání podrobností o cíli

  1. Na obrazovce Podrobnosti cíle migrace zadejte podrobnosti o připojení k cílovému účtu Azure Cosmos DB. Tento účet je předem zřízený účet rozhraní API služby Azure Cosmos DB pro MongoDB, do kterého migrujete data MongoDB.

    Snímek obrazovky znázorňující zadání podrobností o cíli

  2. Vyberte Uložit.

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

  1. Na obrazovce Mapovat na cílové databáze namapovat 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 vedle názvu databáze zobrazí create (Vytvořit), znamená to, Azure Database Migration Service se cílová databáze nenaštou, a služba databázi vytvoří za vás.

    V tomto okamžiku migrace můžete zřídit propustnost. Ve službě Azure Cosmos DB můžete zřídit propustnost pro každou kolekci buď na úrovni databáze, nebo jednotlivě. Propustnost se měří v jednotkách žádosti. Další informace o cenách služby Azure Cosmos DB

    Snímek obrazovky znázorňuje mapování na cílové databáze

  2. Vyberte Uložit.

  3. Na obrazovce Nastavení kolekce rozbalte seznam kolekcí a zkontrolujte seznam kolekcí, které se budou migrovat.

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

    Můžete zadat počet RU, které má kolekce používat. Azure Database Migration Service navrhuje inteligentní výchozí hodnoty na základě velikosti kolekce.

    Poznámka

    Souběžně proveďte migraci a shromažďování databází. V případě potřeby můžete ke zrychlení spuštění Azure Database Migration Service více instancí nástroje .

    Můžete také zadat klíč horizontálního dělení, abyste mohli využít dělení ve službě Azure Cosmos DB pro zajištění optimální škálovatelnosti. Seznamte se s osvědčenými postupy pro výběr klíče horizontálního oddílu nebo oddílu.

    Snímek obrazovky znázorňuje výběr tabulek kolekcí

  4. Vyberte Uložit.

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

    Snímek obrazovky se souhrnem vydělování

Spuštění migrace

Vyberte Spustit migraci. Zobrazí se okno aktivity migrace a stav aktivity je Nes zahájeno.

Snímek obrazovky znázorňuje stav aktivity

Monitorování migrace

Na obrazovce aktivity migrace vyberte Aktualizovat a aktualizujte zobrazení, dokud se stav migrace nezobrazí jako Dokončeno.

Poznámka

Výběrem aktivity můžete získat podrobnosti o metrikách migrace na úrovni databáze a kolekce.

Screnshot zobrazující dokončený stav aktivity

Ověření dat v Azure Cosmos DB

Po dokončení migrace můžete zkontrolovat účet Azure Cosmos DB a ověřit, že se všechny kolekce úspěšně migrují.

Snímek obrazovky, který ukazuje, kde zkontrolovat účet Azure Cosmos DB a ověřit, že se všechny kolekce úspěšně migrují

Optimalizace po migraci

Po migraci dat uložených v databázi MongoDB do rozhraní API služby Azure Cosmos DB pro MongoDB se můžete připojit k Azure Cosmos DB a spravovat data. Můžete také provést další kroky optimalizace po migraci. Může to zahrnovat optimalizaci zásad indexování, aktualizaci výchozí úrovně konzistence nebo konfiguraci globální distribuce pro účet Azure Cosmos DB. Další informace najdete v tématu Optimalizace po migraci.

Další zdroje informací

  • Pokoušíte se provést plánování kapacity pro migraci do Azure Cosmos DB?
    • Pokud už víte jen počet virtuálních jadr a serverů ve stávajícím databázovém clusteru, přečtěte si o odhadování jednotek žádostí pomocí virtuálních jadr nebo virtuálních procesorů.
    • Pokud znáte typickou míru požadavků pro aktuální databázové úlohy, přečtěte si o odhadování jednotek žádostí pomocí Plánovače kapacity služby Azure Cosmos DB.

Další kroky

Další scénáře v průvodci migrací databází do Azure naleznete v pokynech k migraci.