Progetti in SQL Server Management Studio

Si applica a: SQL Serverdatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)endpoint di analisi SQL in Microsoft FabricWarehouse in Microsoft Fabricdatabase SQL in Microsoft Fabric

SQL Server Management Studio è una suite di strumenti di amministrazione per la gestione dei componenti appartenenti a SQL Server. Con questo ambiente integrato, è possibile eseguire varie attività, ad esempio il backup dei dati, la modifica di query e l'automazione di funzioni comuni all'interno di una singola interfaccia.

SQL Server Management Studio include gli strumenti seguenti:

  • Editor di codice è un editor di script avanzato per la scrittura e la modifica di script. SQL Server Management Studio offre quattro versioni dell'editor di codice: l'editor di query del motore di database per gli script Transact-SQL, l'editor di query DMX, l'editor di query MDX e l'editor di query XML/A.

  • Esplora oggetti per individuare, modificare, creare script o eseguire oggetti appartenenti a istanze di SQL Server.

  • Template Explorer per individuare e scrivere script per i modelli.

  • Esplora soluzioni per organizzare e archiviare gli script correlati come parti di un progetto.

  • Finestra Proprietà per visualizzare le proprietà correnti degli oggetti selezionati.

SQL Server Management Studio supporta processi di lavoro efficienti fornendo:

  • Accesso disconnesso. È possibile scrivere e modificare script senza connettersi a un'istanza di SQL Server.

  • Scripting da qualsiasi finestra di dialogo. È possibile creare uno script da qualsiasi finestra di dialogo in modo da poter leggere, modificare, archiviare e riutilizzare gli script dopo averli creati.

  • Finestre di dialogo non modali. Quando si accede a una finestra di dialogo dell'interfaccia utente, è possibile esplorare altre risorse in SQL Server Management Studio senza chiudere la finestra di dialogo.

Progetti di script in SSMS

Un progetto script di database è un set organizzato di script, informazioni di connessione e modelli associati a un database o a una parte di un database. SQL Server fornisce SQL Server Management Studio per amministrare e progettare database DI SQL Server nel contesto di un progetto script. SQL Server Management Studio include finestre di progettazione, editor, guide e procedure guidate per facilitare lo sviluppo, la distribuzione e la gestione dei database.

Quando si salva uno script in un progetto script, è possibile:

  • Mantenere il controllo della versione sugli script.
  • Archiviare le opzioni dei risultati con uno script.
  • Organizzare gli script correlati in un singolo progetto di script.
  • Salvare le informazioni di connessione con gli script.

Progetti di database SQL in SSMS

Un progetto di database SQL è una rappresentazione locale degli oggetti SQL che costituiscono lo schema di un database singolo, ad esempio tabelle, stored procedure o funzioni. Il ciclo di sviluppo di un progetto di database SQL consente di integrare lo sviluppo di database in flussi di lavoro di integrazione continua e distribuzione continua (CI/CD) familiari come procedure consigliate per lo sviluppo. In SSMS è possibile usare Microsoft.Build.Sql i progetti per implementare, gestire e collaborare alle modifiche del database, fornendo una definizione locale degli oggetti di database.

Quando un progetto SQL viene compilato, convalida le relazioni tra gli oggetti. Ad esempio, una definizione di una visualizzazione non può contenere una tabella o colonne che non esistono nel progetto SQL. Il file di output () .dacpacè un artefatto potente, riutilizzabile e dichiarativo. Con questo file, è possibile applicare il codice del database a un database usando SSMS, l'interfaccia della riga di comando di SqlPackage o altri strumenti di progetti SQL. Il processo di pubblicazione calcola anche la differenza tra un database di origine .dacpac e un database di destinazione prima di determinare quali passaggi è necessario eseguire per aggiornare il database.

I progetti di database SQL sono ideali per i team che vogliono integrare lo sviluppo di database in un flusso di lavoro CI/CD. La natura dichiarativa dei progetti SQL consente una singola origine di verità per lo schema del database e il processo di compilazione e pubblicazione offre un modo ripetibile e affidabile per distribuire le modifiche ai database. Per altre informazioni sui progetti di database SQL, vedere Che cosa sono i progetti di database SQL?.

Prerequisites

I prerequisiti seguenti si applicano ai progetti di database SQL, non ai progetti script o alle procedure guidate DACPAC e BACPAC.

Creazione di un nuovo progetto

Per usare i progetti di database SQL in SSMS, è necessaria una cartella locale contenente i file di progetto. È possibile avviare un progetto estraendo oggetti da un database esistente o creando nuovi file oggetto da zero.

Screenshot della finestra di dialogo Nuovo Project in SQL Server Management Studio.

Note

SSMS potrebbe richiedere di connettersi a un server quando si apre un file da Esplora soluzioni. È possibile eseguire lo sviluppo di progetti di database SQL offline senza connettersi a un database.

Aggiungere oggetti da un database esistente

Usare SqlPackage per estrarre lo schema da un database esistente in singoli .sql file organizzati per tipo di oggetto. Eseguire il comando seguente per creare una struttura di cartelle con gli oggetti di database:

sqlpackage /Action:Extract /SourceConnectionString:"<connection-string>" /TargetFile:"<temp-folder>" /p:ExtractTarget=SchemaObjectType

Il /p:ExtractTarget=SchemaObjectType parametro organizza i file estratti in sottocartelle in base allo schema e al tipo di oggetto , ad esempio dbo/Tables, dbo/StoredProcedures. Estrarre in una cartella temporanea al di fuori della directory del progetto e quindi usare Esplora file per copiare il contenuto desiderato nella cartella del progetto.

Per altre informazioni sulle opzioni di estrazione di SqlPackage, vedere Estrazione di SqlPackage.

Creare nuovi oggetti

Aggiungere nuovi oggetti di database al progetto creando .sql file nella cartella del progetto. Ogni file deve contenere una singola CREATE istruzione per un oggetto di database. Ad esempio, una definizione di tabella:

CREATE TABLE [dbo].[Products]
(
    [ProductId] INT NOT NULL PRIMARY KEY,
    [ProductName] NVARCHAR (100) NOT NULL,
    [Price] DECIMAL (10, 2) NOT NULL
);

Organizzare i file in base allo schema e al tipo di oggetto usando sottocartelle, ad esempio dbo/Tables o Sales/StoredProcedures. Questa struttura corrisponde all'output dell'estrazione di SqlPackage e semplifica l'individuazione degli oggetti man mano che aumenta il progetto. Il processo di compilazione del progetto SQL include tutti i .sql file nella cartella del progetto e nelle relative sottocartelle per impostazione predefinita.

SSMS fornisce modelli per gli elementi comuni che consentono di iniziare. Per aggiungere un nuovo elemento, fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, selezionare Aggiungi>nuovo elemento e scegliere dall'elenco dei modelli di oggetto SQL.

Aprire progetti esistenti

Per aprire un progetto di database SQL esistente in SSMS, selezionare File>Apri>progetto/soluzione e passare al .sqlproj file.

Importante

SSMS supporta solo progetti in stile Microsoft.Build.Sql SDK. La versione minima supportata dell'SDK è 2.1.0. Se è stato creato un progetto SQL originale in Visual Studio, è necessario convertirlo nel formato in stile SDK prima di aprirlo.

Per indicazioni sulla conversione di progetti SQL originali nel formato in stile SDK, vedere Convertire un progetto SQL originale in un progetto in stile SDK.

Compilare progetti e distribuire le modifiche

Il flusso di lavoro del progetto SQL è costituito da due passaggi principali: la compilazione del progetto per convalidare e compilare lo schema e distribuire l'output compilato in un database di destinazione.

La compilazione del progetto

La compilazione di un progetto SQL convalida le relazioni tra oggetti e controlla la sintassi T-SQL rispetto alla piattaforma di destinazione specificata. Il processo di compilazione produce un .dacpac file contenente un modello compilato dello schema del database.

Per compilare un progetto in SSMS, fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Compila.

Screenshot di Esplora soluzioni che mostra l'opzione di compilazione del progetto SQL.

L'output di compilazione visualizza eventuali errori o avvisi. Gli errori indicano problemi che impediscono la distribuzione, ad esempio una vista che fa riferimento a una tabella che non esiste. Gli avvisi evidenziano potenziali problemi, come l'uso incoerente di maiuscole nei nomi degli oggetti.

In una compilazione completata, il .dacpac file viene creato nella cartella all'interno della bin\Debug directory del progetto.

Per altre informazioni sulla risoluzione dei problemi di compilazione, vedere Risolvere gli errori di compilazione del progetto SQL.

Distribuisci le modifiche

Dopo aver compilato il progetto, distribuisci il .dacpac a un database di destinazione usando la finestra di dialogo 'Pubblica' di SSMS. Il processo di distribuzione confronta il .dacpac con il database di destinazione e genera le istruzioni CREATE, ALTER o DROP necessarie per sincronizzare il database con il tuo progetto.

Per eseguire la distribuzione, fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Pubblica. Nella finestra di dialogo Pubblica configurare la connessione al database di destinazione e selezionare Pubblica per applicare le modifiche o Genera script per esaminare lo script di distribuzione prima dell'esecuzione.

Screenshot della finestra di dialogo Pubblica per la distribuzione delle modifiche del Project di database SQL.

Il processo di pubblicazione è idempotente, quindi è possibile distribuire più volte lo stesso .dacpac senza causare problemi. Questo approccio consente di eseguire la distribuzione in più ambienti (sviluppo, staging, produzione) usando lo stesso artefatto compilato.

Per informazioni dettagliate sulle opzioni di distribuzione e sulla configurazione, vedere Introduzione ai progetti di database SQL.

Soluzioni e progetti

SQL Server Management Studio condivide il concetto di soluzioni e progetti con Microsoft Visual Studio. Una soluzione è un contenitore per uno o più progetti, insieme alle impostazioni della finestra e a tutti i file esterni non associati a un determinato progetto.

Esplora soluzioni è una finestra degli strumenti in SSMS usata per archiviare e riaprire soluzioni di database. Se hai creato applicazioni con Visual Studio, ti sarà familiare Esplora soluzioni.

Se non viene visualizzata la finestra degli strumenti esplora soluzioni, è possibile aprirla dalla barra dei menu di SSMS usando Visualizza>Esplora soluzioni o premendo CTRL+ALT+L.