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

Prerequisiti

• Un account Azure Cosmos DB per NoSQL configurato con un database e un contenitore. Usare una di queste guide introduttive qui per configurare una risorsa:
  • Portale
  • 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. Aprire 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. Selezionare quindi Installa.
4. Dopo l'installazione, ricaricare Visual Studio Code, se richiesto.

Connessione a un'istanza di 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:

   Nota

   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, nella visualizzazione albero di Azure individuare la sottoscrizione di Azure ed eseguire il drill-down in Azure Cosmos DB.

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

Eseguire query e visualizzare i 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 il Editor di query in Anteprima.

   

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

   

3. Esplorare i dati in altre visualizzazioni supportate:

   • Visualizzazione JSON: vedere la struttura dei dati non elaborati.

     

   • Visualizzazione 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 ai 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. Aprire 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. Selezionare quindi Installa.
4. Dopo l'installazione, ricaricare Visual Studio Code, se richiesto.

Connessione a un carico di lavoro MongoDB

Gestione dati intuitivo

Gestire facilmente i database in 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. Individuare il file *.json contenente i 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 modifica 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 query senza problemi:

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

Visualizzazioni dati flessibili

Esplorare i dati usando più visualizzazioni per prospettive diverse:

• Visualizzazione JSON: vedere la struttura di dati JSON non elaborata.

  

• Visualizzazione albero: spostarsi ed esplorare i dati annidati senza problemi.

  

• Visualizzazione tabella: analizzare rapidamente i dati ed eseguire il drill-down in 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: tornare ai livelli precedenti usando i percorsi di navigazione sotto la vista tabella.

  

Integrazione di Mongo Shell

La funzionalità della riga di comando è disponibile:

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

Gestione dei cluster

Rimanere al di sopra delle 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.