Condividi tramite

Avvio rapido: Connettersi ed eseguire query su un database con l'estensione PostgreSQL per Visual Studio Code

L'estensione PostgreSQL per Visual Studio Code è uno strumento potente progettato per semplificare lo sviluppo e la gestione dei database PostgreSQL. Questa guida illustra come connettersi a un database PostgreSQL ed eseguire query all'interno dell'ambiente Visual Studio Code.

Prerequisites

Prima di iniziare, verificare che siano stati scaricati e installati gli strumenti e le risorse appropriati.

Questi strumenti e risorse consentono di seguire questo articolo e sfruttare al meglio l'integrazione di GitHub Copilot per l'estensione PostgreSQL in Visual Studio Code.

Installare l'estensione PostgreSQL

Per installare l'estensione PostgreSQL:

  1. Aprire Visual Studio Code e passare alla visualizzazione Estensioni selezionando l'icona Estensioni nella barra delle attività o usando il comando Visualizza: Estensioni .
  2. Cercare PostgreSQL nel Marketplace delle estensioni.
  3. Selezionare l'estensione PostgreSQL creata da Microsoft e selezionare Installa.

Quando l'estensione è installata, la pagina PostgreSQL, rappresentata da un'icona a forma di elefante, viene visualizzata nella barra laterale di Visual Studio Code.

Aggiungere una connessione a PostgreSQL

Indipendentemente dal fatto che sia ospitato in locale o in un server remoto, la connessione a un database PostgreSQL è un passaggio fondamentale per la gestione e l'interazione con i dati. Questo processo implica la fornitura dei dettagli di connessione necessari, ad esempio l'indirizzo del server, la porta e le credenziali di autenticazione, per stabilire un collegamento sicuro tra l'applicazione client e il database. Con l'estensione PostgreSQL per Visual Studio Code, è possibile connettersi facilmente al database e usare strumenti avanzati per eseguire query, gestire ed esplorare i dati in modo efficiente.

  1. Selezionare l'icona dell'elefante sulla barra laterale per aprire la pagina dell'estensione PostgreSQL.

  2. Selezionare il pulsante Aggiungi connessione .

  3. Immettere manualmente i dettagli della connessione o usare il formato della stringa di connessione:

      psql -h <server>.postgres.database.azure.com -p 5432 -U

  4. Se si usa Azure, accedere all'account Azure e cercare l'istanza del database. Filtrare in base alla sottoscrizione, al gruppo di risorse, al server e al nome del database.

Authentication

L'estensione supporta due metodi di autenticazione:

  • Nome utente/Password: immettere le credenziali del database direttamente nei campi di connessione.
  • Autenticazione ID Microsoft Entra: aggiungere l'account ID Microsoft Entra per i database ospitati in Azure.

Screenshot della finestra di dialogo di connessione dell'estensione PostgreSQL per Visual Studio Code.

Testare e salvare la connessione

  1. Selezionare Test connessione per verificare i dettagli della connessione.
  2. Al termine del test, nella casella di test viene visualizzato un segno di spunta.
  3. Selezionare Connetti per stabilire la connessione.
  4. La connessione viene salvata e visualizzata automaticamente nella finestra Connessioni.

Esplorare gli oggetti di database

Esplora oggetti offre una visualizzazione gerarchica degli oggetti di database:

  • Espandi l'elemento del database per visualizzare schemi, tabelle, viste, funzioni e le stored procedure.
  • Fare clic con il pulsante destro del mouse sul database per visualizzare le opzioni per:
    • Avvia una nuova query
    • Chat con questo database (avvia l'esperienza di chat pgsql)
    • Connettersi con PSQL per avviare una connessione del terminale psql
  • Fare clic con il pulsante destro del mouse su una tabella e selezionare Seleziona primi 1000 per visualizzarne i dati. La query viene aperta nell'editor di query e i risultati vengono visualizzati nella scheda Visualizzatore risultati.

Eseguire query

Usare l'editor di query per creare una bozza ed eseguire query SQL:

  • Sfruttare IntelliSense compatibile con il contesto per completare automaticamente parole chiave e nomi di oggetti SQL.
  • Usare l'evidenziazione della sintassi e la formattazione automatica per migliorare la leggibilità e l'accuratezza.
  • Accedere alle query eseguite in precedenza dalla sezione Cronologia delle query.

Esaminare i risultati delle query

Il Visualizzatore risultati offre funzionalità avanzate per interagire con i risultati della query:

  • Esportare i risultati in formati CSV, JSON o Excel per ulteriori analisi.
  • Usare le opzioni di ricerca, filtro e ordinamento per perfezionare i dati.
  • Le visualizzazioni dati persistenti mantengono il contesto mentre si passa da una scheda all'altra.

Usare GitHub Copilot per assistenza avanzata

L'integrazione di GitHub Copilot migliora l'esperienza di sviluppo di PostgreSQL fornendo suggerimenti sul codice basati sull'intelligenza artificiale, suggerimenti per l'ottimizzazione delle query e assistenza interattiva per il database. Questa funzionalità consente di semplificare il flusso di lavoro, ridurre i tempi di sviluppo e ottenere informazioni più approfondite sulle operazioni del database. Questa sezione illustra i passaggi per attivare e usare Copilot all'interno dell'estensione PostgreSQL per Visual Studio Code.

Assicurarsi che siano installate le estensioni GitHub Copilot e Copilot Chat.

Accedere all'account GitHub e abilitare l'agente @pgsql Chat di Copilot nelle impostazioni dell'estensione.

Richieste di database interattive

Fare clic con il tasto destro su un database e selezionare Chatta con questo database per interagire con Copilot.

Scrivere richieste come l'esempio seguente per ricevere informazioni dettagliate e suggerimenti.

@pgsql tell me about the tables in the HR schema

Per altre informazioni, vedere Configurare GitHub Copilot.

Connettersi a Database di Azure per PostgreSQL con Visual Studio Code

Connettiti a un'istanza del server PostgreSQL flessibile del Database di Azure utilizzando Visual Studio Code seguendo questa procedura:

  1. Effettua l'accesso al portale di Azure e individua il server flessibile di Azure Database per PostgreSQL.
  2. Vai sulla pagina Panoramica dell'istanza del server.

Connettersi con Visual Studio Code

L'opzione "Connetti con Visual Studio Code" nel portale di Azure semplifica la connessione all'istanza flessibile del server di Database di Azure per PostgreSQL. Questa funzionalità semplifica la configurazione guidandoti attraverso i prerequisiti necessari e configurando automaticamente i dettagli della connessione. Usando questa integrazione, è possibile stabilire rapidamente una connessione e gestire il database direttamente nell'ambiente di Visual Studio Code.

  • Selezionare il pulsante principale "Connetti con Visual Studio Code" nella pagina Panoramica.
  • Viene visualizzato un riquadro laterale che elenca i requisiti per la connessione tramite Visual Studio Code.

Screenshot del portale di Azure che mostra un'istanza di Database di Azure per PostgreSQL con il pulsante Connetti con Visual Studio Code.

Confermare i requisiti

  • Nel riquadro laterale verificare che tutti i prerequisiti (estensione Visual Studio Code e PostgreSQL) siano soddisfatti selezionando le caselle di controllo appropriate.

  • Se necessario, scaricare Visual Studio Code e l'estensione usando i collegamenti nel riquadro laterale.

  • Facoltativamente, compilare parametri di connessione, ad esempio il nome predefinito del database, il metodo di autenticazione e il pool di connessioni.

    Screenshot del portale di Azure che mostra un'istanza di Database di Azure per PostgreSQL con il pannello Connetti con Visual Studio Code. Il pulsante apri in Visual Studio Code è evidenziato.

Aprire in Visual Studio Code

  • Selezionare il pulsante Apri in Visual Studio Code nel riquadro laterale.
  • Se Per aprire Visual Studio Code e l'estensione sono necessari più di 40 secondi, nel riquadro laterale viene visualizzato un pulsante Riprova apertura in Visual Studio Code .

Avviare Visual Studio Code

  • Se Visual Studio Code è installato e in esecuzione, la finestra di dialogo di connessione dell'estensione PostgreSQL viene avviata automaticamente.
  • Se Visual Studio Code è installato ma non aperto, viene avviato entro circa 40 secondi, seguito dalla finestra di dialogo di connessione.

Riempimento automatico dei dettagli della connessione

Viene visualizzata la finestra di dialogo connessione nell'estensione PostgreSQL e il campo Nome del server compila automaticamente l'endpoint server.

Screenshot della finestra di dialogo di connessione dell'estensione PostgreSQL per Visual Studio Code con i dettagli del nome del server pre-compilati.

Specificare i dettagli di autenticazione

Selezionare il metodo di autenticazione preferito:

  • Autenticazione password: immettere manualmente il nome utente e la password.
  • Entra Authentication: Inserisci le credenziali del tuo account Azure.

Specificare altri dettagli di connessione, ad esempio Nome profilo, Nome database (facoltativo), Gruppo di server e Numero porta.

Salvare e connettersi

Selezionare il pulsante Salva e connetti per stabilire la connessione. Dopo la connessione, espandere il server nell'albero esplora oggetti per visualizzare database, schemi e tabelle oppure usare lo strumento di query predefinito per gestire gli oggetti di database.

Troubleshoot

Se si verificano problemi durante il processo di connessione:

  • Verificare che Visual Studio Code e l'estensione PostgreSQL siano installati e abilitati.

  • Verificare che l'indirizzo IP sia consentito nelle impostazioni del firewall di Database di Azure per PostgreSQL.

  • Se non si soddisfano i prerequisiti, il riquadro laterale fornisce commenti e suggerimenti e passaggi per risolvere il problema, inclusa la ripetizione della connessione.

Feedback e supporto

Per bug, richieste di funzionalità e problemi, usare lo strumento di feedback predefinito in Visual Studio Code. È possibile completare questo processo di feedback tramite il menu Guida di Visual Studio Code o il riquadro comandi PGSQL.

  • Menu Aiuto

    • Vai a Aiuto > Segnala un problema

  • Palette dei comandi

    • Aprire il riquadro comandi con Ctrl + Shift + P ed eseguire: PGSQL: Report Issue

Contenuti correlati

  • Last updated on