Delen via

Verbinding maken met Azure DocumentDB met behulp van MongoDB Shell

MongoDB Shell (mongosh) is een JavaScript- en Node.js-omgeving voor interactie met MongoDB-implementaties. Het is een populair communityhulpprogramma om query's te testen en te communiceren met de gegevens in uw Azure DocumentDB-cluster. In dit artikel wordt uitgelegd hoe u verbinding maakt met een Azure DocumentDB-cluster met behulp van MongoDB Shell.

Vereiste voorwaarden

  • Een Azure-abonnement

  • Een bestaand Azure DocumentDB-cluster

Clusterreferenties ophalen

Haal de verbindingsreeks op die u nodig hebt om verbinding te maken met dit cluster.

  1. Meld u aan bij Azure Portal (https://portal.azure.com).

  2. Navigeer naar het bestaande Azure DocumentDB-cluster.

Haal de gegevens op die u gebruikt om verbinding te maken met het cluster.

  1. Selecteer op de clusterpagina de optie Verbindingsreeksen in het resourcemenu.

  2. Kopieer of noteer in de sectie Verbindingsreeksen de waarde uit het veld Verbindingsreeks .

Schermopname van de optie verbindingsreeksen.

Belangrijk

De verbindingsreeks in de portal bevat niet de wachtwoordwaarde. U moet de <password> tijdelijke aanduiding vervangen door de referenties die u hebt ingevoerd bij het maken van het cluster of door het wachtwoord interactief in te voeren.

Verbinding maken met interactieve wachtwoordverificatie

Maak verbinding met uw cluster met behulp van de MongoDB Shell met een verbindingsreeks die geen wachtwoord bevat. Gebruik de interactieve wachtwoordprompt om uw wachtwoord in te voeren als onderdeel van de verbindingsstappen.

  1. Open een terminal.

  2. Maak verbinding door het wachtwoord in te voeren in de MongoDB Shell-prompt. Gebruik voor deze stap een verbindingsreeks zonder het wachtwoord.

    mongosh "mongodb+srv://<username>@<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"

  3. Nadat u het wachtwoord hebt opgegeven en is geverifieerd, bekijkt u de waarschuwing die wordt weergegeven

    This server or service appears to be an emulation of MongoDB.

    Aanbeveling

    U mag dit bericht negeren. Deze waarschuwing wordt gegenereerd omdat de verbindingsreeks cosmos.azure bevat. Azure DocumentDB is een systeemeigen PaaS-aanbieding (Platform as a Service).

  4. Sluit de shell-context af.

Verbinding maken met verbindingsreeks en wachtwoord

Maak nu vanuit de MongoDB Shell verbinding met uw cluster met een verbindingsreeks en parameters die een wachtwoord bevatten.

  1. Maak verbinding met behulp van een verbindingsreeks en de argumenten --username en --password.

    mongosh "mongodb+srv://<cluster-name>.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000" --username "<username>" -password "<password>"

  2. Nadat u het wachtwoord hebt opgegeven en is geverifieerd, bekijkt u de waarschuwing die wordt weergegeven.

    ------
   Warning: Non-Genuine MongoDB Detected
   This server or service appears to be an emulation of MongoDB rather than an official MongoDB product.
------

    Aanbeveling

    U mag dit bericht negeren. Deze waarschuwing wordt gegenereerd omdat de verbindingsreeks cosmos.azure bevat. Azure DocumentDB is een systeemeigen PaaS-aanbieding (Platform as a Service).

Testquery's uitvoeren

Controleer of u verbinding hebt gemaakt met uw cluster door een reeks testopdrachten en query's uit te voeren.

  1. Controleer de verbindingsstatus door de opdracht uit te connectionStatus voeren.

    db.runCommand({connectionStatus: 1})

    {
  ...
  ok: 1
}

  2. Geef de databases in uw cluster weer.

    show dbs

  3. Schakel over naar een specifieke database. Vervang de <database-name> tijdelijke aanduiding door de naam van een database in uw cluster.

    use <database-name>

    Aanbeveling

    Bijvoorbeeld, als de databasenaam inventory is, dan is de opdracht use inventory.

  4. Geef de verzamelingen in de database weer.

    show collections

  5. Zoek de eerste vijf items in een specifieke verzameling. Vervang de <collection-name> tijdelijke aanduiding door de naam van een verzameling in uw cluster.

    db.<collection-name>.find().limit(5)

    Aanbeveling

    Als de naam van de verzameling bijvoorbeeld equipment is, dan is de opdracht db.equipment.find().limit(5).

Verwante inhoud

  • Last updated on