Offline migrace MongoDB do Azure DocumentDB pomocí nativních nástrojů MongoDB

V tomto kurzu použijete nativní nástroje MongoDB k provedení offline (jednorázové) migrace databáze z místní nebo cloudové instance MongoDB do Azure DocumentDB. 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ích řetězců, můžete je spouštět kdekoli. Nativní nástroje mohou být nejjednodušším řešením pro malé datové sady, kde není důležitý celkový čas migrace.

Prerequisites

  • Předplatné Azure

  • Existující cluster Azure DocumentDB

Prepare

Před zahájením migrace se ujistěte, že jste připravili svůj účet Azure DocumentDB 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 DocumentDB, nainstalujte nativní verze nástrojů MongoDB a použijte odpovídající verzi nástroje pro MongoDB a Azure DocumentDB.
    • 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 .
  • Azure DocumentDB (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 Azure DocumentDB. Další informace o výběru nástroje najdete v tématu Možnosti migrace.

Tip

Pokud jednoduše máte malý soubor JSON, který chcete importovat do Azure DocumentDB, 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.

    • Zadejte argumenty --host, --username a --password pro připojení a 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 z Azure DocumentDB.

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

  2. Naimportujte dříve exportovaný soubor do cílového účtu Azure DocumentDB.

    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

  • Last updated on