Usare Visual Studio Code per connettersi ed eseguire query sulle istanze di Azure Cosmos DB

Visual Studio Code è un editor di codice versatile per Linux, macOS e Windows, che supporta numerose estensioni. Questa guida introduttiva illustra come connettersi ad Azure Cosmos DB per NoSQL e Azure Cosmos DB per MongoDB usando Visual Studio Code. Vengono illustrate le operazioni di base del database, tra cui l'esecuzione di query, l'inserimento, l'aggiornamento e l'eliminazione di dati.

Prerequisiti

• Un account Azure Cosmos DB per NoSQL configurato con un database e un contenitore. Utilizzare uno di questi avvii rapidi per configurare una risorsa:
  • Portal
  • interfaccia della riga di comando di Azure

Installare l'estensione

Per connettersi e gestire i dati in Azure Cosmos DB in Visual Studio, installare prima di tutto l'estensione Database di Azure.

1. Apri Visual Studio Code.
2. Accedere al riquadro Estensioni selezionando Visualizza > estensioni o usando il tasto di scelta rapida CTRL + MAIUSC + X in Windows e Comando + MAIUSC + X in macOS.
3. Nella barra di ricerca digitare DocumentDB per Visual Studio Code e selezionare l'estensione. Quindi, selezionare Installa.
4. Dopo l'installazione, se richiesto, ricaricare Visual Studio Code.

Connessione a Azure Cosmos DB per NoSQL

1. In Visual Studio Code passare al riquadro Azure (selezionare l'icona di Azure nella barra delle attività).

2. Accedere all'account Azure Cosmos DB per NoSQL tramite Microsoft Entra ID:

   Annotazioni

   Usare il controllo degli accessi in base al ruolo di Microsoft Entra ID quando si accede alle risorse di Azure Cosmos DB.

3. Dopo aver eseguito l'accesso, individuare nella struttura ad albero di Azure la propria sottoscrizione di Azure e scendere fino ad Azure Cosmos DB.

4. Selezionare un account esistente o fare clic con il pulsante destro del mouse per creare una nuova risorsa.

Interroga e visualizza i tuoi dati

I passaggi seguenti usano l'editor di query per eseguire una query e visualizzare i risultati della query:

1. Nel menu della raccolta fare clic con il pulsante destro del mouse sulla raccolta per aprire l'Editor di query in anteprima.

   

2. Esegui la query fornita nell'editor di query per visualizzare i dati in Visualizzazione tabella:

   

3. Esplorare i dati in altre visualizzazioni supportate:

   • Visualizzazione JSON: Visualizza la struttura dati grezza.

     

   • Visualizzazione ad albero: esplorare facilmente i dati annidati.

     

Visualizzare le metriche delle query e degli indici

Nell'editor di query, visualizzare altre metriche di query e indici per ottimizzare meglio le prestazioni delle query.

1. Selezionare la scheda Statistiche accanto a Risultati della query.

2. Per altre informazioni sulle definizioni delle metriche, vedere la documentazione sulle metriche di query.

Inserire, modificare ed eliminare documenti

• Modifica dei documenti in tempo reale: aggiungere, visualizzare, modificare ed eliminare immediatamente i documenti, con modifiche riflesse in tempo reale.

• Importa da JSON: caricare rapidamente i dati dai file JSON.

Esportare i risultati delle query

• Risultati del download: scaricare i risultati della query in file CSV o JSON.

Contenuti correlati

• Introduzione all'API for NoSQL
• Guida introduttiva di Node. js
• Avvio rapido per Python
• Guida di avvio rapido per Java
• Avvio rapido per Go

Prerequisiti

• Un account Azure Cosmos DB per NoSQL configurato con un database e un contenitore.
• Shell MongoDB (mongosh) installata per le interazioni da riga di comando (facoltativo ma consigliato).

Installare l'estensione

Per connettersi e gestire i dati in Azure Cosmos DB, è necessario installare l'estensione Database di Azure per Visual Studio Code.

1. Apri Visual Studio Code.
2. Accedere al riquadro Estensioni selezionando Visualizza > estensioni o usando il tasto di scelta rapida CTRL + MAIUSC + X in Windows e Comando + MAIUSC + X in macOS.
3. Nella barra di ricerca digitare DocumentDB per Visual Studio Code e selezionare l'estensione. Quindi, selezionare Installa.
4. Dopo l'installazione, se richiesto, ricaricare Visual Studio Code.

Connessione a un carico di lavoro MongoDB

Connettersi ora al carico di lavoro MongoDB in Azure Cosmos DB per MongoDB.

1. Nel pannello Area di lavoro espandere la sezione Account MongoDB.

2. Qui è possibile visualizzare tutti gli account MongoDB. Connettersi a un nuovo account MongoDB usando le credenziali.

   Annotazioni

   Tutti i cluster MongoDB connessi rimarranno elencati nella sezione Account MongoDB, anche dopo la chiusura di Visual Studio Code.

Gestione dati intuitiva

Gestisci facilmente i tuoi database all'interno di Visual Studio Code.

• Creare ed eliminare database/raccolte: creare o eliminare database e raccolte usando il menu di scelta rapida nell'account, nel database o nella raccolta nel pannello delle risorse.

• Importare da JSON: importare rapidamente i dati dai file JSON nella raccolta.

  • Avviare l'importazione
    1. Fare clic con il pulsante destro del mouse sul nome della raccolta nella visualizzazione risorse e scegliere Importa documenti nella raccolta.
    2. In alternativa, aprire la "Visualizzazione raccolta" facendo clic sulla voce Documenti della raccolta, quindi selezionare il pulsante Importa .
  • Selezionare file JSON
    1. Sfoglia per individuare il file *.json contenente i tuoi dati.
    2. Confermare di avviare il processo di importazione.

• Esporta dati: salvare raccolte o risultati di query come JSON per il backup o la condivisione.

  • Avviare l'esportazione:
    • Opzione 1
      1. Fare clic con il pulsante destro del mouse sul nome della raccolta nella visualizzazione risorse e scegliere Esporta documenti dalla raccolta per esportare l'intera raccolta.
    • Opzione 2
      1. Aprire la "Visualizzazione raccolta" facendo clic sulla voce Documenti della raccolta, quindi selezionare il pulsante Esporta .
      2. Scegliere di esportare l'intera raccolta o i risultati della query corrente.
  • Specifica file di destinazione:
    1. Immettere il nome e il percorso per il file *.json di destinazione.
    2. Confermare l'esportazione per iniziare a salvare i dati.

• Modifica documento in tempo reale: aggiungere, visualizzare, modificare ed eliminare documenti con aggiornamenti in tempo reale.

  • Apri la modifica del documento
    • Accedere alle opzioni di modifica dei documenti direttamente all'interno della "Visualizzazione raccolta". Questi controlli si trovano facilmente sopra la visualizzazione dati per facilitare l'accesso.
  • Azioni disponibili:
    • Aggiungi: crea nuovi documenti all'interno della raccolta.
    • Visualizza: consente di visualizzare il contenuto del documento selezionato.
    • Modifica: consente di modificare il contenuto dei documenti selezionati.
    • Elimina: rimuovere i documenti selezionati con le modifiche riflesse immediatamente.

Strumenti di query avanzati

Eseguire e perfezionare le tue query senza interruzioni:

• Risultati istantanei: visualizzare immediatamente i risultati della query nel formato preferito: tabella, JSON o visualizzazione albero.

  • Passare facilmente alle visualizzazioni usando il menu a discesa Visualizza .

• Eseguire direttamente query: scrivere ed eseguire query MongoDB con funzionalità come l'evidenziazione della sintassi e il completamento automatico.

  • Per eseguire la query, selezionare il pulsante Trova query o premere Ctrl/Cmd+Enter nell'editor di query.

Annotazioni

Attualmente sono supportate solo le query di filtro di ricerca, con funzionalità di query espanse presto disponibili.

Visualizzazioni dati flessibili

Esplorare i dati usando più visualizzazioni per prospettive diverse:

• Visualizzazione JSON: Visualizza la struttura dati JSON grezza.

  

• Vista ad albero: naviga ed esplora i dati annidati senza problemi.

  

• Visualizzazione Tabella: analizzare rapidamente i dati e approfondire i documenti annidati.

  • Per eseguire il drill-down: trovare voci con l'icona {} , che indicano oggetti incorporati. Fare doppio clic per espandere e visualizzare il contenuto.

  • Per tornare indietro: ritorna ai livelli precedenti usando i breadcrumb di navigazione sotto la Tabella di Visualizzazione.

  

Integrazione di Mongo Shell

La funzionalità della riga di comando è disponibile:

• Avviare mongosh: eseguire comandi MongoDB avanzati direttamente da Visual Studio Code.

Annotazioni

La shell MongoDB (mongosh) non è inclusa nell'estensione. Deve essere installato separatamente e configurato manualmente.

Gestione dei cluster

Gestisci al meglio le tue risorse

• Visualizzare i dettagli del cluster: controllare il livello, la versione del server e l'utilizzo delle risorse del cluster.

• Gestisci tag: organizzare i cluster con tag sincronizzati con il portale di Azure.