Bagikan melalui


Gambaran umum platform target

Berlaku untuk: SQL ServerAzure SQL Database Azure SQL Managed Instance

Pengaturan platform target adalah properti proyek yang digunakan selama build proyek untuk memvalidasi dukungan untuk fitur yang disertakan dalam proyek, seperti sintaks T-SQL dan fungsi sistem. Pengaturan platform target dimasukkan ke dalam .dacpac artefak build dan selama penyebaran, pengaturan platform target diperiksa terhadap database target untuk memastikan kompatibilitas. Jika platform target tidak cocok dengan database, penyebaran tidak dimulai kecuali properti /p:AllowIncompatiblePlatform=true terbitkan ditentukan.

Sampel dan sintaks file proyek SQL

Properti proyek platform target terkandung dalam DSP tag dalam file di .sqlproj <PropertyGroup> bawah item:

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

Nilai yang valid untuk platform target dalam DSP tag meliputi:

  • 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 (Azure SQL Database)
  • Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider (Fabric Mirrored SQL Database, pratinjau)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider (Kumpulan SQL Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider (Kumpulan SQL Tanpa Server Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider (Gudang Data Synapse di Microsoft Fabric)

Mengubah platform target

Untuk mengubah platform target proyek SQL di Visual Studio, klik kanan proyek di Penjelajah Solusi dan pilih Properti. Di tab Pengaturan Proyek dari jendela properti, pilih platform target yang diinginkan dari daftar dropdown Platform target.

Untuk mengubah platform target proyek SQL di Visual Studio, klik kanan proyek di Penjelajah Solusi dan pilih Properti. Di tab Pengaturan Proyek dari jendela properti, pilih platform target yang diinginkan dari daftar dropdown Platform target.

Untuk mengubah platform target proyek SQL di ekstensi Proyek SQL Database, klik kanan proyek dalam tampilan Proyek Database dan pilih Ubah Platform Target. Pilih platform target baru dari daftar dropdown.

Atau, Anda dapat mengedit .sqlproj file secara langsung untuk mengubah platform target. .sqlproj Buka file dari tampilan Explorer atau dengan mengklik kanan proyek dalam tampilan Proyek Database dan pilih Edit File .sqlproj. Dari editor teks, ubah nilai dalam tag DSP ke platform target yang diinginkan.

Untuk membangun proyek SQL untuk platform target yang berbeda dari platform target yang ditentukan dalam .sqlproj file, gunakan /p:DSP= argumen baris perintah. Misalnya, untuk membangun proyek SQL untuk kompatibilitas SQL Server 2019:

dotnet build /p:DSP=Microsoft.Data.Tools.Schema.Sql.Sql150DatabaseSchemaProvider

Menerbitkan ke platform target yang berbeda

Saat Anda menerbitkan proyek SQL, platform target proyek harus cocok dengan platform target database. Jika platform target tidak cocok, penyebaran akan keluar sebelum menerapkan perubahan apa pun dengan kesalahan. Untuk menerbitkan proyek ke database dengan platform target yang berbeda, gunakan properti terbitkan./p:AllowIncompatiblePlatform=true