Connettersi a un database con l'estensione MSSQL per Visual Studio Code

L'estensione MSSQL per Visual Studio Code si concentra sulle connessioni a SQL Server, Azure SQL e database SQL in Microsoft Fabric. Questo articolo illustra come creare connessioni con la finestra di dialogo di connessione e quali tipi di autenticazione supportano l'estensione. Viene inoltre illustrato come organizzare le connessioni salvate nel Esplora oggetti e come scegliere la connessione usata dall'estensione quando si apre un nuovo file SQL.

Dopo la connessione, vedere Avvio rapido: Eseguire la prima query con l'estensione MSSQL per Visual Studio Code per creare un database, aggiungere dati ed eseguire istruzioni Transact-SQL.

Finestra di dialogo per la connessione

La finestra di dialogo di connessione è il modo principale per creare o modificare una connessione. Aprirlo selezionando Aggiungi connessione nel Esplora oggetti oppure eseguendo il comando MS SQL: Aggiungi connessione dal riquadro comandi.

Il dialogo include tre aree principali:

Area del modulo al centro, in cui si compilano i dettagli della connessione.
Un pannello Connessioni salvate e Connessioni recenti sul lato destro, che elenca le connessioni che è possibile riaprire o modificare rapidamente.
Piè di pagina con le azioni Avanzate, Test connessione, Salva senza connessione e Connetti .

Tipi di input

Nella parte superiore del modulo, il selettore Tipo di input controlla la modalità di immissione dei dettagli della connessione. Usare il tipo di input che meglio corrisponde a ciò che si conosce già sul server di destinazione.

Parametri: compilare singoli campi, ad esempio nome del server, nome del database, tipo di autenticazione, nome utente e password. Questo tipo di input è l'impostazione predefinita ed è l'opzione più semplice per la maggior parte degli scenari.
Connection String: incollare un stringa di connessione di tipo ADO.NET completo. Questo tipo di input è utile quando un stringa di connessione è già stato fornito all'utente (ad esempio, dal portale di Azure o da un amministratore) o quando è necessario configurare le opzioni non esposte nella visualizzazione Parametri.
Sfoglia Azure: accedere a Azure e selezionare un server e un database dalle sottoscrizioni. È possibile filtrare in base alla sottoscrizione e al gruppo di risorse per trovare il database desiderato. Questa opzione funziona per database SQL di Azure e Istanza gestita di SQL di Azure (sono elencati sia endpoint privati che pubblici). È possibile aggiungere sottoscrizioni preferite in modo che vengano visualizzate nella parte superiore dell'elenco e caricate automaticamente.
Sfoglia Fabric: accedere a Microsoft Fabric e selezionare un database SQL da una delle aree di lavoro. Nella finestra di dialogo sono elencate le aree di lavoro a cui si ha accesso e i database SQL all'interno di essi. Come quando si esplora Azure, è possibile selezionare le aree di lavoro preferite in modo che vengano visualizzate nella parte superiore dell'elenco e caricate automaticamente.

Sia Sfoglia Azure che Sfoglia Fabric usano gli account Microsoft con cui accedi a Visual Studio Code. È possibile accedere con tutti gli account Microsoft desiderati e passare tra account e tenant usando gli elenchi a discesa nella parte superiore del pannello di esplorazione. non è possibile usare gli account GitHub per esplorare Azure e Fabric database.

Scegliere un database

Il campo Database consente di connettersi al database predefinito del server o a un database specifico.

Lasciare il campo impostato su <Predefinito> per connettersi al database predefinito assegnato dal server. Questa è l'opzione più semplice ed è comunque possibile cambiare database in un secondo momento dall'editor.
Selezionare un database specifico dall'elenco a discesa. Dopo aver compilato i dettagli sufficienti per l'autenticazione, l'estensione tenta di recuperare l'elenco di database nel server in background. Se l'elenco viene caricato correttamente, è possibile sceglierlo.
Se l'elenco di database non può essere caricato, ad esempio quando l'account di accesso non dispone dell'autorizzazione per enumerare i database nel server, è comunque possibile digitare il nome del database direttamente nel campo.

Impostazioni avanzate

Selezionare Avanzate nel piè di pagina per aprire un pannello laterale con il set completo di altre opzioni di connessione, ad esempio Always Encrypted, Command Timeout e Finalità applicazione (di sola lettura o lettura/scrittura). Queste sono le stesse opzioni disponibili in un stringa di connessione, raggruppate in categorie come sicurezza, resilienza della connessione e pooling. Usare la casella di ricerca nella parte superiore del pannello per trovare rapidamente un'impostazione specifica.

I pulsanti nel piè di pagina controllano cosa accade quando si completa la compilazione del modulo.

Connetti: si connette al database e aggiunge la connessione all'elenco di connessioni salvate.
Verifica connessione: tenta di connettersi usando i valori correnti del modulo senza salvare nulla. Usare questa opzione per verificare che il server, le credenziali e altre impostazioni siano corrette prima di eseguire il commit in una connessione.
Salva senza connessione: salva il profilo di connessione nell'elenco delle connessioni salvate, ma non apre una sessione. Ciò è utile quando si configurano le connessioni in anticipo o quando si vuole rinominare una connessione esistente senza connettersi.

Usare le connessioni esistenti

Gli elenchi Connessioni salvate e Connessioni recenti sul lato destro della finestra di dialogo semplificano l'avvio da una connessione già presente.

Passare il puntatore del mouse su una connessione salvata per visualizzare un menu azione. Da qui è possibile modificare i dettagli della connessione, Creare una nuova connessione in base a una connessione esistente (un collegamento utile quando più connessioni condividono lo stesso server ma database o credenziali diversi) o rimuovere la connessione dall'elenco.
Le connessioni recenti funzionano allo stesso modo, ma sono limitate alle connessioni usate di recente, anche se non vengono salvate.

Tipi di autenticazione supportati

L'estensione MSSQL supporta diversi tipi di autenticazione. Scegliere quello che corrisponde alla modalità di configurazione del server.

Immettere un nome utente e una password definiti nella SQL Server stessa. L'account di accesso SQL funziona per SQL Server, database SQL di Azure e Istanza gestita di SQL di Azure.

Facoltativamente, è possibile salvare la password in modo che non sia necessario immetterla di nuovo ogni volta che ci si connette.

Autenticazione di Windows

Usare l'account di Windows corrente per accedere al server, senza nome utente o password necessari. Windows l'autenticazione funziona solo quando ci si connette a un'istanza di SQL Server configurata per accettarla, in genere in una rete aggiunta a un dominio o nello stesso computer del server.

Questa opzione è talvolta denominata Autenticazione integrata. Non è disponibile per database SQL di Azure, Istanza gestita di SQL di Azure o database SQL in Fabric.

Microsoft Entra ID - per tutti con MFA

Accedi con un account Microsoft Entra ID. Questa opzione supporta l'autenticazione a più fattori (MFA), i criteri di accesso condizionale e gli account personali Microsoft che sono ospiti in un tenant Microsoft Entra.

Quando si seleziona questa opzione, la finestra di dialogo chiede di scegliere o aggiungere un account Microsoft Entra ID e di selezionare un tenant se l'account ha accesso a più di uno.

L'estensione usa gli account Microsoft a cui hai eseguito l'accesso Visual Studio Code (gli stessi account visualizzati nel menu Account nell'angolo inferiore sinistro della finestra). Se non hai ancora effettuato l'accesso a Visual Studio Code o non hai ancora concesso all'estensione MSSQL l'autorizzazione a usare gli account, ti verrà chiesto di accedere quando ti connetti.

Note

Se in precedenza è stato eseguito l'accesso all'estensione MSSQL usando il proprio sistema di account dell'estensione (usato in MSSQL 1.42.2 e versioni precedenti), verrà richiesto di accedere a Visual Studio Code (se non si è già) alla successiva connessione usando una delle connessioni salvate.

Se il sistema di account di Visual Studio Code non funziona per te, faccelo sapere. È possibile eseguire il fallback al meccanismo di accesso precedente impostando mssql.preview.useVscodeAccountsForEntraMFA su false.

Microsoft Entra ID - Impostazione predefinita

Questa opzione utilizza l'autenticazione predefinita di Microsoft Entra ID. Il driver SQL (MDS) di Microsoft seleziona automaticamente un'identità Microsoft Entra ID disponibile tra i provider di credenziali installati nel sistema. Questo tipo di autenticazione è utile quando si hanno requisiti di autenticazione specifici che non sono supportati direttamente dall'estensione MSSQL.

Le identità possono provenire da diverse origini, ad esempio una sessione di interfaccia della riga di comando di Azure con accesso (az login) o variabili di ambiente ed è possibile indirizzare un'identità specifica da usare impostando la User name casella. Per altre informazioni su come l'autenticazione predefinita seleziona un'identità, vedere DefaultAzureCredential nella libreria client di Azure Identity

Microsoft Entra ID - Service Principal

Autenticarsi come entità servizio di Microsoft Entra ID (un'identità applicativa anziché un utente). Usare questa opzione per scenari di automazione, workstation condivise o in qualsiasi caso in cui sia preferibile concedere al database l'accesso a un'identità dell'applicazione anziché a una persona.

Quando si seleziona questa opzione, i campi Nome utente e Password vengono riutilizzati:

Inserire l'ID applicazione (client) del service principal nel campo del nome utente.
Inserire il Segreto client del service principal come password.

Per altre informazioni su come usare un'entità servizio con SQL, vedere Entità servizio nella libreria client Azure Identity

Connessioni nel Esplora oggetti

Ogni connessione creata dalla finestra di dialogo di connessione (se ci si connette immediatamente o si salva senza connessione) viene visualizzata nella Esplora oggetti nella visualizzazione MSSQL. Il Esplora oggetti è la posizione in cui si passa a esplorare il contenuto del server, eseguire azioni come i backup e riconnettersi ai database usati in precedenza.

Gruppi di connessioni

Le connessioni possono essere organizzate in gruppi di connessioni. I gruppi agiscono come cartelle: è possibile denominarli, assegnare un colore e posizionare le connessioni all'interno di essi per mantenere gli ambienti visivamente separati ,ad esempio Produzione, Gestione temporanea e Locale.

Creare un gruppo: usare il comando Nuovo gruppo di connessione o assegnare un nuovo gruppo durante la creazione o la modifica di una connessione.
Trascinare e rilasciare per organizzare: trascinare una connessione in un gruppo per spostarla in tale gruppo. Trascinare un gruppo in un altro gruppo per annidarlo. È possibile creare gruppi annidati su più livelli.
Espandere e comprimere: usare i chevrons accanto a ogni gruppo per espanderlo e comprimerlo, in modo da visualizzare solo le connessioni attualmente in uso. Per iniziare sempre con i gruppi compressi all'avvio di Visual Studio Code, abilitare l'impostazione mssql.collapseConnectionGroupsOnStartup .

Fare clic con il pulsante destro del mouse su una connessione server nel Esplora oggetti per visualizzare le azioni che si applicano alla connessione stessa. Le opzioni più usate per la connessione includono:

Connetti / Disconnetti: avvia o termina una sessione con il server.
Modifica connessione: aprire la finestra di dialogo connessione con il profilo di connessione caricato per modificarne i parametri.
Copia stringa di connessione: copia una stringa di connessione per la connessione salvata negli appunti. Questo è utile quando è necessario condividere la connessione con un altro strumento o incollarlo nel codice dell'applicazione. Le password e i segreti non sono inclusi.
Rimuovi connessione: eliminare la connessione dall'elenco salvato.

Regole del firewall per Azure SQL

Quando ci si connette a un database SQL di Azure o Istanza gestita di SQL di Azure da un indirizzo IP client non consentito dal firewall del server, è possibile usare l'estensione MSSQL per aggiungere una regola del firewall tramite la finestra di dialogo Aggiungi regola del firewall.

Nella finestra di dialogo Aggiungi regola del firewall accedere con un account Microsoft che dispone dell'autorizzazione per gestire il server, assegnare alla regola un nome e scegliere se consentire solo l'indirizzo IP corrente o un intervallo. Dopo aver salvato la regola, la connessione verrà ritentata automaticamente.

Connessioni dell'area di lavoro

Le connessioni salvate e i gruppi di connessioni vengono archiviati nel Visual Studio Code settings.json. L'estensione legge le connessioni da due ambiti:

Impostazioni utente (globale): le nuove connessioni vengono salvate qui. Sono disponibili in tutte le sessioni Visual Studio Code, indipendentemente dalla cartella aperta.
Impostazioni dell'area di lavoro: le connessioni salvate a livello di area di lavoro sono disponibili solo quando l'area di lavoro è aperta. Questo ambito è utile per le connessioni specifiche del progetto che si desidera condividere con i collaboratori inserendo il file dell'area di lavoro .code-workspace nel sistema di controllo del codice sorgente.

Per spostare una connessione dalle impostazioni utente alle impostazioni dell'area di lavoro, copiare la voce JSON della connessione dall'utente settings.json nell'area di lavoro settings.jsone quindi eliminarla dalla configurazione utente.

Note

L'estensione non legge le connessioni dalle impostazioni delle singole cartelle dell'area di lavoro (il file .vscode/settings.json di ciascuna cartella all'interno di un'area di lavoro multi-root). Se desideri che una connessione si applichi a un progetto specifico, salvala invece a livello di workspace.

Quando si salva una connessione con una password o un segreto, la password non viene archiviata in settings.json. Le password vengono mantenute separatamente nell'archivio delle credenziali sicure di Visual Studio Code.

Selezione della connessione all'apertura di un nuovo file o editor SQL

Quando si apre un .sql file o si crea un nuovo editor SQL, l'estensione può lasciare l'editor disconnesso o connetterlo automaticamente.

Questo comportamento è controllato dall'impostazione mssql.newEditorConnectionBehavior , che supporta tre modalità:

Modalità	Descrizione
`none`	Nuovi editor SQL aperti senza connessione. Viene richiesto di selezionare una connessione la prima volta che si esegue una query oppure è possibile usare il comando SQL: Connect per collegare manualmente una connessione.
`transferActive` (impostazione predefinita)	I nuovi editor SQL vengono connessi automaticamente allo stesso database dell'editor SQL attualmente attivo. Ciò è utile quando si lavora su più file sullo stesso database e non si vuole riconnettersi a ognuno di essi. Se non è attualmente attivo alcun editor SQL, il nuovo editor viene aperto senza connessione.
`defaultConnection`	I nuovi editor SQL vengono connessi automaticamente a una connessione specifica designata come predefinita. La connessione predefinita è identificata dall'impostazione `mssql.defaultConnectionId` . Per usare questa modalità, è anche necessario impostare `mssql.defaultConnectionId` l'ID di una delle connessioni salvate. È possibile trovare l'ID esaminando le connessioni salvate in `settings.json`. Se `mssql.defaultConnectionId` non è impostata o non corrisponde più a una connessione salvata, l'estensione chiede di scegliere una connessione predefinita alla successiva apertura di un nuovo editor SQL.

È possibile modificare queste impostazioni dall'interfaccia utente delle impostazioni di Visual Studio Code cercando mssql.newEditorConnectionBehavior o mssql.defaultConnectionId.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-06-23