Kurz: Offline migrace MongoDB Azure Cosmos DB rozhraní API 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í Azure Cosmos DB API 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 můžete datovou sadu migrovat do rozhraní AZURE COSMOS DB API pro MongoDB. Pokud ještě nemáte nastavený zdroj MongoDB, najdete informace v tématu Instalace a konfigurace MongoDBna virtuálním počítači s Windows v 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í AZURE COSMOS DB API pro MongoDB.

  • 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 rychlý start s podrobnými podrobnostmi.

    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á:

    • Koncový bod cílové databáze (například koncový bod SQL nebo koncový bod Azure Cosmos DB)
    • Koncový bod úložiště
    • 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) pro vaši virtuální síť neblokovala 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 Windows Firewall, abyste povolili 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 zdrojovou databází, může být nutné přidat pravidla brány firewall, aby Azure Database Migration Service mohl získat přístup ke zdrojové databázi pro migraci.

Konfigurovat funkci opakování na straně serveru

Pokud migrujete z MongoDB na Azure Cosmos DB, můžete využívat možnosti zásad správného řízení prostředků. S těmito možnostmi můžete plně využívat vaše zřízené jednotky žádostí (RU/s). Azure Cosmos DB může v průběhu migrace omezit konkrétní Database Migration Service žádosti, pokud tento požadavek překročí požadavky na kontejner zřízený na kontejneru/s. Pak se musí tento požadavek opakovat.

Database Migration Service je schopen provádět opakované pokusy. Je důležité pochopit, že doba odezvy v síti mezi Database Migration Service a Azure Cosmos DB ovlivňuje 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.

Chcete-li použít operaci na straně serveru, vyberte na portálu Azure Cosmos DB možnost funkce > Opakovat na straně serveru.

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

Pokud je funkce zakázaná, vyberte Povolit.

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

Registrace poskytovatele prostředků

  1. Přihlaste se k webu Azure Portal, vyberte Všechny služby a pak vyberte Předplatná.

    Snímek obrazovky zobrazující předplatná portálu

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

    Snímek obrazovky znázorňuje poskytovatele prostředků

  3. Vyhledejte „migration“ a pak napravo od Microsoft.DataMigration vyberte Zaregistrovat.

    Snímek obrazovky, který ukazuje, jak zaregistrovat 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 Azure Cosmos DB účtu.

    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 (+ Nový projekt migrace).

  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 průzkumníku Azure Storage objektů blob. 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. Pojmete všechny soubory metadat pomocí formátu, collection.metadata.jsna .

      • 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é pomocí formátu, collection.jsv souboru. Všechny soubory metadat umístěte do podsložky s názvem metadata a s názvem ve stejném formátu,collection.js na . Soubory metadat musí být ve stejném formátu jako nástroj MongoDB bsondump.

    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 taky v situacích, kdy není možné překlad názvů DNS.

    Snímek obrazovky, který ukazuje 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í pro cílový Azure Cosmos DB účet. Tento účet představuje předem zřízené Azure Cosmos DB rozhraní API pro účet MongoDB, na který migrujete data MongoDB.

    Snímek obrazovky, který ukazuje zadání cílových podrobností.

  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 zobrazí vedle názvu databáze, znamená to, že Azure Database Migration Service nebyla nalezena cílová databáze a služba vytvoří databázi za vás.

    V tomto okamžiku migrace můžete zřídit propustnost. V Azure Cosmos DB můžete zřídit propustnost buď na úrovni databáze, nebo jednotlivě pro každou kolekci. Propustnost se měří v jednotkách žádostí. Přečtěte si další informace o cenách Azure Cosmos DB.

    Snímek obrazovky, který ukazuje 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é v cílovém Azure Cosmos DB účtu neexistují. Pokud chcete znovu migrovat kolekce, které již obsahují data, je nutné explicitně vybrat kolekce v tomto podokně.

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

    Poznámka

    Migraci a shromažďování databáze proveďte paralelně. V případě potřeby můžete použít více instancí Azure Database Migration Service ke zrychlení běhu.

    Můžete také zadat klíč horizontálního dělení, abyste mohli využít dělení v Azure Cosmos DB optimální škálovatelnost. 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 hodnocení

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 svůj účet Azure Cosmos DB a ověřit, že se všechny kolekce úspěšně migrují.

Snímek obrazovky, který ukazuje, kde Azure Cosmos DB účet 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í AZURE COSMOS DB 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. Může to zahrnovat optimalizaci zásad indexování, aktualizaci výchozí úrovně konzistence nebo konfiguraci globální distribuce pro Azure Cosmos DB účtu. Další informace najdete v tématu Optimalizace po migraci.

Další kroky

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