Dela via

Ansluta till Azure DocumentDB med MongoDB Shell

MongoDB Shell (mongosh) är en JavaScript- och Node.js-miljö för interaktion med MongoDB-distributioner. Det är ett populärt communityverktyg för att testa frågor och interagera med data i ditt Azure DocumentDB-kluster. Den här artikeln beskriver hur du ansluter till ett Azure DocumentDB-kluster med MongoDB Shell.

Förutsättningar

  • En prenumeration på Azure

  • Ett befintligt Azure DocumentDB-kluster

Hämta klusterautentiseringsuppgifter

Hämta anslutningssträngen som du behöver för att ansluta till det här klustret.

  1. Logga in på Azure-portalen (https://portal.azure.com).

  2. Gå till det befintliga Azure DocumentDB-klustret.

Hämta de autentiseringsuppgifter som du använder för att ansluta till klustret.

  1. På klustersidan väljer du alternativet Anslutningssträngar på resursmenyn.

  2. I avsnittet Anslutningssträngar kopierar eller registrerar du värdet från fältet Anslutningssträng .

Skärmbild som visar alternativet anslutningssträngar.

Viktigt!

Anslutningssträngen i portalen innehåller inte lösenordsvärdet. Du måste ersätta <password> platshållaren med de autentiseringsuppgifter som du angav när du skapade klustret eller ange lösenordet interaktivt.

Ansluta med interaktiv lösenordsautentisering

Anslut till klustret med hjälp av MongoDB Shell med en anslutningssträng som inte innehåller något lösenord. Använd den interaktiva lösenordsprompten för att ange ditt lösenord som en del av anslutningsstegen.

  1. Öppna en terminal.

  2. Anslut genom att ange lösenordet i MongoDB Shell-prompten. I det här steget använder du en anslutningssträng utan lösenordet.

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

  3. När du har angett lösenordet och har autentiserats bör du observera varningen som visas

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

    Tips/Råd

    Du kan ignorera den här varningen. Den här varningen genereras eftersom anslutningssträngen innehåller cosmos.azure. Azure DocumentDB är ett internt PaaS-erbjudande (Plattform som en tjänst).

  4. Avsluta gränssnittskontexten.

Ansluta med anslutningssträng och lösenord

Anslut nu till klustret från MongoDB Shell med en anslutningssträng och parametrar som innehåller ett lösenord.

  1. Anslut med hjälp av en anslutningssträng och argumenten --username och --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. När du har angett lösenordet och har autentiserats kan du observera varningen som visas.

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

    Tips/Råd

    Du kan ignorera den här varningen. Den här varningen genereras eftersom anslutningssträngen innehåller cosmos.azure. Azure DocumentDB är ett internt PaaS-erbjudande (Plattform som en tjänst).

Utföra testfrågor

Kontrollera att du är ansluten till klustret genom att utföra en serie testkommandon och frågor.

  1. Kontrollera anslutningsstatusen genom att connectionStatus köra kommandot .

    db.runCommand({connectionStatus: 1})

    {
  ...
  ok: 1
}

  2. Visa en lista över databaserna i klustret.

    show dbs

  3. Växla till en specifik databas. <database-name> Ersätt platshållaren med namnet på valfri databas i klustret.

    use <database-name>

    Tips/Råd

    Om till exempel databasnamnet är inventory, då blir kommandot use inventory.

  4. Visa en lista över samlingarna i databasen.

    show collections

  5. Hitta de första fem objekten i en specifik samling. <collection-name> Ersätt platshållaren med namnet på en samling i klustret.

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

    Tips/Råd

    Om samlingsnamnet till exempel är equipment, då skulle kommandot vara db.equipment.find().limit(5).

Relaterat innehåll

  • Last updated on