Sdílet prostřednictvím

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

  • Článek

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

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)

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.

  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.

Další krok

Vytvoření webové aplikace Node.js