Che cos'è l'estensione PostgreSQL per Visual Studio Code? (anteprima)

L'estensione PostgreSQL per Visual Studio Code semplifica la gestione e lo sviluppo di database PostgreSQL. È possibile connettersi ai database PostgreSQL, scrivere ed eseguire query e gestire oggetti di database senza lasciare Visual Studio Code.

L'estensione si integra con i servizi PostgreSQL gestiti da Azure, tra cui:

  • Azure HorizonDB: un servizio PostgreSQL nativo del cloud creato per carichi di lavoro aziendali di livello 1. HorizonDB offre un'architettura disaggregata di storage e calcolo, commit a bassa latenza, failover rapido, scalabilità in lettura con bilanciamento del carico tra repliche a disponibilità elevata leggibili e un'integrazione avanzata dell'IA.

La stessa estensione funziona su entrambi i servizi. Laddove il comportamento differisca (ad esempio, per quanto riguarda gli endpoint di connessione o i metodi di autenticazione supportati), ciò viene indicato nelle sezioni seguenti.

Come installare l'estensione

È possibile installare l'estensione PostgreSQL direttamente da Extensions Marketplace in Visual Studio Code. Segui questi passaggi:

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

Quando si installa l'estensione, viene visualizzata un'icona di elefante che rappresenta la pagina PostgreSQL nella barra laterale di Visual Studio Code.

Features

L'estensione PostgreSQL per Visual Studio Code fornisce le funzionalità seguenti per Azure HorizonDB.

Gestione connessioni

Gestione connessione semplifica la connessione ai database PostgreSQL locali e ospitati nel cloud. Le funzionalità chiave includono:

  • Supporto per più profili di connessione, in modo da poter connettersi e gestire più istanze di PostgreSQL affiancate, inclusa una combinazione di cluster HorizonDB Azure.
  • Analisi delle stringhe di connessione per una connettività senza problemi, sia che ci si connetta a un database locale, un cluster Azure HorizonDB.
  • Integrazione con Azure HorizonDB per l'esplorazione diretta e il filtro delle istanze in base a sottoscrizione, gruppo di risorse, server/cluster e database.

endpoint di connessione di Azure HorizonDB

Azure HorizonDB espone due endpoint, che è possibile aggiungere come profili di connessione separati nell'estensione:

  • Endpoint di lettura/scrittura : si connette al database primario, che accetta transazioni di lettura e scrittura. Utilizzare questo endpoint per le scritture dell'applicazione, le modifiche dello schema e qualsiasi carico di lavoro di lettura che richieda i dati dell'ultimo commit. L'endpoint è elencato nella pagina Overview e nella pagina Replicas nel portale di Azure.
  • Endpoint di lettura: distribuisce automaticamente il carico delle connessioni in sola lettura 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.

Un modello tipico consiste nel salvare due profili nella Gestione connessioni, uno puntato all'endpoint di lettura/scrittura e uno puntato all'endpoint lettore, e passare da un profilo all'altro nell'Esplora oggetti in base all'attività.

Esplora oggetti

Esplora oggetti avanzato offre una visualizzazione gerarchica degli oggetti di database, semplificando l'esplorazione e la gestione di schemi, tabelle, viste e funzioni. Le funzionalità rilevanti includono:

  • Opzioni di filtro avanzate per individuare rapidamente oggetti specifici.
  • Funzionalità per creare, modificare ed eliminare oggetti di database come tabelle, viste e procedure archiviate.
  • Visualizzazione degli schemi e delle relazioni del database per una navigazione semplificata.
  • Per Azure HorizonDB, è possibile esaminare le 55 estensioni consentite disponibili nel cluster tramite la vista del catalogo pg_available_extensions direttamente dal Editor di query.

Editor di interrogazioni

L'editor di query migliora l'esperienza di creazione ed esecuzione delle query con:

  • IntelliSense compatibile con il contesto per il completamento automatico di parole chiave SQL, nomi di tabella e funzioni.
  • Evidenziazione della sintassi e formattazione automatica per migliorare la leggibilità delle query.
  • Rilevamento della cronologia delle query, in modo da poter riutilizzare le query eseguite in precedenza.

Visualizzatore risultati

Il Visualizzatore risultati consente di interagire con i risultati delle query tramite funzionalità come:

  • Esportazione dei risultati in formati CSV, JSON o Excel.
  • Opzioni di ricerca, filtro e ordinamento per analizzare i dati in modo efficiente.
  • Visualizzazioni dati persistenti per mantenere il contesto durante lo spostamento tra le schede.

Visualizzazione dello schema

Il visualizzatore di schemi offre una visualizzazione interattiva basata su diagramma della struttura del database senza scrivere alcun sql. Fare clic con il pulsante destro del mouse su un database (o su qualsiasi oggetto sottostante) nella Esplora oggetti e selezionare Visualize Schema per avviare il visualizzatore.

Le funzionalità principali includono:

  • Visualizzazione tabella completa : viene eseguito il rendering di ogni tabella come scheda che mostra le colonne e i tipi di dati.
  • Linee di relazione : le relazioni di chiave esterna tra le tabelle vengono disegnate come linee di connessione, in modo da visualizzare a colpo d'occhio il modo in cui il modello di dati si integra.
  • Organizzazione basata su schema : le tabelle sono raggruppate in base allo schema padre (ad esempio, public, hr, ecom), semplificando lo spostamento tra database di grandi dimensioni.
  • Mostra/nascondi per schema : attiva o disattiva gli interi schemi per concentrarsi solo sulle parti del modello di cui ti interessa e per mantenere i diagrammi leggibili in database di grandi dimensioni.
  • Spostamento e zoom - Consente di navigare in diagrammi di grandi dimensioni con i controlli standard di spostamento, zoom e adattamento allo schermo.

La visualizzazione dello schema funziona su qualsiasi database connesso, inclusi i cluster PostgreSQL locali e Azure HorizonDB.

Visualizzazione del grafico Apache AGE

Il visualizzatore di grafi Apache AGE consente di eseguire query Cypher di Apache AGE ed esplorare i risultati come un grafo nodo-arco interattivo. L'estensione rileva automaticamente i risultati della query del grafo e li visualizza in un esploratore visivo con callout su ogni nodo, controlli di zoom e pan, supporto per l'esportazione e stili che si adattano al tema.

L'estensione age è consentita per impostazione predefinita in Azure HorizonDB, in modo che i carichi di lavoro dei grafici possano essere eseguiti in un cluster HorizonDB senza configurazione aggiuntiva. Gli stessi requisiti si applicano quando si creano query cypher su HorizonDB:

  • Restituisce oggetti completi, non proprietà scalari : il visualizzatore di gragrafi necessita di oggetti vertici e archi completi. Le query che estraggono proprietà scalari (RETURN p.name, p.title) restituiscono valori di testo normale e non eseguiranno il rendering nel visualizzatore. Restituire invece gli oggetti completi e denominare la variabile di relazione:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Imposta disp_label per un testo descrittivo del nodo - Senza disp_label, i nodi visualizzano gli id interni. Impostare questa proprietà in modo che il visualizzatore mostri etichette utili:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    SET a.disp_label = a.title
    SET b.disp_label = b.title
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Trova la corrispondenza tra le colonne di output e gli oggetti restituiti : la clausola wrapper AS (...) deve avere una colonna per ogni oggetto restituito. Per le query multi-hop, includi ogni nodo intermedio e ogni arco:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r1:BOUGHT_TOGETHER]->(mid:Product)-[r2:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r1, mid, r2, b
$$) AS (a agtype, r1 agtype, mid agtype, r2 agtype, b agtype);

Integrazione dell'intelligenza artificiale (Azure HorizonDB)

Quando si è connessi a un cluster Azure HorizonDB, l'estensione offre una superficie di creazione di prima classe per le funzionalità di intelligenza artificiale di HorizonDB, esposte come estensioni e funzioni PostgreSQL standard:

  • pgvector
    • Tipo di dati vettoriale e operatori di similarità.
  • pg_diskann
    • Indice vettoriale ad alte prestazioni con filtro avanzato, che valuta i WHERE predicati durante l'attraversamento del grafo vettoriale in modo che le query di somiglianza filtrate restituiscano più velocemente e in modo più coerente.
  • azure_ai
    • Funzioni di intelligenza artificiale come azure_ai.generate(), azure_ai.is_true()azure_ai.extract(), e azure_openai.create_embeddings().
  • Gestione modelli di intelligenza artificiale (anteprima limitata)
    • Se abilitata nel cluster, HorizonDB effettua automaticamente il provisioning di un modello di chat predefinito (gpt-5) e di un modello di incorporamento predefinito (text-embedding-3-small) tramite Microsoft Foundry, installa e configura azure_ai e collega le funzioni di intelligenza artificiale a tali modelli gestiti, senza dover gestire manualmente le chiavi. È anche possibile registrare le proprie distribuzioni di Microsoft Foundry (Bring Your Own Model) e chiamarle tramite alias dalle stesse funzioni di intelligenza artificiale.

È possibile creare ed eseguire questi carichi di lavoro di intelligenza artificiale direttamente dalla Editor di query e il Visualizzatore risultati esegue il rendering inline del vettore e dell'output JSONB.

Pipeline e flussi di lavoro

Quando si è connessi a un cluster Azure HorizonDB con pipeline di intelligenza artificiale o pg_durable flussi di lavoro, l'estensione fornisce la vista Pipeline e flussi di lavoro per consultare la cronologia di esecuzione e monitorare lo stato delle esecuzioni.

Accedervi facendo clic con il pulsante destro del mouse sul database e selezionando Pipeline e flussi di lavoro. Verranno visualizzate due schede:

  • Pipeline di intelligenza artificiale: visualizzare le definizioni della pipeline, esaminare le esecuzioni e tenere traccia dei grafici di esecuzione con tipi di passaggio codificati a colori (blu per origine/sink, verde per l'elaborazione, rosa per le chiamate esterne). Usare questa opzione per verificare il comportamento della pipeline e controllare lo stato di esecuzione, gli ID di esecuzione, gli orari di inizio e la durata.
  • Flussi di lavoro: esaminare pg_durable le istanze del flusso di lavoro con schede per grafici, analisi della tempistica e risultati. Passare da un'esecuzione del flusso di lavoro alla relativa definizione della pipeline correlata per il confronto e la risoluzione dei problemi.

Questa vista elimina la necessità di passare tra query SQL e l'editor, semplificando il monitoraggio di carichi di lavoro e pg_durable orchestrazioni di intelligenza artificiale a esecuzione prolungata.

Integrazione di GitHub Copilot

Questa estensione si integra con GitHub Copilot per offrire assistenza basata sull'intelligenza artificiale personalizzata per lo sviluppo PostgreSQL. Con comandi come @pgsql, è possibile eseguire query sul database, ottimizzare lo schema e richiedere Copilot per eseguire operazioni SQL specifiche su un cluster HorizonDB Azure. Copilot seleziona il contesto di connessione dinamica, incluse le estensioni installate nella destinazione, quindi i suggerimenti su una connessione HorizonDB sono consapevoli di pgvector, pg_diskann, azure_ai e age.

Sistemi operativi supportati

L'estensione PostgreSQL funziona con i sistemi operativi seguenti:

  • Windows
  • macOS
  • Linux

L'estensione supporta varie distribuzioni linux, tra cui Ubuntu, Fedora e Red Hat Enterprise Linux.

Feedback e supporto

Per bug, richieste di funzionalità e problemi, usare lo strumento di feedback predefinito in Visual Studio Code. È possibile completare questo 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