Offline migrace MongoDB do služby Azure Cosmos DB pro MongoDB vCore pomocí nativních nástrojů MongoDB

PLATÍ PRO: Virtuální jádro MongoDB

V tomto kurzu použijete nativní nástroje MongoDB k provedení offline migrace databáze z místní nebo cloudové instance MongoDB do služby Azure Cosmos DB pro MongoDB vCore. Nativní nástroje MongoDB jsou sada binárních souborů, které usnadňují manipulaci s daty u existující instance MongoDB. Tento dokument se zaměřuje na migraci dat z instance MongoDB pomocí mongoexport/mongoimport nebo mongodump/mongorestore. Vzhledem k tomu, že se nativní nástroje připojují k MongoDB pomocí připojovací řetězec, můžete je spouštět kdekoli. Nativní nástroje můžou být nejjednodušším řešením pro malé datové sady, kde se celkový čas migrace netýká.

Požadavky

• Existující cluster azure Cosmos DB pro virtuální jádra MongoDB
  • Pokud nemáte předplatné Azure, vytvořte si účet zdarma.
  • Pokud máte existující předplatné Azure, vytvořte nový cluster azure Cosmos DB pro virtuální jádra MongoDB.
• Nativní nástroje MongoDB nainstalované na vašem počítači.

Příprava

Před zahájením migrace se ujistěte, že jste připravili svůj účet virtuálních jader Azure Cosmos DB pro MongoDB a stávající instanci MongoDB na migraci.

• Instance MongoDB (zdroj)
  • Dokončete posouzení premigrace, abyste zjistili, jestli mezi vaší zdrojovou instancí a cílovým účtem existuje seznam nekompatibility a upozornění.
  • Ujistěte se, že nativní nástroje MongoDB odpovídají stejné verzi jako existující (zdrojová) instance MongoDB.
    • Pokud má vaše instance MongoDB jinou verzi než Azure Cosmos DB pro virtuální jádro MongoDB, nainstalujte nativní verze nástrojů MongoDB a použijte odpovídající verzi nástroje pro MongoDB a azure Cosmos DB pro virtuální jádro MongoDB.
  • Přidejte uživatele s oprávněními readWrite , pokud ještě neexistuje. Tyto přihlašovací údaje nakonec použijete s nástroji mongoexport a mongodump .
• Virtuální jádro Azure Cosmos DB pro MongoDB (cíl)
  • Shromážděte přihlašovací údaje účtu virtuálního jádra služby Azure Cosmos DB pro MongoDB.
  • Konfigurace nastavení brány firewall ve službě Azure Cosmos DB pro virtuální jádro MongoDB

Tip

Doporučujeme tyto nástroje spustit ve stejné síti jako instance MongoDB, abyste se vyhnuli dalším problémům s bránou firewall.

Volba správného nativního nástroje MongoDB

Při výběru správného nativního nástroje MongoDB pro offline migraci je potřeba zvážit několik důležitých aspektů.

Provedení migrace

Pomocí upřednostňovaného nativního nástroje migrujte kolekci ze zdrojové instance MongoDB do cílového účtu virtuálních jader Azure Cosmos DB pro MongoDB. Další informace o výběru nástroje najdete v nativních nástrojích MongoDB.

Tip

Pokud máte jednoduše malý soubor JSON, který chcete importovat do služby Azure Cosmos DB pro virtuální jádro MongoDB, je nástroj mongoimport rychlým řešením pro příjem dat.

mongoexport/mongoimport

1. Pokud chcete exportovat data ze zdrojové instance MongoDB, otevřete terminál a použijte některou ze tří metod uvedených zde.

   • --hostZadejte , --usernamea argumenty pro připojení a --password export záznamů JSON.

     mongoexport \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --db <database-name> \
         --collection <collection-name> \
         --out <filename>.json
     

   • Exportujte podmnožinu dat MongoDB přidáním argumentu --query . Tento argument zajišťuje, že nástroj exportuje pouze dokumenty, které odpovídají filtru.

     mongoexport \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --db <database-name> \
         --collection <collection-name> \
         --query '{ "quantity": { "$gte": 15 } }' \
         --out <filename>.json
     

   • Exportujte data ze služby Azure Cosmos DB pro virtuální jádro MongoDB.

     mongoexport \
         --uri <target-connection-string>
         --db <database-name> \
         --collection <collection-name> \
         --query '{ "quantity": { "$gte": 15 } }' \
         --out <filename>.json
     

2. Importujte dříve exportovaný soubor do cílového účtu virtuálních jader Azure Cosmos DB pro MongoDB.

   mongoimport \
       --file <filename>.json \
       --type json \
       --db <database-name> \
       --collection <collection-name> \
       --ssl \
       --uri <target-connection-string>
   

3. Monitorujte výstup terminálu z mongoimportu. Výstup vytiskne řádky textu do terminálu s aktualizacemi stavu operace importu.

Mongodump/mongorestore

1. Pokud chcete vytvořit výpis dat všech dat v instanci MongoDB, otevřete terminál a použijte některou ze tří metod uvedených zde.

   • --hostZadejte , --usernamea --password argumenty pro výpis dat jako nativní BSON.

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \
         --out <dump-directory>
     

   • Zadejte a --collection argumenty, --db abyste zúžili rozsah dat, která chcete vyhodit:

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \    
         --db <database-name> \
         --out <dump-directory>
     

     mongodump \
         --host <hostname><:port> \
         --username <username> \
         --password <password> \    
         --db <database-name> \
         --collection <collection-name> \
         --out <dump-directory>
     

   • Vytvořte výpis dat všech dat ve službě Azure Cosmos DB pro virtuální jádro MongoDB.

     mongodump \
         --uri <target-connection-string> \
         --out <dump-directory>
     

2. Všimněte si, že nástroj vytvořil adresář s nativním výpisem dat BSON. Soubory a složky jsou uspořádané do hierarchie prostředků na základě názvů databází a kolekcí. Každá databáze je složka a každá kolekce je .bson soubor.

3. Obnovte obsah libovolné konkrétní kolekce do účtu virtuálního jádra služby Azure Cosmos DB pro MongoDB zadáním konkrétního souboru BSON kolekce. Název souboru je vytvořen pomocí této syntaxe: <dump-directory>/<database-name>/<collection-name>.bson.

   mongorestore \ 
       --ssl \
       --uri <target-connection-string> \
       <dump-directory>/<database-name>/<collection-name>.bson
   

   Poznámka:

   Můžete také obnovit konkrétní kolekci nebo kolekce z adresáře dump-directory /directory. Například následující operace obnoví jednu kolekci z odpovídajících datových souborů v adresáři výpisu /adresáři. mongorestore --nsInclude=test.purchaseorders <dump-directory>/

4. Monitorujte výstup terminálu z mongoimportu. Výstup vytiskne řádky textu do terminálu s aktualizacemi stavu operace obnovení.

Další krok

Vytvoření webové aplikace Node.js