Panoramica della piattaforma di destinazione
Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure
L'impostazione della piattaforma di destinazione è una proprietà del progetto che viene utilizzata durante la compilazione del progetto per convalidare il supporto delle caratteristiche incluse nel progetto, come la sintassi T-SQL e le funzioni di sistema. L'impostazione della piattaforma di destinazione viene incorporata nell'artefatto di compilazione .dacpac
e durante la distribuzione l'impostazione della piattaforma di destinazione viene controllata sul database di destinazione per garantire la compatibilità. Se la piattaforma di destinazione non corrisponde al database, la distribuzione non inizia a meno che non venga specificata la proprietà /p:AllowIncompatiblePlatform=true
di pubblicazione.
Esempio e sintassi del file di progetto SQL
La proprietà del progetto della piattaforma di destinazione è contenuta nel tag DSP
nel file .sqlproj
sotto l'articolo <PropertyGroup>
:
<Project DefaultTargets="Build">
<Sdk Name="Microsoft.Build.Sql" Version="0.2.0-preview" />
<PropertyGroup>
<Name>AdventureWorks</Name>
<DSP>Microsoft.Data.Tools.Schema.Sql.SqlAzureV12DatabaseSchemaProvider</DSP>
</PropertyGroup>
...
I valori validi per la piattaforma di destinazione nel tag DSP
includono:
Microsoft.Data.Tools.Schema.Sql.Sql120DatabaseSchemaProvider
(SQL Server 2014)Microsoft.Data.Tools.Schema.Sql.Sql130DatabaseSchemaProvider
(SQL Server 2016)Microsoft.Data.Tools.Schema.Sql.Sql140DatabaseSchemaProvider
(SQL Server 2017)Microsoft.Data.Tools.Schema.Sql.Sql150DatabaseSchemaProvider
(SQL Server 2019)Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider
(SQL Server 2022)Microsoft.Data.Tools.Schema.Sql.SqlAzureV12DatabaseSchemaProvider
(Database SQL di Azure)Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider
(Database SQL con mirroring dell'infrastruttura, anteprima)Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider
(Pool SQL di Azure Synapse)Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider
(Pool SQL serverless di Azure Synapse)Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider
(Data Warehouse Synapse in Microsoft Fabric)
Modificare la piattaforma di destinazione
Per modificare la piattaforma di destinazione di un progetto SQL in Visual Studio, fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Proprietà. Nella scheda Impostazioni progetto della finestra delle proprietà selezionare la piattaforma di destinazione desiderata dall'elenco a discesa Piattaforma di destinazione.
Per modificare la piattaforma di destinazione di un progetto SQL in Visual Studio, fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Proprietà. Nella scheda Impostazioni progetto della finestra delle proprietà selezionare la piattaforma di destinazione desiderata dall'elenco a discesa Piattaforma di destinazione.
Per modificare la piattaforma di destinazione di un progetto SQL nell'estensione progetti database SQL, fare clic con il pulsante destro del mouse sul progetto nella vista Progetti di database e scegliere Cambia piattaforma di destinazione. Selezionare la nuova piattaforma di destinazione dall'elenco a discesa.
In alternativa, è possibile modificare il file .sqlproj
direttamente per modificare la piattaforma di destinazione. Aprire il file .sqlproj
dalla vista Esplora oppure facendo clic con il pulsante destro del mouse sul progetto nella vista Progetti di database e scegliendo Modifica file con estensione sqlproj. Nell'editor di testo modificare il valore nel tag DSP impostando la piattaforma di destinazione desiderata.
Per compilare un progetto SQL per una piattaforma di destinazione diversa dalla piattaforma di destinazione specificata nel file .sqlproj
, usare l'argomento della riga di comando /p:DSP=
. Ad esempio, per compilare un progetto SQL per la compatibilità di SQL Server 2019:
dotnet build /p:DSP=Microsoft.Data.Tools.Schema.Sql.Sql150DatabaseSchemaProvider
Pubblicare in una piattaforma di destinazione diversa
Quando si pubblica un progetto SQL, la piattaforma di destinazione del progetto deve corrispondere alla piattaforma di destinazione del database. Se le piattaforme di destinazione non corrispondono, la distribuzione viene chiusa prima di applicare eventuali modifiche con un errore. Per pubblicare un progetto in un database con una piattaforma di destinazione diversa, usare la /p:AllowIncompatiblePlatform=true
proprietà di pubblicazione.