Avvio rapido: estensione PostgreSQL di Visual Studio Code per Azure HorizonDB (Anteprima)

L'estensione PostgreSQL per Visual Studio Code semplifica lo sviluppo e la gestione dei database PostgreSQL. Questa guida illustra come connettersi a un database PostgreSQL ed eseguire query all'interno di Visual Studio Code.

Lo stesso flusso di lavoro si applica se ci si connette a:

  • Un'installazione locale di PostgreSQL,
  • Un cluster Azure HorizonDB.

Prerequisiti

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

Installare l'estensione PostgreSQL

Per installare l'estensione PostgreSQL:

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

Dopo l'installazione, l'icona dell'estensione PostgreSQL viene visualizzata nella barra laterale 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.

  1. Selezionare l'icona dell'elefante sulla barra laterale per aprire la pagina dell'estensione PostgreSQL.
  2. Selezionare il pulsante Aggiungi connessione .
  3. Immettere i dettagli della connessione manualmente o incollare una stringa di connessione.
  4. Se si usa Azure, accedere all'account Azure e cercare l'istanza del database. Filtra per la sottoscrizione, il gruppo di risorse, il server / cluster e il nome del database. Sono elencati i cluster HorizonDB di Azure nelle sottoscrizioni a cui si ha accesso.

Formato stringa di connessione

Un cluster Azure HorizonDB espone due endpoint. Scegliere quello che corrisponde al carico di lavoro:

  • Endpoint di lettura/scrittura : si connette al database primario, che accetta sia letture che scritture. Utilizzare questo endpoint per le operazioni di scrittura dell'applicazione, le modifiche dello schema e le operazioni di lettura che devono accedere ai dati sottoposti al commit più recente.
  • Endpoint di lettura - Distribuisce automaticamente il carico delle connessioni su tutte le repliche a disponibilità elevata leggibili nel cluster. Usare questo endpoint per carichi di lavoro di scalabilità in lettura, reportistica e analisi. Attualmente sono supportate fino a quattro repliche a disponibilità elevata leggibili (destinate ad aumentare a 8), ciascuna dimensionata in modo identico come l'istanza primaria.

Entrambi i nomi host degli endpoint sono elencati nella pagina cluster Overview e nella pagina Replicas nel portale di Azure. Il formato stringa di connessione è il formato libpq standard:

# Read/write endpoint (primary)
psql "host=<cluster-name>.<region>.horizondb.azure.com port=5432 dbname=<database> user=<user> sslmode=require"

# Reader endpoint (load-balanced HA replicas)
psql "host=<cluster-name>-reader.<region>.horizondb.azure.com port=5432 dbname=<database> user=<user> sslmode=require"

Un modello comune consiste nel salvare due profili nel Gestione connessioni, uno per l'endpoint di lettura/scrittura e uno per l'endpoint lettore, e passare da un profilo all'altro in base all'attività.

Authentication

L'estensione supporta due metodi di autenticazione:

  • Nome utente/Password : immettere le credenziali del database direttamente nei campi di connessione.

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

Se il test ha esito negativo quando ci si connette a un database ospitato nel cloud, verificare che l'indirizzo IP del client sia consentito dalle regole del firewall del cluster (HorizonDB). Entrambi i servizi supportano attualmente l'accesso pubblico con l'elenco di indirizzi IP consentiti; il supporto degli endpoint privati in HorizonDB è in programma.

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:
    • Avviare una nuova query
    • Chat con questo database (avvia l'esperienza di @pgsql chat)
    • Connettersi con PSQL per avviare una psql connessione del terminale
  • 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.

In una connessione Azure HorizonDB è anche possibile elencare le estensioni consentite disponibili nel cluster con:

SELECT * FROM pg_available_extensions ORDER BY name;

Le estensioni di HorizonDB comuni che è possibile installare nel database includono vector, pg_diskannazure_ai, e age:

CREATE EXTENSION IF NOT EXISTS azure_ai;
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS pg_diskann;
CREATE EXTENSION IF NOT EXISTS age;

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.

Instradare letture e scritture su HorizonDB

Quando si dispone di profili sia per gli endpoint di lettura/scrittura sia per quelli di sola lettura, selezionare la connessione appropriata nel selettore di connessione del Editor di query prima di eseguire una query. Le operazioni di scrittura e il DDL devono essere eseguiti sull'endpoint di lettura/scrittura; l'endpoint di lettura accetta query di sola lettura e le distribuisce tra le repliche ad alta disponibilità.

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.

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

Quando si è connessi a un cluster Azure HorizonDB, Copilot seleziona il contesto di connessione in tempo reale, incluse le estensioni installate, in modo che le richieste possano sfruttare le funzionalità di HorizonDB, ad esempio pgvector, pg_diskann Filtro avanzato e funzioni di intelligenza artificiale azure_ai.

Per altre informazioni, vedere Quickstart: Configurare GitHub Copilot per l'estensione PostgreSQL in Visual Studio Code.

Connettersi con Visual Studio Code

L'opzione Aggiungi connessione nell'estensione PostgreSQL per Visual Studio Code semplifica la connessione al cluster horizonDB Azure. Questa funzionalità semplifica la configurazione guidandoti attraverso i dettagli di connessione necessari.

Usare il pulsante Aggiungi connessione per creare una nuova connessione al cluster HorizonDB. È possibile scegliere di precompilare la connessione con l'endpoint di lettura/scrittura o l'endpoint del lettore.

Confermare i requisiti

  • Nel riquadro laterale verificare che tutti i prerequisiti (Visual Studio Code e l'estensione 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 il riquadro laterale Connetti con Visual Studio Code con 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.

Fornire i dettagli di autenticazione

Selezionare il metodo di autenticazione preferito:

  • Autenticazione password: immettere manualmente il nome utente e la password.

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 del client sia consentito nel cluster Azure HorizonDB.
  • Per HorizonDB, verificare di connettersi all'endpoint corretto per il carico di lavoro. Le scritture devono essere destinate all'endpoint di lettura/scrittura, non all'endpoint lettore.
  • Se non si soddisfano i prerequisiti, il riquadro laterale fornisce commenti e suggerimenti e passaggi per risolvere il problema, inclusa la ripetizione della connessione.
  • Verificare che il nome utente e le credenziali siano corretti per il database.

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