Integrazione del Fabric (versione di anteprima)

L'estensione MSSQL per Visual Studio Code supporta la connessione al database SQL in Microsoft Fabric. La finestra di dialogo Connessione include un'opzione di connettività fabric che consente di accedere con Microsoft Entra ID. È possibile esplorare le aree di lavoro di Fabric in una visualizzazione albero, eseguire ricerche tra aree di lavoro e connettersi a database o endpoint SQL senza configurare manualmente le stringhe di connessione. L'estensione supporta l'accesso permanente, il passaggio del tenant e un flusso Open in MSSQL trasparente dall'estensione Fabric.

È possibile creare nuovi database SQL in Fabric direttamente da Visual Studio Code. Autenticarsi, selezionare o creare un'area di lavoro, specificare un nome di database e connettersi una volta completato il provisioning. Il processo di provisioning visualizza un indicatore di stato, conferma la corretta creazione prima di stabilire la connessione.

Connettività dell'infrastruttura (Sfoglia)

L'esperienza di esplorazione dell'infrastruttura nell'estensione MSSQL consente agli sviluppatori di connettersi facilmente ai database SQL in Fabric o agli endpoint di analisi SQL senza copiare manualmente le stringhe di connessione dal portale di Fabric. Con un'unica autenticazione di Microsoft Entra ID, è possibile esplorare le aree di lavoro disponibili in una visualizzazione albero e connettersi direttamente da Visual Studio Code.

Capacità

• Esperienza infrastruttura dedicata: offre un'opzione all'interno della finestra di dialogo Connessione personalizzata specificamente per gli utenti di Fabric, semplificando il processo di connessione concentrandosi sui database di Infrastruttura.

• Autenticazione facile: usa l'account Microsoft per l'accesso sicuro e permanente, quindi gli utenti devono eseguire l'autenticazione una sola volta per accedere a tutte le aree di lavoro e i database di Fabric.

• Esplorazione dell'area di lavoro: visualizza tutte le aree di lavoro di Fabric in una visualizzazione albero gerarchica con risorse caricate su richiesta, semplificando l'esplorazione e la gestione dell'ambiente fabric.

• Ricerca e individuazione: offre funzionalità di ricerca in tempo reale per individuare rapidamente l'area di lavoro o il database appropriato senza scorrere gli elenchi lunghi.

• Supporto tra estensioni: consente di aprire i database di Fabric direttamente in MSSQL dall'estensione o dal portale di Fabric, offrendo un'esperienza coerente e integrata tra gli strumenti.

Prerequisiti

• Installare la versione più recente dell'estensione MSSQL per Visual Studio Code.
• Autorizzazioni di sottoscrizione e area di lavoro di Active Fabric.
• Un account Microsoft valido con accesso alle aree di lavoro e alle risorse di Fabric.
• ID Microsoft Entra per l'autenticazione. Dopo l'accesso, è possibile scegliere sia l'account che il tenant specifico per esplorare il set corretto di aree di lavoro e database di Fabric.

Get started

1. Aprire la finestra di dialogo Connessione e selezionare Sfoglia Rete.

   

2. Accedere con Microsoft Entra ID.

   Autenticazione per la prima volta

   • Per impostazione predefinita, il tipo di autenticazione è Microsoft Entra ID - Universale con supporto MFA.
   • Se non è stato eseguito l'accesso, aprire l'elenco a discesa Account e selezionare Aggiungi un account.
   • Scegliere l'account e completare il processo di accesso nella finestra del browser visualizzata.
   • Tornare a Visual Studio Code al termine del processo.

   Restituzione dell'autenticazione utente

   • Se si esegue spesso l'accesso, le informazioni sull'account vengono visualizzate precompilate.
   • Verificare che l'account corretto sia selezionato e procedere.

3. (Facoltativo) Selezionare un tenant.

   • Usare il menu a tendina ID tenant per scegliere il tenant dell'organizzazione.
   • Questa selezione è utile se si ha accesso a più ambienti tenant ed è necessario esplorare le risorse in un tenant diverso.

4. Esplora le aree di lavoro Fabric nell'albero dell'area di lavoro.

5. Usare la barra di ricerca nella parte superiore dell'albero per individuare rapidamente un'area di lavoro o un database.

6. Selezionare l'endpoint di analisi o database desiderato dall'elenco.

7. Confermare l'autenticazione per la risorsa selezionata, se richiesto.

   

8. Selezionare Connetti per aggiungere il database selezionato all'elenco Connessioni .

9. La nuova connessione viene visualizzata in Connessioni e viene aperta una finestra di query pronta per l'uso.

   

Gestione degli errori e casi limite

In caso di problemi, l'interfaccia utente visualizza un messaggio chiaro e le azioni consigliate:

Limitazioni note (anteprima)

• Sono supportati solo i database SQL e gli endpoint di analisi SQL . L'apertura di altri tipi di oggetto Fabric da MSSQL non è disponibile.
• La navigazione tra i tenant è supportata cambiando i tenant, ma ogni connessione al database deve essere creata separatamente. Non esiste una connessione unificata tra più tenant o tra più database.
• I flussi di accesso offline e di autenticazione del codice del dispositivo non sono supportati.

Database SQL nel provisioning di Fabric

L'esperienza di provisioning del database SQL è integrata nella pagina Distribuzioni dell'estensione MSSQL. È possibile creare e connettersi ai nuovi database SQL dell'infrastruttura senza uscire da Visual Studio Code. Questo flusso di lavoro semplificato riduce la necessità di passare da un portale all'altro e semplifica la creazione e la connessione del database.

Capacità

• Flusso di lavoro semplice: consente di eseguire l'autenticazione, la selezione o la creazione dell'area di lavoro, la denominazione del database e il provisioning all'interno della pagina Distribuzioni , rendendo la configurazione del database semplice ed efficiente.

• Connessione immediata: aggiunge automaticamente il database appena sottoposto a provisioning all'elenco delle connessioni, in modo da poter iniziare a eseguire query e sviluppare senza passaggi di configurazione aggiuntivi.

• Esperienza coerente: allinea il flusso di provisioning con altri back-end supportati, ad esempio i contenitori di SQL Server locali, garantendo un'esperienza utente familiare e unificata in ambienti diversi.

• Consapevolezza della capacità: indica chiaramente quando le aree di lavoro sono disabilitate a causa di vincoli di capacità, fornendo indicazioni utili per comprendere e risolvere le limitazioni del provisioning.

Prerequisiti

• Sottoscrizione valida di Microsoft Fabric.
• Capacità sufficiente nell'area di lavoro di destinazione per effettuare il provisioning di nuovi database SQL.
• Account ID Microsoft Entra con le autorizzazioni necessarie per l'area di lavoro (amministratore o membro).
• Visual Studio Code con l'estensione MSSQL installata.

Get started

1. Aprire la pagina Distribuzioni e scegliere Database SQL in Fabric.
2. Eseguire l'autenticazione con Microsoft Entra ID.
3. Selezionare o creare un'area di lavoro Fabric.
4. Immettere un nome di database e quindi selezionare Crea.
5. Al termine del provisioning, il database viene connesso automaticamente e visualizzato in Connessioni, con una conferma dell'esito positivo.

L'animazione seguente mostra il flusso di lavoro di provisioning del database SQL in Fabric in azione:

Dettagli sulla consapevolezza della capacità

• Il flusso di provisioning convalida la capacità dell'account e dell'area di lavoro di Fabric per assicurarsi che il database possa essere creato correttamente.
• L'elenco a discesa dell'area di lavoro mostra le aree di lavoro senza capacità operativa come disabilitate, con un tooltip che spiega il motivo.

Comportamento post-provisioning

• La nuova connessione adotta il gruppo di connessioni selezionato (facoltativo) per l'identificazione visiva rapida.
• È possibile associare questa esperienza alla funzionalità di esplorazione di Fabric in un altro ambiente di Visual Studio Code, in modo da poter individuare e connettersi al database appena creato senza configurare manualmente.

Risoluzione dei problemi

• Nome già esistente: scegliere un nome di database univoco all'interno dell'area di lavoro selezionata.
• Autorizzazioni insufficienti: assicurarsi di disporre dei diritti di amministratore/membro dell'area di lavoro per la creazione di database.
• Errori di rete o tenant: effettuare nuovamente la riautenticazione o modificare l'account connesso dal menu dell'account.
• Timeout o errore di provisioning: se la procedura guidata non viene completata, ripetere l'operazione o controllare l'integrità del servizio Fabric.

Limitazioni note (anteprima)

• Il provisioning è limitato ai database SQL in Fabric. Altri tipi di elemento Fabric non rientrano nell'ambito di applicazione.
• Il provisioning tra tenenti è supportato quando si seleziona esplicitamente un tenant diverso durante l'autenticazione. Tuttavia, gli scenari che coinvolgono più tenant simultanei o flussi di lavoro automatizzati tra tenant non sono ancora supportati.
• Il provisioning non può essere accodato quando la capacità viene esaurita completamente.

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 aka.ms/vscode-mssql-bug. Per richiedere una nuova funzionalità, passare a https://aka.ms/vscode-mssql-feature-request.

Contenuti correlati

• Guida introduttiva: Connettersi ed eseguire query su un database con l'estensione MSSQL per Visual Studio Code
• Contenitore di SQL Server locale
• Progettazione schemi
• Confronto degli schemi