Compartilhar via


Visão geral da plataforma de destino

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

A definição de plataforma de destino é uma propriedade do projeto usada durante a compilação do projeto para validar o suporte aos recursos incluídos nele, como sintaxe T-SQL e funções do sistema. A configuração da plataforma de destino é incorporada ao artefato de build .dacpac e, durante a implantação, a configuração da plataforma de destino é verificada em relação ao banco de dados de destino para garantir a compatibilidade. Se a plataforma de destino não corresponder ao banco de dados, a implantação não será iniciada, a menos que a propriedade de publicação /p:AllowIncompatiblePlatform=true seja especificada.

Exemplo e sintaxe do arquivo de projeto SQL

A propriedade de projeto da plataforma de destino está contida na marca DSP do arquivo .sqlproj sob o item <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>
...

Os valores válidos para a plataforma de destino na marca DSP incluem:

  • 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 (Banco de Dados SQL do Azure)
  • Microsoft.Data.Tools.Schema.Sql.SqlDbFabricDatabaseSchemaProvider (Banco de Dados SQL Espelhado do Fabric, versão prévia)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider (Pool de SQL do Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider (Pool de SQL Sem Servidor do Azure Synapse)
  • Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider (Data Warehouse do Synapse no Microsoft Fabric)

Alterar a plataforma de destino

Para alterar a plataforma de destino de um projeto SQL no Visual Studio, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Propriedades. Na guia Configurações do projeto da janela Propriedades, selecione a plataforma de destino desejada na lista suspensa Plataforma de destino.

Para alterar a plataforma de destino de um projeto SQL no Visual Studio, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Propriedades. Na guia Configurações do projeto da janela Propriedades, selecione a plataforma de destino desejada na lista suspensa Plataforma de destino.

Para alterar a plataforma de destino de um projeto SQL na extensão Projetos do Banco de Dados SQL, clique com o botão direito do mouse no projeto na exibição Projetos de Banco de Dados e selecione Alterar plataforma de destino. Selecione a nova plataforma de destino na lista suspensa.

Como alternativa, você pode editar o arquivo .sqlproj diretamente para alterar a plataforma de destino. Abra o arquivo .sqlproj na exibição Explorer ou clicando com o botão direito do mouse no projeto na exibição Projetos de Banco de Dados e selecionando Editar Arquivo .sqlproj. No editor de texto, altere o valor na marca DSP para a plataforma de destino desejada.

Para criar um projeto SQL para uma plataforma de destino diferente da plataforma de destino especificada no arquivo.sqlproj, use o argumento de linha de comando /p:DSP=. Por exemplo, para criar um projeto SQL para compatibilidade com o SQL Server 2019:

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

Publicar em uma plataforma de destino diferente

Quando você publica um projeto SQL, a plataforma de destino do projeto deve corresponder à plataforma de destino do banco de dados. Se as plataformas de destino não corresponderem, a implantação será encerrada antes de aplicar qualquer alteração com um erro. Para publicar um projeto em um banco de dados com uma plataforma de destino diferente, use a propriedade de publicação /p:AllowIncompatiblePlatform=true.