Condividi tramite

Contenitore di SQL Server locale

La funzionalità contenitore di SQL Server locale nell'estensione MSSQL per Visual Studio Code semplifica lo sviluppo locale consentendo agli sviluppatori di attivare contenitori di SQL Server completamente configurati senza scrivere un singolo comando Docker. È possibile distribuire e gestire i contenitori direttamente dalla visualizzazione Connessioni. Questa nuova funzionalità è perfetta per la creazione di prototipi, lo sviluppo o il test dei carichi di lavoro usando lo stesso motore di database disponibile negli ambienti di produzione.

Screenshot che mostra l'animazione della procedura guidata Contenitore locale parte 1.

Per impostazione predefinita, la procedura guidata del contenitore usa SQL Server 2025 (17.x), che include funzionalità pronte per l'intelligenza artificiale, ad esempio tipi di dati vettoriali e funzioni JSON. È anche possibile scegliere tra SQL Server 2022 (16.x), SQL Server 2019 (15.x) o SQL Server 2017 (14.x), a seconda delle esigenze di test.

Screenshot che mostra l'animazione della procedura guidata Contenitore locale parte due.

Annotazioni

L'esperienza contenitore di SQL Server locale funziona in macOS, Windows e Linux, purché Docker Desktop (o un equivalente) sia in esecuzione in modalità contenitore Linux.

Funzionalità

Il contenitore di SQL Server locale nell'estensione MSSQL offre le funzionalità seguenti:

  • Creare un contenitore SQL Server locale senza scrivere comandi Docker.
  • Scegliere tra più versioni di SQL Server (SQL Server 2025 (17.x) (impostazione predefinita), SQL Server 2022 (16.x), SQL Server 2019 (15.x) e SQL Server 2017 (14.x)).
  • Personalizzare il nome del contenitore, il nome host e la porta.
  • Controllare automaticamente l'installazione di Docker e lo stato in esecuzione prima della distribuzione.
  • Assegnare automaticamente una porta disponibile se 1433 è già in uso.
  • Connessione automatica e persistenza delle impostazioni di connessione tra i riavvii del contenitore.
  • Gestire il ciclo di vita del contenitore (avvio, arresto, eliminazione) dal menu di scelta rapida nella visualizzazione Connessioni.
  • Usare con tutte le funzionalità principali dell'estensione MSSQL, tra cui Esplora oggetti, Progettazione tabelle, Progettazione schemi, Editor di query e GitHub Copilot.

Importante

I contenitori locali sono destinati solo allo sviluppo. Le implementazioni di produzione non sono supportate.

Creare un contenitore locale

Per creare un contenitore SQL Server locale:

  1. Nella visualizzazione Connessioni selezionare l'opzione Crea contenitore SQL locale dal menu.

    Screenshot che mostra come creare l'opzione contenitore di SQL Server locale nell'estensione MSSQL.

  2. Esamina la schermata Panoramica, che mette in evidenza cosa puoi aspettarti dall'esperienza con il contenitore locale di SQL Server.

    Quando si è pronti, selezionare Inizia per continuare.

    Screenshot della schermata di panoramica per la distribuzione locale del contenitore di SQL Server con collegamenti utili e pulsante Inizia.

  3. 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.

    Dopo aver soddisfatto tutti i prerequisiti, selezionare Avanti per continuare con la distribuzione.

    Screenshot della verifica dei prerequisiti di Docker nell'estensione MSSQL.

  4. Nel pannello Impostazioni di distribuzione :

    1. Selezionare la versione di SQL Server (SQL Server 2025 (17.x) è selezionata per impostazione predefinita.
    2. Immettere una password per l'account sa .
    3. Immettere un nome per il profilo di connessione (facoltativo).
    4. Facoltativamente, completare le opzioni avanzate:
      • Nome contenitore
      • Porto
      • Nome host
    5. Accettare le condizioni di licenza.
    6. Selezionare Crea contenitore.

    Screenshot del modulo di configurazione dell'installazione del contenitore.

Funzionamento della distribuzione di contenitori SQL

Dopo aver selezionato Crea contenitore, l'estensione gestisce tutti gli elementi necessari:

  • 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
  • Monitora i log per verificare che tutti i database siano completamente ripristinati e pronti
  • Crea un profilo di connessione e si connette al contenitore

Al termine della distribuzione, viene avviato il contenitore e l'estensione MSSQL si connette automaticamente al nuovo database.

Gestire il contenitore

Per gestire il contenitore, fare clic con il pulsante destro del mouse sul nome del profilo di connessione nella visualizzazione Connessioni . Dal menu di scelta rapida è possibile:

Avviare un contenitore arrestato

L'estensione controlla se Docker è in esecuzione prima di avviare il contenitore. Se Docker non è in esecuzione, viene richiesto di avviarlo.

Fermare un container in esecuzione

Questa opzione arresta il contenitore mantenendo lo stato del database. È possibile riavviarlo in qualsiasi momento dallo stesso menu.

Eliminare il contenitore

Questa opzione rimuove definitivamente il contenitore e i relativi dati. Ti viene chiesto di confermare prima di procedere.

Screenshot che mostra come gestire il ciclo di vita del contenitore nell'estensione MSSQL.

Importante

L'eliminazione di un contenitore rimuove anche il profilo di connessione associato.

Esperienza di riconnessione automatica

Se il tuo contenitore o Docker non è in esecuzione quando ti riconnetti, l'estensione ti chiede di avviarli. Non è necessario risolvere i problemi manualmente.

Scenari supportati

È possibile usare il contenitore SQL Server locale con tutte le funzionalità di base dell'estensione MSSQL:

  • Editor di query e IntelliSense
  • Progettazione tabelle e Progettazione schemi
  • GitHub Copilot
  • Esplora oggetti e gestione connessione

Questa funzionalità rende il contenitore SQL Server locale ideale per:

  • Creazione di prototipi di nuove funzionalità
  • Test delle modifiche dello schema
  • Esecuzione di test automatizzati in ambienti isolati
  • Esperimento con le funzionalità di SQL Server 2025 (17.x)

Limitazioni

  • Richiede l'installazione e l'esecuzione di Docker Desktop (o equivalente).
  • Sono supportati solo i contenitori di SQL Server basati su Linux (SQL Server 2017 (14.x) e versioni successive.
  • Nessun supporto per Podman.
  • Il backup/ripristino, il clustering, l'inizializzazione di script e Docker Compose non sono supportati tramite la procedura guidata predefinita, ma è possibile eseguire queste attività manualmente usando strumenti o comandi esterni.
  • Progettato esclusivamente per lo sviluppo locale, non per l'uso in produzione.
  • I problemi relativi all'installazione, alla configurazione o al runtime di Docker devono essere risolti dall'utente.
  • Assicurarsi che il computer disponga di risorse sufficienti o di regolare l'allocazione di memoria di Docker e i limiti delle risorse del contenitore tramite le impostazioni di Docker per garantire prestazioni stabili.
  • Requisiti di memoria:
    • SQL Server richiede almeno 2 GB di memoria per avviare un contenitore basato su Linux.
    • Per impostazione predefinita, SQL Server in Linux usa circa 80% della memoria disponibile per il contenitore.

Contenuti correlati

  • Last updated on