Estensione MSSQL per Visual Studio Code

L'estensione MSSQL per Visual Studio Code supporta gli sviluppatori che creano applicazioni che usano Azure SQL (inclusi database SQL di Azure, Istanza gestita di SQL di Azure e SQL Server in Macchine virtuali di Azure), database SQL in Microsoft Fabric e SQL Server. Fornisce strumenti per la connessione ai database, la gestione e la progettazione di schemi, l'esplorazione di oggetti di database, l'esecuzione di query Transact-SQL (T-SQL) e la visualizzazione dei piani di esecuzione delle query in Visual Studio Code.

L'estensione include IntelliSense, l'esecuzione di script T-SQL e opzioni personalizzabili per i database locali e basati sul cloud.

Installa l'estensione MSSQL per Visual Studio Code

Per iniziare a usare lo sviluppo SQL in Visual Studio Code, installare l'estensione MSSQL:

  1. Aprire Visual Studio Code.
  2. Selezionare l'icona Estensioni nella barra delle attività (CMD+MAIUSC+X in macOS o CTRL+MAIUSC+X in Windows e Linux).
  3. Nella barra di ricerca digitare mssql.
  4. Trovare SQL Server (mssql) nei risultati e selezionarlo.
  5. Selezionare il pulsante Installa .

Screenshot dell'estensione MSSQL per Visual Studio Code.

Suggerimento

Si sa che l'estensione è installata correttamente quando l'icona MSSQL viene visualizzata nella barra delle attività e la visualizzazione Connessioni diventa disponibile.

Features

L'estensione MSSQL per Visual Studio Code supporta SQL Server, Azure SQL e il database SQL in Fabric.

La tabella seguente offre una panoramica delle funzionalità disponibili nell'estensione MSSQL, il relativo stato di rilascio e i collegamenti alla documentazione dettagliata.

Feature Condizione Descrizione
Finestra di dialogo di connessione GA Connetti usando parametri, stringhe di connessione o esplora di Azure
Esplora oggetti GA Esplorare e filtrare gli oggetti di database con la ricerca sensibile al tipo
Riquadro dei risultati della query GA Visualizzare, ordinare, copiare ed esportare i risultati delle query
Visualizzatore del piano di query GA Analizzare i piani di esecuzione con lo spostamento interattivo dei nodi
Progettazione tabelle GA Creare e gestire tabelle con un'interfaccia visiva
Schema designer GA Modellazione di schemi visivi con trascina e rilascia e layout automatico
Confronto schemi GA Confrontare e sincronizzare gli schemi tra database o DACPAC
Integrazione con GitHub Copilot GA Sviluppo SQL assistito dall'intelligenza artificiale con chat in linguaggio naturale e modalità agente
Container locali di SQL Server GA Creare e gestire contenitori di SQL Server in locale
Visualizza e modifica i dati GA Esplorare e modificare i dati della tabella inline senza scrivere DML
Applicazione a livello dati (DACPAC e BACPAC) GA Distribuire, estrarre, importare ed esportare file DACPAC e BACPAC
Integrazione Fabric GA Esplorare le aree di lavoro di Fabric ed effettuare il provisioning di database SQL
Gestione del database GA Creare, rinominare ed eliminare database da Esplora oggetti
Backup e ripristino GA Eseguire il backup dei database su disco o URL e ripristinare dai backup
Ricerca di oggetti nel database GA Trova tabelle, viste, funzioni e stored procedure con ricerca consapevole del tipo
Importa file flat GA Importare .csv file e .txt in nuove tabelle di SQL Server
Query profiler GA Monitoraggio delle attività del database in tempo reale con eventi estesi
Dashboard delle prestazioni delle query Anteprima pubblica Analizza i dati del Query Store, confronta le prestazioni delle query e ripassa la cronologia, le attese e i piani di esecuzione
Schema designer con GitHub Copilot GA Progettazione dello schema del linguaggio naturale con rilevamento delle modifiche visive e generazione di script ORM
Data API builder GA Creare endpoint REST, GraphQL e MCP per i database SQL
Notebook SQL GA Notebook SQL basati su Jupyter con risultati avanzati e supporto multi kernel
Formattatore SQL GA Formatta T-SQL su richiesta o al salvataggio con opzioni di formattazione configurabili
Integrazione Azure GA Effettuare il provisioning di database Azure SQL direttamente da Visual Studio Code, a partire dal livello gratuito
Procedura guidata di distribuzione da locale al cloud Anteprima pubblica Distribuisci lo schema del database locale oppure schema e dati in un database SQL di Azure di livello gratuito con i controlli di compatibilità
Configurazione dei collegamenti rapidi GA Gestisci le scorciatoie da tastiera per le query usate più di frequente e altri comandi dell'editor

Finestra di dialogo di connessione

La finestra di dialogo Connessione offre un'interfaccia intuitiva per la connessione ai database ospitati in SQL di Azure (incluso il database SQL di Azure, Istanza gestita di SQL di Azure e SQL Server in macchine virtuali di Azure), il database SQL in Fabric o SQL Server. Offre più opzioni di input per soddisfare diversi scenari:

  • Parametri: Inserisci dettagli di connessione individuali come nome server, nome database, nome utente e password.

  • Connection String: Inserisci direttamente una stringa di connessione completa per configurazioni più avanzate.

  • Sfoglia Azure: Sfoglia le istanze di database disponibili e i database nel tuo account Azure, con opzioni per filtrare per abbonamento, gruppo di risorse e posizione.

  • Gruppi di connessione: Organizza gli ambienti raggruppando le connessioni in cartelle e assegnando colori per un'identificazione visiva rapida. Assegnare o modificare facilmente un gruppo durante la creazione o la modifica di una connessione.

La finestra di dialogo di connessione include i pannelli Connessioni salvate e Connessioni recenti per semplificare la riconnessione ai server usati in precedenza. Il layout supporta la modifica e il salvataggio dei dettagli della connessione e semplifica il passaggio tra server o database.

Screenshot della finestra di dialogo di connessione.

Operazioni di database

L'estensione MSSQL offre strumenti predefiniti per le operazioni di database comuni, tra cui:

  • Gestione dei database: Creare, rinominare e eliminare database direttamente dall'Esplora oggetti.
  • Ricerca di oggetti nel database: trova tabelle, visualizzazioni, funzioni e procedure memorizzate con ricerca consapevole del tipo e azioni contestuali.
  • Backup e ripristino: eseguire il backup dei database su disco o Archiviazione BLOB di Azure e ripristinare da backup esistenti, file di backup o Archiviazione BLOB di Azure.
  • Importa file flat: Importa .csv e .txt file in nuove tabelle di SQL Server con una procedura guidata.

Esplora oggetti (filtro)

Esplora oggetti consente di esplorare gli oggetti di database, ad esempio database, tabelle, viste ed elementi di programmabilità. Il filtro consente di trovare oggetti specifici all'interno di gerarchie di database di grandi dimensioni:

  • Applica filtri: filtra gli oggetti del database per proprietà come nome, proprietario o data di creazione. È possibile applicare filtri a più livelli, inclusi database, tabelle, viste e programmabilità.

  • Modifica filtri: Affina o aggiorna i filtri esistenti per restringere ulteriormente l'elenco degli oggetti.

  • Cancella filtri: Rimuovi i filtri applicati per visualizzare tutti gli oggetti all'interno della gerarchia.

Screenshot della funzione filtro di Object Explorer.

Progettazione tabelle

Per utilizzare questa funzione, clicca con il tasto destro su una tabella in Esplora oggetti e seleziona Modifica Struttura della Tabella.

Il Progettista di Tabelle offre un'interfaccia visiva per la creazione e la gestione di tabelle.

  • Colonne: Aggiungi nuove colonne, imposta tipi di dati, definisci la nullabilità e specifica valori predefiniti. È anche possibile designare una colonna come chiave primaria o colonna Identity direttamente all'interno dell'interfaccia.

  • Chiave primaria: definisci una o più colonne come chiave primaria per la tua tabella, assicurandoti che ogni riga sia identificabile in modo univoco.

  • Indici: Crea e gestisci indici per migliorare le prestazioni delle query aggiungendo colonne extra come indici per un recupero dei dati più veloce.

  • Chiavi esterne: Definisci le relazioni tra tabelle aggiungendo chiavi esterne che fanno riferimento a chiavi primarie in altre tabelle, garantendo l'integrità dei dati tra le tabelle.

  • Vincoli CHECK: Imposta regole per imporre condizioni specifiche sui dati inseriti, come intervalli di valori o pattern.

  • Opzioni avanzate: Configura proprietà e comportamenti più sofisticati, come il controllo delle versioni di sistema e le tabelle ottimizzate per la memoria.

All'interno della finestra di progettazione, il pannello Script as Create fornisce uno script T-SQL generato automaticamente che riflette la progettazione della tabella. Sono disponibili le seguenti opzioni:

  • Pubblica: applica le modifiche direttamente al database selezionando Pubblica. Questa azione usa DacFX (Data-tier Application Framework) per distribuire gli aggiornamenti dello schema.

  • Copia script: Copia lo script T-SQL generato dal pannello di anteprima per l'esecuzione manuale oppure aprilo direttamente nell'editor per ulteriori aggiustamenti e modifiche necessarie.

Screenshot della funzione designer di tabelle.

Visualizzare e modificare i dati

Per utilizzare questa funzione, clicca doppiamente su una tabella in Esplora oggetti oppure clicca con il tasto destro su una tabella per aprire il menu contestuale e selezionare Modifica dati della tabella.

I dati della tabella si aprono in una griglia di dati all'interno di una nuova scheda editor. Vedi il contenuto in un layout familiare, simile a un foglio di calcolo, con controlli di paginazione basati sulle righe configurate per pagina.

Le funzionalità principali includono:

  • Modifica in linea: Aggiorna i valori delle celle direttamente all'interno della griglia. Le modifiche vengono convalidate in tempo reale e restituiscono un messaggio di errore per gli input non corretti, ad esempio tipi di dati non validi o violazioni di un vincolo. La griglia evidenzia la cella con l'input errato in rosso.

  • Aggiungi ed elimina righe: inserisci nuove righe o elimina quelle esistenti, così potrai modificare rapidamente i dati durante lo sviluppo e i test.

  • Paginazione: Naviga tra grandi dataset utilizzando controlli di paging integrati.

  • Salva modifiche: tutte le modifiche rimangono in stato in sospeso finché non selezioni Salva modifiche, così hai il controllo completo su quando gli aggiornamenti vengono confermati nel database.

  • Mostra script: Questo riquadro visualizza uno script DML di sola lettura che riflette tutte le azioni eseguite nella griglia dati in tempo reale. Usare lo script per esaminare le operazioni DML sottostanti prima di salvare le modifiche.

Screenshot della schermata Modifica dati.

Pannello dei risultati della query

I risultati delle query vengono visualizzati nel pannello inferiore di Visual Studio Code, insieme al terminale integrato, all'output, alla console di debug e ad altri strumenti.

Suggerimento

È possibile aprire i risultati della query in una nuova scheda per una visualizzazione espansa, simile all'esperienza precedente.

Le funzionalità principali del riquadro Risultati query includono:

  • Visualizzazione griglia: Visualizza i risultati della query in un formato a griglia familiare, così puoi facilmente ispezionare i dati. È possibile visualizzare i risultati in una nuova scheda per una visualizzazione più chiara e organizzata.

  • Opzioni di copia: Fai clic destro all'interno della griglia dei risultati per accedere a opzioni come Seleziona tutto, Copia, Copia con Intestazioni e Copia Intestazioni, rendendo comodo trasferire dati per altri usi.

  • Salva risultati della query: include la possibilità di salvare i risultati della query in più formati come JSON, Excel e CSV, così puoi lavorare con i dati al di fuori di Visual Studio Code.

  • Ordinamento inline: Puoi ordinare i dati selezionando direttamente le intestazioni delle colonne nella visualizzazione dei risultati della query. L'ordinamento può essere eseguito in ordine crescente o decrescente per semplificare l'analisi di subset specifici dei dati.

  • Piano stimato: Il pulsante Piano stimato appare come un'icona di diagramma di flusso, situata nella barra degli strumenti della query accanto al pulsante Esegui query . Genera un piano di esecuzione stimato senza eseguire la query, quindi è possibile esaminare il modo in cui Query Optimizer elabora la query.

  • Abilita piano effettivo: Il pulsante Abilita piano effettivo , situato dopo il pulsante Piano stimato , mostra il piano di query effettivo per le query eseguite. Usare questa opzione per identificare colli di bottiglia e inefficienze.

Screenshot della funzione dei risultati della query.

Suggerimento

È possibile personalizzare il comportamento dei risultati della query usando l'impostazione mssql.openQueryResultsInTabByDefault . Se impostato su true, i risultati della query vengono aperti in una nuova scheda per impostazione predefinita, consentendo di declutter l'area di lavoro.

La nuova esperienza Results Grid è disponibile in anteprima e include miglioramenti nella gestione dello stato, nelle prestazioni e nella personalizzazione delle colonne, come il congelamento, la visualizzazione o l'occultamento delle colonne. È abilitata per impostazione predefinita. Per modificare questa impostazione, modifica mssql.preview.betaResultsGrid nelle impostazioni di Visual Studio Code.

Visualizzatore piano di query

Il visualizzatore piano di query visualizza i piani di esecuzione per le query SQL. Illustra in che modo l'ottimizzatore delle query processa ogni operazione, in modo da identificare i colli di bottiglia e ottimizzare le query.

Le funzionalità e le funzionalità principali includono:

  • Navigazione del nodo: ogni passaggio del piano di esecuzione appare come un nodo. È possibile interagire con il piano in modi diversi. Selezionare i nodi per visualizzare le descrizioni comando o informazioni dettagliate su operazioni specifiche. Comprimere o espandere alberi dei nodi per semplificare la visualizzazione e concentrarsi sulle aree chiave del piano di query.
  • Controlli zoom: Il visualizzatore offre opzioni di zoom flessibili per aiutarti ad analizzare il piano in dettaglio. È possibile ingrandire o ridurre il livello di dettaglio. Usa la funzionalità zoom per adattare per ridimensionare la visualizzazione e far entrare l'intero progetto sullo schermo. Impostare livelli di zoom personalizzati per esaminare con precisione elementi specifici.
  • Metriche e evidenziazione: la barra degli strumenti delle metriche ti aiuta ad analizzare i principali indicatori di performance e a mettere in evidenza le operazioni costose. Selezionare le metriche, ad esempio Tempo trascorso effettivo, Costo, Costo sottoalbero, Numero di righe lette dall'elenco a discesa per identificare colli di bottiglia. Usare queste metriche per cercare nodi specifici all'interno del piano di query per un'analisi più approfondita.

La barra laterale destra consente di accedere rapidamente ad altre azioni:

  • Salva il piano: Salva il piano di esecuzione attuale per riferimento futuro.
  • Open XML: Apri la rappresentazione XML del piano di query per ispezionare i dettagli a livello di codice.
  • Apri query: visualizza la query che ha generato il piano di esecuzione direttamente dalla barra degli strumenti.
  • Attiva/disattiva i tooltip: Abilita o disabilita tooltip per maggiori dettagli su ciascun nodo.
  • Proprietà: Visualizza le proprietà di ciascun nodo nel piano di esecuzione, con opzioni per ordinare per importanza o alfabeticamente.

Screenshot della funzione di visualizzazione del piano di query.

Configurazione dei scorciatoie

Usa Shortcuts Configuration per gestire ed eseguire comandi comuni.

Per utilizzare questa funzionalità, seleziona Apri configurazione scorciatoie dalla barra degli strumenti dell'estensione MSSQL.

Screenshot della barra degli strumenti dell'estensione MSSQL che mostra il pulsante Apri Configurazione Shortcuts.

Comprende due schede:

  • Query veloci: salva ed esegui frammenti SQL con scorci da tastiera.
  • Scorciatoie estensioni: Configura le scorciatoie dell'editor MSSQL e della vista risultato.

Nella scheda Quick Queries hai le seguenti opzioni:

  • Query SQL personalizzabili: Configura e salva più voci di query SQL.
  • Controllo auto-esecuzione: Scegli se un collegamento esegue immediatamente la query o se la apre prima nell'editor.
  • Integrazione delle scorciatoie da tastiera: Personalizza le scorciatoie da tastiera con l'editor Scorciatoie da tastiera di Visual Studio Code.

Screenshot della pagina Configurazione Shortcuts che mostra la scheda Query rapide con slot per query, opzioni di esecuzione automatica e controlli di binding tasti.

Per indicazioni dettagliate sulle scorciatoie di estensione e sulla configurazione avanzata delle scorciatoie, vedi Personalizza scorciatoie da tastiera.

Sistemi operativi supportati

Attualmente, questa estensione supporta i sistemi operativi seguenti:

  • Windows 10 e 11 (x64, Arm64)
  • macOS (Intel e Apple Silicon)
  • Linux (x64, Arm64): inclusi Ubuntu, Debian, RHEL, Fedora e altre distribuzioni principali

Installazione offline

L'estensione può scaricare e installare un pacchetto necessario SqlToolsService durante l'attivazione. È comunque possibile usare l'estensione nei computer senza accesso a Internet scegliendo l'opzione Installa da VSIX... nella visualizzazione Estensioni e installando una versione in bundle dalla pagina Versioni. Ogni sistema operativo ha un .vsix file con il servizio richiesto incluso. Selezionare il file per il sistema operativo, scaricarlo e installarlo per iniziare. Scegliere una versione completa e ignorare le versioni alfa o beta, perché queste versioni sono build giornaliere usate nei test.

Feedback e supporto

Se si hanno idee, commenti e suggerimenti o si vuole interagire con la community, partecipare alla discussione all'indirizzo https://aka.ms/vscode-mssql-discussions. Per segnalare un bug, visitare https://aka.ms/vscode-mssql-bug. Per richiedere una nuova funzionalità, passare a https://aka.ms/vscode-mssql-feature-request.