Delen via


Visual Studio Code gebruiken om verbinding te maken en query's uit te voeren op Azure Cosmos DB-exemplaren

Visual Studio Code is een veelzijdige code-editor voor Linux, macOS en Windows, die talloze extensies ondersteunt. In deze quickstart ziet u hoe u verbinding maakt met Azure Cosmos DB for NoSQL- en Azure Cosmos DB for MongoDB-cluster (vCore) met behulp van Visual Studio Code. Het omvat het uitvoeren van kerndatabasebewerkingen, waaronder het uitvoeren van query's, invoegen, bijwerken en verwijderen van gegevens.

Vereisten

  • Een Azure Cosmos DB for NoSQL-account dat is geconfigureerd met een database en container. Gebruik hier een van deze quickstarts om een resource in te stellen:

De extensie installeren

Als u gegevens in Azure Cosmos DB wilt verbinden en beheren in Visual Studio, moet u eerst de Azure Databases-extensie installeren.

  1. Open Visual Studio Code.
  2. Open het deelvenster Extensies door Weergave-extensies > te selecteren of met de sneltoets Ctrl + Shift + X in Windows en Command + Shift + X in macOS.
  3. Typ DocumentDB voor Visual Studio Code in de zoekbalk en selecteer de extensie. Selecteer Vervolgens Installeren.
  4. Na de installatie laadt u Visual Studio Code opnieuw als hierom wordt gevraagd.

Verbinding maken met een Azure Cosmos DB for NoSQL

  1. Ga in Visual Studio Code naar het Deelvenster Azure (selecteer het Azure-pictogram in de activiteitenbalk).

  2. Meld u aan bij uw Azure Cosmos DB for NoSQL-account via Microsoft Entra-id:

    Notitie

    Gebruik op rollen gebaseerd toegangsbeheer van Microsoft Entra ID bij het openen van uw Azure Cosmos DB-resources.

  3. Zodra u bent aangemeld, zoekt u in de Azure-structuurweergave uw Azure-abonnement en zoomt u in op Azure Cosmos DB.

  4. Selecteer een bestaand account of klik met de rechtermuisknop om een nieuwe resource te maken.

Uw gegevens opvragen en weergeven

De volgende stappen gebruiken de Query-editor om een query uit te voeren en de resultaten van de query weer te geven:

  1. Klik in het menu voor uw verzameling met de rechtermuisknop op de verzameling om de Power Query-editor in preview te openen.

    Schermopname van de query-editor in Visual Studio Code.

  2. Voer de query uit die is opgegeven in de query-editor om uw gegevens weer te geven in de tabelweergave:

    Schermopname van de resultaten van de queryeditor in Visual Studio Code.

  3. Verken uw gegevens in andere ondersteunde weergaven:

    • JSON-weergave: bekijk de onbewerkte gegevensstructuur.

      Schermopname van de resultaten van de queryeditor in de json-weergave.

    • Structuurweergave: Verken eenvoudig geneste gegevens.

      Schermopname van de resultaten van de queryeditor in de structuurweergave.

Metrische gegevens van query's en indexen weergeven

Bekijk in de queryeditor meer metrische query- en indexgegevens om uw queryprestaties beter te optimaliseren.

  1. Selecteer het tabblad Statistieken naast de queryresultaten. Schermopname van de querystatistieken in Visual Studio Code.

  2. Zie de documentatie voor metrische querygegevens voor meer informatie over de metrische definities van metrische gegevens.

Documenten invoegen, bewerken en verwijderen

  • Realtime documentbewerking: Documenten direct toevoegen, weergeven, bewerken en verwijderen, met wijzigingen die in realtime worden doorgevoerd.

  • Importeren uit JSON: laad uw gegevens snel uit JSON-bestanden. Schermopname van het bewerken van documenten in Visual Studio Code.

Queryresultaten exporteren

  • Resultaten downloaden: Queryresultaten downloaden naar CSV- of JSON-bestanden. Schermopname van het exporteren van resultaten in Visual Studio Code.

Vereisten

  • Een Azure Cosmos DB for NoSQL-account dat is geconfigureerd met een database en container.
  • MongoDB-shell (mongosh) geïnstalleerd voor opdrachtregelinteracties (optioneel maar aanbevolen).

De extensie installeren

Als u verbinding wilt maken met en gegevens wilt beheren in Azure Cosmos DB, moet u de Azure Databases-extensie voor Visual Studio Code installeren.

  1. Open Visual Studio Code.
  2. Open het deelvenster Extensies door Weergave-extensies > te selecteren of met de sneltoets Ctrl + Shift + X in Windows en Command + Shift + X in macOS.
  3. Typ DocumentDB voor Visual Studio Code in de zoekbalk en selecteer de extensie. Selecteer Vervolgens Installeren.
  4. Na de installatie laadt u Visual Studio Code opnieuw als hierom wordt gevraagd.

Verbinding maken met een MongoDB-workload

  1. Vouw in de Azure Databases-extensie de sectie Azure-resources uit.
  2. Zoek het abonnement waarvoor u uw MongoDB-workload hebt. Onder het gewenste abonnement ziet u azure Cosmos DB for MongoDB -vertakking (vCore). Vouw de vertakking uit om uw clusters en databases weer te geven.
  3. Kies uw Azure Cosmos DB for MongoDB-cluster (vCore) in de uitgevouwen lijst.

Notitie

In veel bedrijfsomgevingen worden IP-adressen van ontwikkelaarscomputers verborgen vanwege een VPN- of andere bedrijfsnetwerkinstellingen. In deze gevallen moet u eerst toegang tot alle IP-adressen toestaan door de 0.0.0.0 - 255.255.255.255 firewallregel voor verbindingstests in eerste instantie toe te voegen voordat u de acceptatielijst verfijnt.

Schermopname van netwerk- en firewallopties voor een cluster.

Intuïtieve Gegevensbeheer

Beheer eenvoudig uw databases in Visual Studio Code:

  • Databases/verzamelingen maken en verwijderen: databases en verzamelingen maken of verwijderen met behulp van het contextmenu in uw account, database of verzameling in het resourcepaneel.

  • Importeren uit JSON: Importeer snel gegevens uit JSON-bestanden in uw verzameling.

    • Importeren initiëren
      1. Klik met de rechtermuisknop op de naam van de verzameling in de resourceweergave en selecteer Documenten importeren in verzameling.
      2. U kunt ook de 'Verzamelingsweergave' openen door op de vermelding Documenten van uw verzameling te klikken en vervolgens de knop Importeren te selecteren.
    • JSON-bestand selecteren
      1. Blader naar het *.json-bestand met uw gegevens.
      2. Bevestig dat u het importproces wilt starten.
  • Gegevens exporteren: verzamelingen of queryresultaten opslaan als JSON voor back-up of delen.

    • Export initiëren:
      • Optie 1
        1. Klik met de rechtermuisknop op de naam van de verzameling in de resourceweergave en selecteer Documenten exporteren uit verzameling om de hele verzameling te exporteren.
      • Optie 2
        1. Open de verzamelingsweergave door te klikken op de vermelding Documenten van uw verzameling en selecteer vervolgens de knop Exporteren .
        2. Kies ervoor om de volledige verzameling of de resultaten van de huidige query te exporteren.
    • Doelbestand opgeven:
      1. Voer de naam en locatie in voor het doelbestand *.json.
      2. Bevestig exporteren om de gegevens op te slaan.
  • Realtime documentbewerking: documenten direct toevoegen, weergeven, bewerken en verwijderen met realtime-updates.

    • Documentbewerking openen:
      • Toegang tot documentbewerkingsopties rechtstreeks in de 'Verzamelingsweergave'. Deze besturingselementen bevinden zich gemakkelijk boven de gegevensweergave voor eenvoudige toegang.
    • Beschikbare acties:
      • Toevoegen: Nieuwe documenten in de verzameling maken.
      • Weergave: De inhoud van het geselecteerde document weergeven.
      • Bewerken: De inhoud van geselecteerde documenten bewerken.
      • Verwijderen: Geselecteerde documenten verwijderen met wijzigingen die onmiddellijk worden doorgevoerd.

Schermopname van de VS-code-extensie van een Azure Cosmos DB voor MongoDB-cluster (vCore).

Krachtige hulpprogramma's voor query's

Voer uw query's naadloos uit en verfijn deze:

  • Directe resultaten: bekijk direct de queryresultaten in de gewenste indeling: tabel-, JSON- of structuurweergave.

    • U kunt eenvoudig schakelen tussen weergaven met behulp van het vervolgkeuzemenu Weergave .
  • Query's rechtstreeks uitvoeren: MongoDB-query's schrijven en uitvoeren met functies zoals syntaxismarkering en automatisch aanvullen.

    • Als u de query wilt uitvoeren, selecteert u de knop Query zoeken of drukt Ctrl/Cmd+Enter u in de queryeditor.

Notitie

Op dit moment worden alleen filterquery's ondersteund, waarbij uitgebreide querymogelijkheden binnenkort beschikbaar zijn.

Flexibele gegevensweergaven

Verken uw gegevens met behulp van meerdere weergaven voor verschillende perspectieven:

  • JSON-weergave: zie de onbewerkte JSON-gegevensstructuur.

    Schermopname van de VS-code-extensie van een Azure Cosmos DB voor MongoDB-cluster (vCore) in de JSON-weergave.

  • Structuurweergave: Moeiteloos geneste gegevens navigeren en verkennen.

    Schermopname van de VS-code-extensie van een Azure Cosmos DB voor MongoDB-cluster (vCore) in de structuurweergave.

  • Tabelweergave: snel gegevens scannen en inzoomen op geneste documenten.

    • Inzoomen: Vermeldingen zoeken met het {} pictogram, waarmee ingesloten objecten worden aangegeven. Dubbelklik om de inhoud uit te vouwen en weer te geven.

    • Ga terug naar vorige niveaus met behulp van de navigatiepaden onder de tabelweergave.

    Schermopname van de VS-code-extensie van een Azure Cosmos DB voor MongoDB-cluster (vCore) in de tabelweergave.

Mongo Shell-integratie

De opdrachtregelfunctionaliteit is beschikbaar:

  • Starten mongosh: Geavanceerde MongoDB-opdrachten rechtstreeks vanuit Visual Studio Code uitvoeren.

Notitie

De MongoDB-shell (mongosh) is niet opgenomen in de extensie. Het moet afzonderlijk worden geïnstalleerd en handmatig worden geconfigureerd.

Clusterbeheer

Blijf op de hoogte van uw resources:

  • Clusterdetails weergeven: controleer de laag, serverversie en resourcegebruik van uw cluster.

  • Tags beheren: Organiseer uw clusters met tags die worden gesynchroniseerd met Azure Portal.