Dela via


Använda MongoDB Shell för att ansluta till Azure Cosmos DB för MongoDB (vCore)

GÄLLER FÖR: MongoDB vCore

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 din Azure Cosmos DB for MongoDB-databas.

Förutsättningar

  • Ett befintligt Azure Cosmos DB-kluster för MongoDB (vCore-arkitektur).

  • En installerad version av MongoDB Shell från community-webbplatsen.

  • Installation av nödvändiga miljövariabler efter installationen för operativsystemet.

  • Brandväggsinställningar som gör att datorn kan ansluta. Följ riktlinjerna för att konfigurera brandväggen för Azure Cosmos DB.

    Du kan välja att tillåta begäranden från din aktuella IP-adress, begäranden från molntjänster eller begäranden från virtuella datorer (specifika IP-intervall).

    Animering som visar en uppdatering av brandväggsinställningarna för Azure Cosmos DB för MongoDB i arkitekturen för virtuella kärnor.

    Om du av misstag öppnar alla portar varnas du innan du sparar ändringarna.

Ansluta med Hjälp av MongoDB Shell

Utför följande steg för att lägga till ditt Azure Cosmos DB-kluster i MongoDB Shell:

  1. Hämta anslutningsinformationen för din Azure Cosmos DB for MongoDB-instans (vCore) med hjälp av dessa instruktioner.

    Animering som visar val för att få en anslutningssträng.

  2. Anslut med någon av följande metoder:

    • Ange lösenordet i Mongo Shell-prompten. Ditt anslutningssträng ser ut som i det här exemplet:

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

      Kommandot ser ut så här:

      mongosh "mongodb+srv://testuser@mongodbvcoretesting.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000
      

      Animering som visar hur du ansluter genom att ange ett lösenord.

      När du har angett lösenordet och autentiserats visas den här varningen: "Den här servern eller tjänsten verkar vara en emulering av MongoDB." Du kan ignorera det. Den här varningen genereras eftersom anslutningssträng innehåller cosmos.azure. Azure Cosmos DB är ett internt PaaS-erbjudande (Plattform som en tjänst).

    • Ange lösenordet som en del av anslutningssträng. Formatet ser ut ungefär så här:

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

      Kommandot ser ut så här:

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

      Skärmbild som visar ett lösenord som en del av en anslutningssträng.

Gå vidare