Dela via


Använda Visual Studio Code för att ansluta och köra frågor mot Azure Cosmos DB-instanser

Visual Studio Code är en mångsidig kodredigerare för Linux, macOS och Windows med stöd för flera tillägg. Den här snabbstarten visar hur du ansluter till Azure Cosmos DB för NoSQL- och Azure Cosmos DB for MongoDB-kluster (vCore) med hjälp av Visual Studio Code. Den omfattar grundläggande databasåtgärder, inklusive frågor, infogning, uppdatering och borttagning av data.

Förutsättningar

  • Ett Azure Cosmos DB för NoSQL-konto som konfigurerats med en databas och container. Använd någon av dessa snabbstarter här för att konfigurera en resurs:

Installera tillägget

Om du vill ansluta och hantera data i Azure Cosmos DB i Visual Studio installerar du först Azure Databases-tillägget .

  1. Öppna Visual Studio Code.
  2. Öppna fönstret Tillägg genom att välja Visa > tillägg eller använda genvägen Ctrl + Skift + X i Windows och Kommando + Skift + X på macOS.
  3. I sökfältet skriver du DocumentDB för Visual Studio Code och väljer tillägget. Välj sedan Installera.
  4. Efter installationen läser du in Visual Studio Code igen om du uppmanas att göra det.

Ansluta till en Azure Cosmos DB för NoSQL

  1. I Visual Studio Code går du till Azure-fönstret (välj Azure-ikonen i aktivitetsfältet).

  2. Logga in på ditt Azure Cosmos DB for NoSQL-konto via Microsoft Entra-ID:

    Kommentar

    Använd rollbaserad åtkomstkontroll i Microsoft Entra-ID när du kommer åt dina Azure Cosmos DB-resurser.

  3. När du har loggat in letar du upp din Azure-prenumeration i Trädvyn i Azure och ökar detaljnivån till Azure Cosmos DB.

  4. Välj ett befintligt konto eller högerklicka för att skapa en ny resurs.

Fråga och visa dina data

Följande steg använder frågeredigeraren för att köra en fråga och visa resultatet av frågan:

  1. I menyn för samlingen högerklickar du på samlingen för att öppna Power Query-redigeraren i förhandsversionen.

    Skärmbild av frågeredigeraren i Visual Studio Code.

  2. Kör frågan i frågeredigeraren för att visa dina data i tabellvyn:

    Skärmbild av frågeredigeraren resulterar i Visual Studio Code.

  3. Utforska dina data i andra vyer som stöds:

    • JSON-vy: Se rådatastrukturen.

      Skärmbild av frågeredigeraren resulterar i json-vyn.

    • Trädvy: Utforska enkelt kapslade data.

      Skärmbild av frågeredigerarens resultat i trädvyn.

Visa fråge- och indexmått

Visa fler fråge- och indexmått i frågeredigeraren för att optimera frågeprestandan.

  1. Välj fliken Statistik bredvid frågan Resultat. Skärmbild av frågestatistiken i Visual Studio Code.

  2. Mer information om måttdefinitionerna finns i dokumentationen för frågemått.

Infoga, redigera och ta bort dokument

  • Dokumentredigering i realtid: Lägg till, visa, redigera och ta bort dokument direkt, med ändringar som återspeglas i realtid.

  • Importera från JSON: Läs in dina data snabbt från JSON-filer. Skärmbild av redigering av dokument i Visual Studio Code.

Exportera frågeresultat

  • Ladda ned resultat: Ladda ned frågeresultat till CSV- eller JSON-filer. Skärmbild av exportresultat i Visual Studio Code.

Förutsättningar

  • Ett Azure Cosmos DB för NoSQL-konto som konfigurerats med en databas och container.
  • MongoDB Shell (mongosh) installerat för kommandoradsinteraktioner (valfritt men rekommenderas).

Installera tillägget

Om du vill ansluta och hantera data i Azure Cosmos DB måste du installera Azure Databases-tillägget för Visual Studio Code.

  1. Öppna Visual Studio Code.
  2. Öppna fönstret Tillägg genom att välja Visa > tillägg eller använda genvägen Ctrl + Skift + X i Windows och Kommando + Skift + X på macOS.
  3. I sökfältet skriver du DocumentDB för Visual Studio Code och väljer tillägget. Välj sedan Installera.
  4. Efter installationen läser du in Visual Studio Code igen om du uppmanas att göra det.

Ansluta till en MongoDB-arbetsbelastning

  1. I Azure Databases-tillägget expanderar du avsnittet Azure-resurser.
  2. Leta upp Prenumeration som du har din MongoDB-arbetsbelastning. Under den önskade prenumerationen ser du grenen Azure Cosmos DB for MongoDB (vCore). Expandera grenen för att visa dina kluster och databaser.
  3. Välj ditt Azure Cosmos DB for MongoDB-kluster (vCore) från den expanderade listan.

Kommentar

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 börjar du med att tillåta åtkomst till alla IP-adresser genom att lägga till brandväggsregeln 0.0.0.0 - 255.255.255.255 för anslutningstestning från början innan du förfinar listan över tillåtna adresser.

Skärmbild av nätverk och brandväggsalternativ för ett kluster.

Intuitiv Datahantering

Hantera enkelt dina databaser i Visual Studio Code:

  • Skapa och ta bort databaser/samlingar: Skapa eller ta bort databaser och samlingar med snabbmenyn på ditt konto, din databas eller din samling på resurspanelen.

  • Importera från JSON: Importera snabbt data från JSON-filer till din samling.

    • Initiera import
      1. Högerklicka på samlingsnamnet i resursvyn och välj Importera dokument till samling.
      2. Du kan också öppna samlingsvyn genom att klicka på posten Dokument i samlingen och sedan välja knappen Importera .
    • Välj JSON-fil
      1. Bläddra för att hitta filen *.json som innehåller dina data.
      2. Bekräfta för att starta importprocessen.
  • Exportera data: Spara samlingar eller frågeresultat som JSON för säkerhetskopiering eller delning.

    • Initiera export:
      • Alternativ 1
        1. Högerklicka på samlingsnamnet i resursvyn och välj Exportera dokument från samlingen för att exportera hela samlingen.
      • Alternativ 2
        1. Öppna samlingsvyn genom att klicka på posten Dokument i samlingen och välj sedan knappen Exportera .
        2. Välj att exportera antingen hela samlingen eller resultatet av den aktuella frågan.
    • Ange målfil:
      1. Ange namnet och platsen för målfilen *.json.
      2. Bekräfta exporten för att börja spara data.
  • Dokumentredigering i realtid: Lägg till, visa, redigera och ta bort dokument direkt med realtidsuppdateringar.

    • Öppna dokumentredigering:
      • Få åtkomst till redigeringsalternativ för dokument direkt i samlingsvyn. Dessa kontroller är praktiskt placerade ovanför datavyn för enkel åtkomst.
    • Tillgängliga åtgärder:
      • Lägg till: Skapa nya dokument i samlingen.
      • Visa: Visa innehållet i det markerade dokumentet.
      • Redigera: Redigera innehållet i markerade dokument.
      • Ta bort: Ta bort markerade dokument med ändringar som visas omedelbart.

Skärmbild av VS-kodtillägget för ett Azure Cosmos DB for MongoDB-kluster (vCore).

Kraftfulla frågeverktyg

Kör och förfina dina frågor sömlöst:

  • Omedelbart resultat: Visa frågeresultat direkt i önskat format – Tabell, JSON eller Trädvy.

    • Växla vyer enkelt med den nedrullningsbara menyn Visa .
  • Kör frågor direkt: Skriv och kör MongoDB-frågor med funktioner som syntaxmarkering och automatisk komplettering.

    • Om du vill köra frågan väljer du knappen Sök fråga eller trycker Ctrl/Cmd+Enter i frågeredigeraren.

Kommentar

För närvarande stöds endast sökfilterfrågor, och utökade frågefunktioner kommer snart.

Flexibla datavyer

Utforska dina data med flera vyer för olika perspektiv:

  • JSON-vy: Se den råa JSON-datastrukturen.

    Skärmbild av VS-kodtillägget för ett Azure Cosmos DB for MongoDB-kluster (vCore) i JSON-vyn.

  • Trädvy: Navigera och utforska kapslade data utan problem.

    Skärmbild av VS-kodtillägget för ett Azure Cosmos DB for MongoDB-kluster (vCore) i trädvyn.

  • Tabellvy: Sök snabbt igenom data och öka detaljnivån i kapslade dokument.

    • Öka detaljnivån: Hitta poster med {} ikonen som anger inbäddade objekt. Dubbelklicka för att expandera och visa innehåll.

    • Gå tillbaka: Gå tillbaka till tidigare nivåer med hjälp av navigeringssmulterna under tabellvyn.

    Skärmbild av VS-kodtillägget för ett Azure Cosmos DB for MongoDB-kluster (vCore) i tabellvyn.

Mongo Shell-integrering

Kommandoradsfunktioner är tillgängliga:

  • Starta mongosh: Kör avancerade MongoDB-kommandon direkt från Visual Studio Code.

Kommentar

MongoDB-gränssnittet (mongosh) ingår inte i tillägget. Den måste installeras separat och konfigureras manuellt.

Klusterhantering

Håll koll på dina resurser:

  • Visa klusterinformation: Kontrollera klustrets nivå, serverversion och resursanvändning.

  • Hantera taggar: Organisera dina kluster med taggar som synkroniseras med Azure-portalen.