Scopri come importare un database SQL Server, sia on-premise che su Azure, in Visual Studio Code.
Visual Studio Code (VS Code) è uno strumento potente e versatile per sviluppatori, e uno dei suoi utilizzi meno noti è l’importazione di database SQL. Questo processo non solo consente di lavorare localmente su una copia del database, ma anche di integrare il controllo delle versioni e le pipeline CI/CD di Azure DevOps, senza la necessità di una licenza Visual Studio. Vediamo insieme come fare.
Prerequisiti
Per seguire questa guida, è necessario disporre del seguente software e accesso:
- Visual Studio Code con l’estensione SQL Database Projects o Azure Data Studio
- Connettività di rete e capacità firewall per stabilire una connessione al database SQL desiderato
- Accesso per leggere tutti gli oggetti di schema del database tramite SQL Login o Microsoft Entra ID
Importare il Database
Esaminiamo ora, passo dopo passo, come scaricare e ricreare i file di schema del database sulla macchina locale, creando così il progetto .sqlproj.
Creare il Profile di Connessione
Avvia VS Code o Azure Data Studio. Utilizza il Command Pallet (Ctrl+Shift+P) e digita “Database Projects” per selezionare “Database Projects: Create Project From Database”. Sarà possibile creare un nuovo profilo di connessione o usarne uno già esistente.
Inserisci la stringa di connessione, utilizzando soltanto l’indirizzo del server e specificando eventualmente il nome del database, ad esempio “sqlmoveme”. Sarà poi richiesto di autenticarsi tramite Microsoft Entra ID o SQL Login.
Scaricare il Database
Una volta connesso, VS Code richiederà di dare un nome al progetto e selezionare la cartella in cui scaricare i file. Consigliamo di scegliere la struttura “Schema/Object Type”. Evita di includere script di autorizzazione per evitare la memorizzazione di credenziali.
Preferisci il formato dei progetti SDK per facilitare il processo di build con il comando ‘dotnet build’ e per evitare la necessità di utilizzare Visual Studio. Al termine, il database sarà scaricato localmente.
Confermare la Copia Locale
Controlla le cartelle degli schemi del database (es. “dbo” e “SalesLT”) per verificarne i contenuti e apportare eventuali modifiche, come aggiungere una colonna. Salva le modifiche e assicurati che siano riflettute nel file system locale.
Costruire il Database
Dopo aver confermato le modifiche locali, utilizza il comando ‘dotnet build’ nel terminale di VS Code per creare l’artifact deployable .dacpac.
Prossimi Passi
Il file .dacpac può essere distribuito tramite SQL Server Management Studio, Azure Data Tools o una pipeline CI/CD in Azure DevOps. La prossima guida spiegherà come spingere il progetto su un sistema di controllo delle versioni.