Ansluta till Azure DocumentDB med Hjälp av Azure-portalen

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. Azure-portalen innehåller flera verktyg för att köra frågor mot MongoDB-data, inklusive Azure Cloud Shell. Azure Cloud Shell är en interaktiv, autentiserad, webbläsartillgänglig terminal för hantering av Azure-resurser. Den här artikeln beskriver hur du ansluter till ett Azure DocumentDB-kluster med MongoDB Shell i Azure Cloud Shell.

Förutsättningar

En prenumeration på Azure
- Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto

Ett befintligt Azure DocumentDB-kluster
- Om du inte har något kluster skapar du ett nytt kluster

Brandväggsregler som gör att klienter i dina nätverk kan ansluta till klustret. Mer information finns i konfigurera brandväggen.
(Valfritt) Dessa krav krävs endast om du använder Azure Cloud Shell i ett virtuellt nätverk som är samma eller peer-kopplat med Azure DocumentDB.
- Ett eller flera befintliga virtuella Azure-nätverk med undernät för Azure Cloud Shell- och Azure DocumentDB-distribution.
- En privat slutpunkt för Azure DocumentDB-klustret. Mer information finns i konfigurera privat länk.
- Azure Cloud Shell distribueras till samma eller ett peer-kopplat virtuellt nätverk med anslutning till den privata Azure DocumentDB-slutpunkten. Mer information finns i distribuera Cloud Shell till ett virtuellt nätverk.

Aktivera åtkomst till klustret från Azure Cloud Shell

Kontrollera först att Azure Cloud Shell kan komma åt ditt Azure DocumentDB-kluster genom att tillåta dess IP-adresser i brandväggen.

Logga in på Azure Portal (https://portal.azure.com).
Gå till Azure DocumentDB-klustret.
Välj Nätverk på navigeringsmenyn.
På sidan Nätverk i avsnittet Offentlig åtkomst väljer du alternativet + Lägg till Azure Cloud Shell-IP-adresser för att automatiskt lägga till din aktuella IP-adress i listan över tillåtna.
Välj Spara för att tillämpa ändringarna.

Anmärkning

Kontrollera att de specifika IP-adresserna för din region är tillåtna för att säkerställa anslutningen. Mer information finns i IP-adresser för Azure DocumentDB.

Ansluta med Azure Cloud Shell från snabbstart

Om du vill ansluta direkt till Azure DocumentDB med MongoDB Shell använder du den snabbstartsupplevelse som är tillgänglig på resurssidan i Azure-portalen.

På klusterresurssidan väljer du Snabbstart (förhandsversion) på navigeringsmenyn.
Välj sedan Öppna MongoDB-gränssnittet.
Vänta tills MongoDB Shell-miljön har startats.
När miljön är klar, tryck på Y för att acceptera meddelandet.

Anmärkning

Om du har problem med att ansluta med MongoDB Shell när du har accepterat meddelandet kontrollerar du att Azure Cloud Shell har åtkomst till klustret.
Ange nu ditt lösenord för att ansluta klustret till Cloud Shell.

Hämta klusterautentiseringsuppgifter

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

Logga in på Azure-portalen (https://portal.azure.com).
Gå till det befintliga Azure DocumentDB-klustret.

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

På klustersidan väljer du alternativet Anslutningssträngar på resursmenyn.
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.

Konfigurera MongoDB Shell i Azure Cloud Shell manuellt

Installera MongoDB Shell-klienten (mongosh) till din Azure Cloud Shell-instans med Node Package Manager (npm).

Öppna Azure Cloud Shell som konfigurerats med en Bash-skriptmiljö.
Installera version 1 av MongoDB Shell lokalt i användarkatalogen.
```
npm install mongosh@1
```
Vänta tills installationen har slutförts.
Kontrollera att installationen lyckades genom att hämta versionen av mongosh verktyget.
```
npx mongosh --version
```

Anslut till klustret

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.

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

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

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.

Kontrollera anslutningsstatusen genom att connectionStatus köra kommandot .
```
db.runCommand({connectionStatus: 1})
```
```
{
  ...
  ok: 1
}
```
Visa en lista över databaserna i klustret.
```
show dbs
```
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.
Visa en lista över samlingarna i databasen.
```
show collections
```
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).

Feedback

Var den här sidan till hjälp?

Last updated on 2025-11-19