Übersicht: Zielplattform

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

Die Einstellung für die Zielplattform ist eine Projekteigenschaft, die während der Projekterstellung verwendet wird, um die Unterstützung für im Projekt enthaltene Funktionen, wie T-SQL-Syntax und Systemfunktionen, zu überprüfen. Die Zielplattformeinstellung wird in das .dacpac-Buildartefakt integriert und während der Bereitstellung wird die Zielplattformeinstellung auf die Zieldatenbank überprüft, um die Kompatibilität sicherzustellen. Wenn die Zielplattform nicht mit der Datenbank kompatibel ist, beginnt die Bereitstellung erst, wenn die Veröffentlichungseigenschaft /p:AllowIncompatiblePlatform=true angegeben ist.

SQL-Projektdateibeispiel und Syntax

Die Zielplattformprojekteigenschaft ist im DSP-Tag in der .sqlproj-Datei unter dem <PropertyGroup>-Element enthalten:

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

Gültige Werte für die Zielplattform im DSP-Tag umfassen:

  • 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-Datenbank)
  • Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider (Fabric Mirrored SQL-Datenbank, Vorschau)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider (Azure Synapse SQL-Pool)
  • Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider (Serverloser SQL-Pool in Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider (Synapse Data Warehouse in Microsoft Fabric)

Ändern der Zielplattform

Um die Zielplattform eines SQL-Projekts in Visual Studio zu ändern, klicken Sie mit der rechten Maustaste auf das Projekt im Projektmappen-Explorer und wählen Sie Eigenschaften. Wählen Sie auf der Registerkarte Projekteinstellungen des Eigenschaftenfensters die gewünschte Zielplattform aus der Dropdownliste Zielplattform aus.

Um die Zielplattform eines SQL-Projekts in Visual Studio zu ändern, klicken Sie mit der rechten Maustaste auf das Projekt im Projektmappen-Explorer und wählen Sie Eigenschaften. Wählen Sie auf der Registerkarte Projekteinstellungen des Eigenschaftenfensters die gewünschte Zielplattform aus der Dropdownliste Zielplattform aus.

Wenn Sie die Zielplattform eines SQL-Projekts in der Erweiterung SQL Database Projects ändern möchten, klicken Sie in der Ansicht Datenbankprojekte mit der rechten Maustaste auf das Projekt, und wählen Sie Zielplattform ändern aus. Wählen Sie die neue Zielplattform aus der Dropdownliste aus.

Alternativ können Sie die .sqlproj-Datei direkt bearbeiten, um die Zielplattform zu ändern. Öffnen Sie die .sqlproj-Datei aus der Explorer-Ansicht oder klicken Sie mit der rechten Maustaste auf das Projekt in der Ansicht Datenbankprojekte und wählen Sie SQLPROJ-Datei bearbeiten aus. Ändern Sie im Text-Editor den Wert im DSP-Tag auf die gewünschte Zielplattform.

Verwenden Sie das /p:DSP=-Befehlszeilenargument, um ein SQL-Projekt für eine Zielplattform zu erstellen, die sich von der in der .sqlproj-Datei angegebenen Zielplattform unterscheidet. So erstellen Sie beispielsweise ein SQL-Projekt für die SQL Server 2019-Kompatibilität:

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

Veröffentlichen auf einer anderen Zielplattform

Wenn Sie ein SQL-Projekt veröffentlichen, muss die Zielplattform des Projekts mit der Zielplattform der Datenbank übereinstimmen. Wenn die Zielplattformen nicht übereinstimmen, wird die Bereitstellung beendet, bevor Änderungen mit einem Fehler angewendet werden. Verwenden Sie die /p:AllowIncompatiblePlatform=true-Veröffentlichungseigenschaft, um ein Projekt in einer Datenbank mit einer anderen Zielplattform zu veröffentlichen.

Zugehöriger Inhalt