Snabbstart: Skapa ett Azure DocumentDB-kluster med hjälp av Azure-portalen

I den här snabbstarten skapar du ett nytt Azure DocumentDB-kluster. Det här klustret innehåller alla dina typiska MongoDB-resurser: databaser, samlingar och dokument. Klustret tillhandahåller en unik slutpunkt för olika verktyg och drivrutiner för att ansluta till Azure DocumentDB och utföra vardagliga åtgärder.

Förutsättningar

  • En prenumeration på Azure

Skapa ett kluster

För att komma igång måste du först skapa ett Azure DocumentDB-kluster som fungerar som grund för att lagra och hantera dina NoSQL-data.

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

  2. I menyn i Azure-portalen eller på sidan Start väljer du Skapa en resurs.

  3. På sidan Ny söker du efter och väljer Azure DocumentDB.

    Skärmbild som visar sökning efter Azure DocumentDB.

  4. På sidan Skapa Azure DocumentDB-kluster och i avsnittet Grundläggande väljer du alternativet Konfigurera i avsnittet Klusternivå .

    Skärmbild som visar alternativet Konfigurera kluster.

  5. På sidan Skala konfigurerar du de här alternativen och väljer sedan Spara för att spara ändringarna på klusternivån.

    Värde
    Klusternivå M30 tier, 2 vCore, 8-GiB RAM
    Lagring per shard 128 GiB

    Skärmbild av konfigurationsalternativ för beräkning och lagring för ett nytt Azure DocumentDB-kluster.

  6. I avsnittet Grundläggande konfigurerar du följande alternativ:

    Värde
    Subscription Välj din Azure-prenumeration
    resursgrupp Skapa en ny resursgrupp eller välj en befintlig resursgrupp
    Klusternamn Ange ett globalt unikt namn
    Läge Välj en Azure-region som stöds för din prenumeration
    MongoDB-version Välj 8.0
    Användarnamn för administratör Skapa ett användarnamn för att komma åt klustret som användaradministratör
    Lösenord Använda ett unikt lösenord som är associerat med användarnamnet

    Skärmbild som visar klusterparametrar.

    Tips/Råd

    Registrera de värden som du använder för användarnamn och lösenord. Dessa värden används senare i den här guiden. Mer information om giltiga värden finns i klusterbegränsningar.

  7. Välj Nästa: Nätverk.

  8. I avsnittet Brandväggsregler på fliken Nätverk konfigurerar du följande alternativ:

    Värde
    Anslutningsmetod Public access
    Tillåt offentlig åtkomst från Azure-tjänster och resurser i Azure till det här klustret Aktiverad
  9. Lägg till en brandväggsregel för den aktuella klientenheten för att bevilja åtkomst till klustret genom att välja + Lägg till aktuell klient-IP-adress.

    Skärmbild som visar nätverkskonfigurationer.

    Tips/Råd

    I många företagsmiljöer är IP-adresser för utvecklardatorer dolda på grund av ett VPN eller andra företagsnätverksinställningar. I dessa fall kan du tillfälligt tillåta åtkomst till alla IP-adresser genom att lägga till IP-adressintervallet 0.0.0.0 - 255.255.255.255 som en brandväggsregel. Använd endast den här brandväggsregeln tillfälligt som en del av anslutningstestning och utveckling.

  10. Välj Förhandsgranska + skapa.

  11. Granska de inställningar du anger och välj sedan Skapa. Det tar några minuter att skapa klustret. Vänta tills resursdistributionen är klar.

  12. Välj slutligen Gå till resurs för att navigera till Azure DocumentDB-klustret i portalen.

Skärmbild som visar resursalternativ för goto.

Hämta klusterautentiseringsuppgifter

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 MongoDB 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.

  1. På klusterresurssidan väljer du Snabbstart (förhandsversion) på navigeringsmenyn.

  2. Välj sedan Öppna MongoDB-gränssnittet.

  3. Vänta tills MongoDB Shell-miljön har startats.

  4. 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.

  5. Ange nu ditt lösenord för att ansluta klustret till Cloud Shell.

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).

Rensa resurser

När du är klar med Azure DocumentDB-klustret kan du ta bort de Azure-resurser som du skapade så att du inte debiteras fler avgifter.

  1. I sökfältet Azure Portal söker du efter och väljer Resursgrupper.

    Skärmbild som visar alternativet för att söka efter resursgrupper.

  2. I listan väljer du den resursgrupp som du använde för den här snabbstarten.

    Skärmbild som visar resursgrupp.

  3. På resursgruppssidan väljer du Ta bort resursgrupp.

  4. I dialogrutan för bekräftelse av borttagning anger du namnet på resursgruppen för att bekräfta att du tänker ta bort den. Slutligen väljer du Ta bort för att ta bort resursgruppen permanent.

    Skärmbild som visar bekräftelseknappen för att ta bort resursgruppen.