Compartir vía


Introducción a la plataforma de destino

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

La configuración de plataforma de destino es una propiedad del proyecto que se usa durante la compilación del proyecto para validar la compatibilidad con las características incluidas en el proyecto, como la sintaxis T-SQL y las funciones del sistema. La configuración de plataforma de destino se incorpora al artefacto de compilación .dacpac y, durante la implementación, la configuración de plataforma de destino se comprueba en la base de datos de destino para garantizar la compatibilidad. Si la plataforma de destino no coincide con la base de datos, la implementación no se inicia a menos que se especifique la propiedad de publicación /p:AllowIncompatiblePlatform=true.

Ejemplo y sintaxis del archivo de proyecto SQL

La propiedad de plataforma de destino del proyecto se encuentra en la etiqueta DSP del archivo .sqlproj, en el elemento <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>
...

Los valores válidos para la plataforma de destino de la etiqueta DSP incluyen:

  • 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 (Base de datos SQL reflejada de Fabric, versión preliminar)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider (Grupo de SQL de Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider (Grupo de SQL sin servidor de Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider (Almacenamiento de datos de Synapse en Microsoft Fabric)

Modificación de la plataforma de destino

Para cambiar la plataforma de destino de un proyecto SQL, haga clic con el botón derecho en el proyecto en el Explorador de soluciones y seleccione Propiedades. En la pestaña Configuración del proyecto de la ventana Propiedades, seleccione la plataforma de destino deseada en la lista desplegable Plataforma de destino.

Para cambiar la plataforma de destino de un proyecto SQL, haga clic con el botón derecho en el proyecto en el Explorador de soluciones y seleccione Propiedades. En la pestaña Configuración del proyecto de la ventana Propiedades, seleccione la plataforma de destino deseada en la lista desplegable Plataforma de destino.

Para cambiar la plataforma de destino de un proyecto SQL en la extensión Proyectos de base de datos SQL, haga clic derecho sobre el proyecto en la vista Proyectos de base de datos y seleccione Cambiar plataforma de destino. Seleccione la nueva plataforma de destino en la lista desplegable.

Como alternativa, puede editar el archivo .sqlproj directamente para cambiar la plataforma de destino. Abra el archivo .sqlproj desde la vista Explorador o haga clic con el botón derecho sobre el proyecto en la vista Proyectos de base de datos y seleccione Editar el archivo .sqlproj. En el editor de texto, cambie el valor de la etiqueta DSP a la plataforma de destino deseada.

Para compilar un proyecto SQL para una plataforma de destino diferente de la plataforma de destino especificada en el archivo .sqlproj, use el argumento /p:DSP= de la línea de comandos. Por ejemplo, para compilar un proyecto SQL para compatibilidad con SQL Server 2019:

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

Publicación en una plataforma de destino diferente

Al publicar un proyecto SQL, la plataforma de destino del proyecto debe coincidir con la plataforma de destino de la base de datos. Si las plataformas de destino no coinciden, la implementación se cierra con un error antes de aplicar los cambios. Para publicar un proyecto en una base de datos con una plataforma de destino diferente, use la propiedad de Publish /p:AllowIncompatiblePlatform=true.