Delen via

MongoDB offline migreren naar Azure DocumentDB met behulp van systeemeigen MongoDB-hulpprogramma's

In deze zelfstudie gebruikt u systeemeigen MongoDB-hulpprogramma's om een offline (eenmalige) migratie van een database van een on-premises of cloudexemplaren van MongoDB naar Azure DocumentDB uit te voeren. De systeemeigen MongoDB-hulpprogramma's zijn een set binaire bestanden die het bewerken van gegevens op een bestaand MongoDB-exemplaar vergemakkelijken. De focus van dit document ligt op het migreren van gegevens uit een MongoDB-exemplaar met behulp van mongoexport/mongoimport of mongodump/mongorestore. Omdat de systeemeigen hulpprogramma's verbinding maken met MongoDB met behulp van verbindingsreeksen, kunt u de hulpprogramma's overal uitvoeren. De systeemeigen hulpprogramma's kunnen de eenvoudigste oplossing zijn voor kleine gegevenssets waarbij de totale migratietijd geen probleem is.

Vereiste voorwaarden

  • Een Azure-abonnement

  • Een bestaand Azure DocumentDB-cluster

Prepare

Voordat u de migratie start, moet u ervoor zorgen dat u uw Azure DocumentDB-account en uw bestaande MongoDB-exemplaar voor migratie hebt voorbereid.

  • MongoDB-exemplaar (bron)
    • Voltooi de evaluatie van de premigratie om te bepalen of er een lijst met incompatibiliteiten en waarschuwingen tussen uw bronexemplaar en het doelaccount is.
    • Zorg ervoor dat uw systeemeigen MongoDB-hulpprogramma's overeenkomen met dezelfde versie als de bestaande (bron) MongoDB-instantie.
      • Als uw MongoDB-exemplaar een andere versie heeft dan Azure DocumentDB, installeert u beide systeemeigen mongoDB-hulpprogrammaversies en gebruikt u respectievelijk de juiste hulpprogrammaversie voor MongoDB en Azure DocumentDB.
    • Voeg een gebruiker met readWrite machtigingen toe, tenzij er al een bestaat. U gebruikt uiteindelijk deze inloggegevens met de hulpprogramma's mongoexport en mongodump.
  • Azure DocumentDB (target)

Aanbeveling

We raden u aan deze hulpprogramma's uit te voeren in hetzelfde netwerk als het MongoDB-exemplaar om verdere firewallproblemen te voorkomen.

Het juiste systeemeigen MongoDB-hulpprogramma kiezen

Er zijn enkele aandachtspunten op hoog niveau bij het kiezen van het juiste systeemeigen MongoDB-hulpprogramma voor uw offlinemigratie.

De migratie uitvoeren

Migreer een verzameling van het MongoDB-bronexemplaar naar het Azure DocumentDB-doelaccount met behulp van de native tool van uw voorkeur. Zie migratieopties voor meer informatie over het selecteren van een hulpprogramma.

Aanbeveling

Als u gewoon een klein JSON-bestand hebt dat u wilt importeren in Azure DocumentDB, is het hulpprogramma mongoimport een snelle oplossing voor het opnemen van de gegevens.

  1. Als u de gegevens wilt exporteren uit het MongoDB-bronexemplaren, opent u een terminal en gebruikt u een van de drie methoden die hier worden vermeld.

    • Geef de --host, --usernameen --password argumenten op om verbinding te maken met JSON-records en deze te exporteren.

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

    • Exporteer een subset van de MongoDB-gegevens door een --query argument toe te voegen. Dit argument zorgt ervoor dat het hulpprogramma alleen documenten exporteert die overeenkomen met het filter.

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

    • Gegevens exporteren uit Azure DocumentDB.

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

  2. Importeer het eerder geëxporteerde bestand in het Azure DocumentDB-doelaccount.

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

  3. Bewaak de terminaluitvoer van mongoimport. De uitvoer toont tekstregels op de terminal met statusupdates van het importproces.

Volgende stap

Een Node.js-webtoepassing maken

  • Last updated on