Visão geral da plataforma de destino
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do Azurebanco de dados SQL no Microsoft Fabric
A configuração da plataforma de destino é uma propriedade do projeto que é usada durante a compilação do projeto para validar o suporte para recursos incluídos no projeto, como sintaxe T-SQL e funções do sistema. A configuração da plataforma de destino é incorporada ao artefato de compilação do .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 começará a menos que a propriedade publish/p:AllowIncompatiblePlatform=true seja especificada.
Exemplo de arquivo de projeto SQL e sintaxe
A propriedade do projeto da plataforma de destino está contida na etiqueta DSP no arquivo .sqlproj no item <PropertyGroup>:
<Project DefaultTargets="Build">
<Sdk Name="Microsoft.Build.Sql" Version="1.0.0" />
<PropertyGroup>
<Name>AdventureWorks</Name>
<DSP>Microsoft.Data.Tools.Schema.Sql.SqlAzureV12DatabaseSchemaProvider</DSP>
</PropertyGroup>
...
Os valores válidos para a plataforma de destino na tag 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 em Fabric ou Banco de dados SQL espelhado em Fabric, pré-visualização) -
Microsoft.Data.Tools.Schema.Sql.SqlDwDatabaseSchemaProvider(Azure Synapse SQL Pool) -
Microsoft.Data.Tools.Schema.Sql.SqlServerlessDatabaseSchemaProvider(Azure Synapse Serverless SQL Pool) -
Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider(Armazém de Dados 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 em Gerenciador de Soluções e selecione Propriedades. Na guia Configurações do Projeto da janela de 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 em Gerenciador de Soluções e selecione Propriedades. Na guia Configurações do Projeto da janela de 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 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 visualização do Explorer ou clicando com o botão direito do mouse no projeto na visualização Projetos de Banco de Dados e selecionando Editar arquivo .sqlproj. No editor de texto, altere o valor na tag 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 com um erro antes de aplicar quaisquer alterações. Para publicar um projeto num banco de dados com uma plataforma de destino diferente, use a propriedade de publicação /p:AllowIncompatiblePlatform=true.