Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Crea e gestisci un database locale senza scrivere comandi container utilizzando l'estensione MSSQL per Visual Studio Code. Scegli un container database SQL di Azure (Preview) per sviluppare con il motore database SQL di Azure sul tuo computer, oppure un container SQL Server per lo sviluppo SQL Server. Avvia, ferma, riconnetti ed elimina il tuo contenitore dall'estensione.
Per una nuova applicazione rivolta a database SQL di Azure, inizia dal container database SQL di Azure. È gratuito per lo sviluppo e il test locale, non richiede abbonamenti Azure né carte di credito, e funziona con i driver e gli object-relational mapper (ORM) che usi per database SQL di Azure.
Annotazioni
Il contenitore di database SQL di Azure è disponibile in anteprima pubblica. Supporta sia dispositivi x64 che ARM.
Che cos'è un contenitore database SQL di Azure?
Un container impacchetta il motore di database in modo che un runtime container possa eseguirlo sul tuo computer. L'estensione MSSQL ti guida durante la configurazione, scarica l'immagine, avvia il motore e salva una connessione. L'applicazione si connette a un indirizzo locale, localhost,1433ad esempio , anziché a un server logico Azure SQL.
Il container database SQL di Azure esegue il motore database SQL di Azure, non l'immagine del container SQL Server. Supporta database SQL di Azure T-SQL e il protocollo TDS (Tabular Data Stream) usati dai driver SQL. Ad esempio, SERVERPROPERTY('EngineEdition') restituisce 5, identificando il motore database SQL di Azure. Vettori nativi, ricerca vettoriale e JSON consentono di esplorare gli scenari di dati pronti per l'intelligenza artificiale in locale.
Il contenitore non fornisce il servizio cloud gestito. backup gestiti da Azure, disponibilità elevata, pool elastici e sospensione automatica serverless sono funzionalità cloud, non funzionalità del contenitore locale. Prima della distribuzione, verifica contro database SQL di Azure in Azure: restrizioni di anteprima, impostazioni predefinite e supporto alle funzionalità possono variare. Vedi limitazioni note.
Scegliere il database di sviluppo
Usa l'opzione che corrisponde al target della tua applicazione, invece di trattare le due immagini container come intercambiabili.
| Option | Sceglilo quando | Requisiti relativi ai costi e all'account |
|---|---|---|
| Container database SQL di Azure (Anteprima) | Vuoi imparare SQL oppure compilare e testare un'applicazione destinata ad database SQL di Azure in locale. Supporta X64 e ARM. Consigliato per questo flusso di lavoro di sviluppo locale. | Gratuito per lo sviluppo e il test locali. Non è richiesta alcuna sottoscrizione Azure o carta di credito. |
| Contenitore SQL Server | La tua applicazione è destinata a SQL Server o necessita di comportamenti specifici per SQL Server. Supporta solo X64. | Usa un'edizione autorizzata per il tuo scenario. Non è richiesto alcun abbonamento Azure per lo sviluppo locale. |
| database SQL di Azure livello gratuito | Vuoi un database gestito in Azure, integrazione cloud o un ambiente di validazione cloud. | Richiede una sottoscrizione Azure. Si applicano quote mensili, requisiti di ammissibilità e comportamenti di sospensione o di eccedenza a pagamento. |
Importante
I contenitori di database SQL di Azure sono destinati allo sviluppo, al test, all'integrazione continua e alle demo, non alla produzione. Per la produzione, distribuire l'applicazione e il database in database SQL di Azure in Azure. Il contenitore locale gratuito e il livello gratuito di database SQL di Azure sono opzioni separate.
Prerequisites
Per il container database SQL di Azure, è necessario:
- Codice di Visual Studio.
- Una release corrente dell'estensione MSSQL che include database SQL di Azure container (Preview).
- Un runtime di container supportato installato e in esecuzione con container Linux. La procedura guidata database SQL di Azure rileva i motori disponibili e ne verifica i prerequisiti. Le opzioni includono Docker, Podman, containerd con
nerdctl, e contenitori WSL su Windows. - Risorse sufficienti per il motore di database. Allocare almeno 4 GB di memoria e due core CPU al runtime del contenitore e mantenere almeno 10 GB di spazio libero su disco per l'immagine e un piccolo database. I dataset più grandi richiedono più spazio su disco.
- Accesso a Internet per il download iniziale dell'immagine. Dopo aver memorizzato l'immagine nella cache, le query locali non richiedono un database cloud. Gli endpoint di intelligenza artificiale esterni e altri Servizi online richiedono comunque la connettività.
L'immagine database SQL di Azure fornisce varianti native linux/amd64 e linux/arm64 per host x64 e ARM64. Puoi sviluppare su macOS, Linux o Windows con WSL2. I container di SQL Server hanno requisiti separati per immagini e runtime.
Creare un contenitore database SQL di Azure
Nella visualizzazione Connessioni dell'estensione MSSQL, seleziona New Deployment e container database SQL di Azure (Preview).
Esamina la panoramica del contenitore sviluppatore e seleziona Avanti. La procedura guidata verifica il motore che hai installato. Se la procedura guidata non trova un motore, utilizza i link di installazione forniti per installare un motore, quindi riprova i controlli. Quando i controlli dei prerequisiti superano, seleziona Avanti.
Configura la tua connessione con una password forte di almeno otto caratteri (lettere maiuscole, minuscole, numeri e simboli). Esamina e accetta i Termini e Condizioni, e seleziona Avanti per effettuare il provisioning del contenitore.
Attendi che il download dell'immagine, la creazione del contenitore, la prontezza del motore e la connessione si completino.
Trova la connessione salvata in Esplora oggetti nella vista Connessioni.
L'estensione crea un profilo di connessione salvato. Un container, un profilo di connessione e un database applicativo sono risorse diverse: avviare il motore non significa che il database della tua applicazione esista già. Continua con i seguenti passaggi per crearne uno esplicitamente.
La procedura guidata offre anche l'autenticazione Microsoft Entra per scenari più avanzati. Richiede una configurazione aggiuntiva di identità e certificato.
Crea un database ed esegui la tua prima query
Usare appdb come nome di database di esempio. Sostituisci in modo coerente il nome del database del tuo progetto se scegli un altro nome.
In Esplora oggetti, fai clic con il tasto destro sulla connessione del contenitore e seleziona Crea database.
Nella finestra di dialogo Crea database, inserisci
appdbin Nome database.Usa Aggiungi Connessione per connettersi allo stesso server locale e alla stessa porta con Database impostato su
appdb. Apri un nuovo editor di query con questa connessione ed esegui:SELECT DB_NAME() AS current_database, SERVERPROPERTY('EngineEdition') AS engine_edition, SERVERPROPERTY('Edition') AS edition;Si prevede che
current_databasesiaappdb,engine_editionsia5eeditionsiaSQL Azure. Se l'edizione è diversa, verifica di aver selezionato il container database SQL di Azure, non SQL Server. Seleziona il database nelle impostazioni di connessione, non conUSE appdb. Le sessioni del database utente di database SQL di Azure non supportano lo switching di database conUSE.Esegui ciascuna di queste istruzioni separatamente in
appdb. Fermati se un'istruzione non riesce. Sedbo.Tasksesiste già, scegli in modo coerente un nome di tabella diverso o un database di sviluppo diverso; non sovrascriverlo.CREATE TABLE dbo.Tasks ( TaskId INT IDENTITY (1, 1) NOT NULL PRIMARY KEY, Title NVARCHAR (200) NOT NULL, IsComplete BIT NOT NULL DEFAULT (0) );INSERT INTO dbo.Tasks (Title) VALUES (N'Create a local Azure SQL Database'), (N'Connect an application');SELECT TaskId, Title, IsComplete FROM dbo.Tasks ORDER BY TaskId;Dopo un inserimento riuscito, aspettati due righe con valori di
TaskIdpari a1e2, e conIsCompleteimpostato su0.
Se preferisci SQL per la creazione di database, collega un editor di query a master ed esegui CREATE DATABASE appdb; invece di usare la finestra di dialogo Crea database .
Usare master per il provisioning del database e il database utente per le query dell'applicazione. Collegarsi a un database che non esiste non lo crea, e il contenitore non esegue automaticamente script di inizializzazione da /docker-entrypoint-initdb.d.
Importare lo schema e i dati
Se hai già un pacchetto database, utilizza le operazioni DACPAC e BACPAC dell'estensione invece di ricostruire manualmente lo schema.
| Package | Che cosa contiene | Operation |
|---|---|---|
.dacpac |
Schema del database. Non sono inclusi i dati della tabella. | Pubblica DACPAC per distribuire lo schema in un database di sviluppo nuovo o esistente. |
.bacpac |
Schema del database e dati delle tabelle. | Importa BACPAC in un database di sviluppo nuovo o vuoto. |
Fai clic destro sulla connessione del contenitore in Esplora oggetti e seleziona DACPAC/BACPAC Operations....
Scegli l'operazione che corrisponde al tuo pacchetto, seleziona il file del pacchetto e conferma la connessione e il database del contenitore di destinazione.
Esaminare le modifiche di destinazione e proposte prima di procedere. Attendi che l'operazione si completi, quindi aggiorna Database e collegati direttamente al database utente di destinazione per ispezionarne lo schema e i dati.
Non importare un BACPAC in appdb dopo aver creato la tabella di esempio dbo.Tasks: quel database non è vuoto. Scegli invece un database di sviluppo nuovo o vuoto. Pubblica solo schemi compatibili con database SQL di Azure e verifica le modifiche prima di applicarle a un database con i dati di cui hai bisogno.
Annotazioni
I file SQL Server .bak non sono file BACPAC; BACKUP DATABASE e RESTORE DATABASE non sono supportati dal container database SQL di Azure.
Connetti l'applicazione
Usa l'indirizzo del server locale, la porta host selezionata dalla procedura guidata, il nome del tuo database e le tue credenziali con un driver compatibile con Azure SQL. Ad esempio, questa stringa di connessione appdbdi tipo ADO.NET è destinata a :
Server=localhost,<host-port>;Database=appdb;User ID=sa;Password=<your-password>;Encrypt=True;TrustServerCertificate=True;
Sostituisci entrambi i segnaposto prima di collegarti.
TrustServerCertificate=True è solo per il certificato autofirmato del contenitore locale. Utilizza la validazione dei certificati e un metodo di autenticazione appropriato, come l'autenticazione Microsoft Entra, per database SQL di Azure in Azure.
Archiviare le stringhe di connessione nelle variabili di ambiente o nell'archivio dei segreti di sviluppo, non nel controllo del codice sorgente o nei prompt dell'IA. Altri driver utilizzano sintassi di stringa di connessione diversa; consulta i quickstart per Python e .NET.
Sviluppare con l'IA
Puoi usare GitHub Copilot nell'estensione MSSQL per spiegare SQL, bozzare query e pianificare le modifiche dello schema sul tuo database locale. Esamina il SQL generato e il database selezionato prima di eseguirlo. L'uso dei container è gratuito; GitHub Copilot e i servizi di modelli esterni hanno requisiti di accesso e prezzi propri.
Ad esempio, dopo aver creato dbo.Tasks, fornisci a Copilot questo prompt:
I'm developing against an Azure SQL Database container, not SQL Server.
Use my existing appdb connection. First confirm the active database and
EngineEdition = 5. Explain the dbo.Tasks schema, then draft a parameterized
query to insert a task and a query to list incomplete tasks.
Don't execute changes, delete data, or create cloud resources.
Don't request or display passwords. Don't use USE to switch databases.
Per i flussi di lavoro code-first, le competenze dell'agente contenitore database SQL di Azure forniscono istruzioni per la configurazione, la connessione, la migrazione e le linee guida da locale a cloud per gli agenti di codifica di intelligenza artificiale supportati.
Prova la similarità vettoriale senza un servizio di embedding
Esegui questo esempio sulla tua connessione appdb per esplorare i vettori nativi ed eseguire una ricerca di somiglianza esatta. Utilizza vettori tridimensionali illustrativi, non crea una tabella e non chiama un endpoint a pagamento del modello.
DECLARE @query VECTOR(3) = '[1.0, 0.0, 0.0]';
SELECT TOP (2)
v.Label,
VECTOR_DISTANCE('cosine', CAST(v.Embedding AS VECTOR(3)), @query) AS distance
FROM (VALUES
(N'Closest', '[1.0, 0.0, 0.0]'),
(N'Perpendicular', '[0.0, 1.0, 0.0]')
) AS v(Label, Embedding)
ORDER BY distance;
Ci si aspetta prima Closest con distanza 0, seguita da Perpendicular con distanza 1. In un'applicazione reale, genera embedding con lo stesso modello per dati e query memorizzati, e utilizza le dimensioni di embedding del modello.
VECTOR_DISTANCE esegue una ricerca esatta; non utilizza un indice vettoriale. Esamina i limiti dell'anteprima prima di scegliere una strategia di indicizzazione o incorporamento.
Funzionalità
Le esperienze container locali offrono le seguenti funzionalità:
- Crea un container database SQL di Azure o SQL Server tramite una procedura guidata guidata.
- Personalizzare il nome del contenitore, il nome host e la porta.
- Verifica i prerequisiti di runtime del container prima della distribuzione.
- Assegnare automaticamente una porta disponibile se 1433 è già in uso.
- Salva le impostazioni di connessione per la riconnessione.
- Gestisci il ciclo di vita del container dalla vista Connessioni .
Crea un contenitore SQL Server
Gli screenshot seguenti illustrano la procedura guidata SQL Server, non la procedura guidata database SQL di Azure.
Apri la procedura guidata di distribuzione e scegli contenitore SQL Server sotto Esegui localmente. Puoi anche utilizzare Crea container SQL locale dal menu Connessioni .
Esamina la schermata panoramica e seleziona Get Started.
L'estensione MSSQL verifica automaticamente la presenza di Docker prima della distribuzione:
- Se Docker non è installato, viene visualizzato un messaggio con un collegamento di installazione. È necessario installarlo prima di continuare.
- Se Docker è installato ma non è in esecuzione, viene richiesto di avviarlo. Se l'avvio di Docker fallisce, riprovare o annullare.
Quando vengono soddisfatti tutti i prerequisiti, selezionare Avanti.
Nel pannello Impostazioni di distribuzione :
- Selezionare la versione di SQL Server (SQL Server 2025 (17.x) è selezionata per impostazione predefinita.
- Immettere una password per l'account
sa. - Immettere un nome per il profilo di connessione (facoltativo).
- Imposta facoltativamente il nome del container, la porta e il nome host nelle opzioni avanzate.
- Accettare le condizioni di licenza.
- Selezionare Crea contenitore.
Funzionamento della distribuzione di contenitori SQL
Per SQL Server, dopo aver selezionato Crea container, l'estensione:
- Esegue il pull dell'immagine di SQL Server selezionata (se non è già memorizzata nella cache).
- Crea un contenitore di SQL Server con le impostazioni scelte.
- Esegue il monitoraggio dei log per verificare che tutti i database siano completamente recuperati e pronti.
- Crea un profilo di connessione e si connette al contenitore.
Quando la distribuzione termina, l'estensione MSSQL si collega al container. Crea o seleziona un database utente prima di eseguire query applicative.
Gestire il contenitore
Per entrambi i tipi di container, fai clic destro sul profilo di connessione salvato nella vista Connessioni per gestirne il ciclo di vita.
Lo screenshot seguente mostra un container database SQL di Azure fermato. Il suo menu offre Avvia container SQL e Elimina container SQL. Quando il container è in esecuzione, il menu offre invece Stop SQL Container .
Avviare un contenitore arrestato
Seleziona Avvia contenitore SQL. L'estensione verifica il runtime associato e avvia il contenitore prima di connettersi. Se il runtime non è in esecuzione, segui il prompt per avviarlo.
Fermare un container in esecuzione
Seleziona Ferma container SQL per rilasciare le risorse del container in esecuzione senza eliminarle. I file del database rimangono disponibili quando si riavvia lo stesso container. Questa azione arresta il contenitore, non interrompe la pausa automatica serverless di database SQL di Azure.
Eliminare il contenitore
Seleziona Elimina container SQL e verifica la conferma prima di procedere. La cancellazione rimuove il contenitore e il profilo di connessione selezionato. I dati memorizzati solo all'interno del contenitore vengono persi; i volumi gestiti separatamente hanno un proprio ciclo di vita. Conserva tutti i dati di cui hai bisogno prima della cancellazione.
Importante
Non eliminare un container o il suo storage per risolvere problemi di una connessione a meno che tu non possa scartarne i dati. Se vuoi solo mettere in pausa lo sviluppo, interrompilo invece.
Scenari supportati
Utilizza il container database SQL di Azure per prototipare applicazioni, testare migrazioni, imparare T-SQL ed esplorare vettori e JSON prima della distribuzione cloud. Puoi anche utilizzare l'immagine container in CI, sidecar di applicazioni o laboratori offline; questi workflow specifici per runtime non sono configurati dalla procedura guidata VS Code.
Utilizza il contenitore SQL Server per testare schemi e funzionalità di SQL Server. Non dare per scontato che una funzionalità specifica di SQL Server funzioni in database SQL di Azure solo perché funziona in un container SQL Server.
Risolvere i problemi di sviluppo locale
| Sintomo | Controlli da eseguire |
|---|---|
| L'opzione container database SQL di Azure manca. | Aggiorna l'estensione MSSQL con una versione che includa la procedura guidata di anteprima pubblica e seleziona di nuovo Nuova distribuzione. |
| I controlli dei prerequisiti in runtime falliscono. | Conferma che il runtime selezionato sia installato, in esecuzione e configurato per i container Linux. Correggi il problema segnalato e riprova. |
| Il download dell'immagine fallisce. | Esamina l'errore del registro e verifica la connettività e la configurazione in fase di esecuzione. Non sostituire l'immagine di SQL Server con database SQL di Azure. |
| Il contenitore si avvia ma le connessioni falliscono. | Attendi la prontezza del motore, quindi ispeziona i dettagli degli errori e i log dei container. Verifica la complessità della password e l'allocazione della memoria. Un processo container in esecuzione non dimostra che il database è pronto. |
| Un'applicazione non può raggiungere il database. | Usa la porta host effettiva selezionata dalla guida, non un 1433 presunto.
localhost si riferisce all'host stesso dell'applicazione; un'applicazione in un altro container necessita di un indirizzo di rete container-appropriato. |
| Il database non esiste. | Connettiti a master, crea il database e riconnetti direttamente ad esso. |
USE appdb fallisce. |
Seleziona appdb nelle impostazioni di connessione. Non cambiare database in una sessione utente-database di database SQL di Azure con USE. |
| Un'operazione di gestione SQL Server fallisce. | Verifica se l'operazione è supportata da database SQL di Azure. Ad esempio, BACKUP DATABASE e RESTORE DATABASE non sono supportati. |
Consulta le limitazioni note per le lacune di anteprima attuali e le soluzioni alternative.
Pulire i dati di esempio
Nella tua connessione appdb, conferma che SELECT DB_NAME() restituisce appdb. Se hai creato dbo.Tasks in questa guida e non ne hai più bisogno, rimuovi solo quella tabella di esempio:
DROP TABLE dbo.Tasks;
Non eseguire questa istruzione su una tabella di un altro progetto. Interrompi il contenitore per continuare a usarlo in seguito, oppure eliminalo solo quando non hai più bisogno dei suoi dati.
Sposta dall'ambiente locale al cloud
- Utilizzando l'estensione MSSQL, puoi distribuire il tuo database locale nel cloud. Scopri di più da Local to Cloud.