Dela via


Ansluta till Azure Cosmos DB för MongoDB (virtuell kärna) med MongoDB Shell

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 ditt Azure Cosmos DB for MongoDB-kluster (vCore). Den här artikeln beskriver hur du ansluter till ett Azure Cosmos DB for MongoDB-kluster (vCore) med MongoDB Shell.

Förutsättningar

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 Portal (https://portal.azure.com).

  2. Gå till klustret Azure Cosmos DB för MongoDB (vCore).

  3. Välj navigeringsmenyalternativet Anslutningssträngar .

  4. Kopiera eller registrera värdet från fältet Anslutningssträng .

    Skärmbild av alternativet för anslutningssträngar på klustersidan.

    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äng innehåller cosmos.azure. Azure Cosmos DB for MongoDB (vCore) ä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 bör 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äng innehåller cosmos.azure. Azure Cosmos DB for MongoDB (vCore) ä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})
    
  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).