Propriedades de projetos SQL

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de dados SQL no Microsoft Fabric

Além do conteúdo dos arquivos individuais .sql , os projetos do banco de dados SQL contêm propriedades que definem o comportamento do projeto e as configurações no nível do banco de dados. Essas propriedades são armazenadas no .sqlproj arquivo e podem ser definidas editando o .sqlproj arquivo diretamente. Algumas ferramentas de projetos SQL, como Visual Studio e VS Code, fornecem acesso para editar algumas ou muitas das propriedades do projeto em uma interface gráfica do usuário. Este artigo fornece uma visão geral das propriedades que você pode definir para projetos de banco de dados SQL.

As propriedades de projetos SQL comumente usadas incluem:

• Plataforma de destino (DSP)
• Análise de código
• DacApplicationName e DacVersion
• Esquema padrão
• TreatTSqlWarningsAsErrors

Desabilitar alterações de opções de banco de dados

Durante a publicação do projeto SQL, as alterações nas opções de banco de dados são roteadas com base nos valores definidos nas propriedades do projeto e nos valores padrão do projeto. Para impedir que as opções de banco de dados sejam modificadas durante a publicação, usando uma ferramenta como a CLI do SqlPackage ou o Visual Studio, defina a propriedade de publicação como ScriptDatabaseOptions false. Essa configuração também pode ser incorporada em um perfil de publicação.

Propriedades comuns do projeto

A propriedade de plataforma de destino especifica a versão do SQL Server direcionada ao projeto. A DSP propriedade é usada para definir a plataforma de destino para o projeto SQL. Mais informações sobre a plataforma de destino podem ser encontradas no artigo da plataforma de destino .

A análise de código pode melhorar drasticamente o processo contínuo de integração e implantação capturando possíveis problemas no início do ciclo de vida de desenvolvimento. Saiba mais sobre como habilitar a análise de código e incluir regras personalizadas no artigo de análise de código SQL .

Propriedades de aplicativo da camada de dados

As propriedades a seguir são usadas para definir o DAC (aplicativo de camada de dados) que é criado quando o projeto SQL é criado.

• DacApplicationName: o nome do aplicativo .dacpacda camada de dados. O valor padrão é o nome do projeto.
• DacDescription: uma descrição opcional do aplicativo .dacpacda camada de dados.
• DacVersion: a versão do aplicativo de nível de dados .dacpac. O valor padrão é 1.0.0.0.

Esquema padrão

A DefaultSchema propriedade define o esquema padrão para o projeto SQL. Essa propriedade se aplica a objetos nomeados de uma parte. O valor padrão é dbo.

Avisos do T-SQL

As propriedades SuppressTSqlWarnings e TreatTSqlWarningsAsErrors controlam como os avisos T-SQL são tratados durante a compilação do projeto. A SuppressTSqlWarnings propriedade suprime avisos T-SQL durante o build do projeto, especificados como uma lista separada por vírgulas de números de erro.

A TreatTSqlWarningsAsErrors propriedade trata os avisos T-SQL como erros, resultando em falhas na compilação caso ocorram avisos T-SQL. O valor padrão para TreatTSqlWarningsAsErrors é False.

Exemplo de uso de propriedades do projeto

O exemplo a seguir mostra como definir as propriedades CompatibilityMode, IsChangeTrackingOn, e TreatTSqlWarningsAsErrors em um arquivo de projeto SQL. A propriedade CompatibilityMode é definida como 130, a propriedade IsChangeTrackingOn é definida como True, e a propriedade TreatTSqlWarningsAsErrors é definida como True. A propriedade TreatSqlWarningsAsErrors é definida apenas como True na configuração de build Release.

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build">
  <Sdk Name="Microsoft.Build.Sql" Version="1.0.0-rc1" />
  <PropertyGroup>
    <Name>AdventureWorks</Name>
    <DSP>Microsoft.Data.Tools.Schema.Sql.Sql160DatabaseSchemaProvider</DSP>
    <ModelCollation>1033, CI</ModelCollation>
    <ProjectGuid>{00000000-0000-0000-0000-000000000000}</ProjectGuid>
    <RunSqlCodeAnalysis>true</RunSqlCodeAnalysis>
    <CompatibilityMode>130</CompatibilityMode>
    <IsChangeTrackingOn>True</IsChangeTrackingOn>
  </PropertyGroup>
  <PropertyGroup Condition="'$(Configuration)'=='Release'">
    <TreatTSqlWarningsAsErrors>True</TreatTSqlWarningsAsErrors>
  </PropertyGroup>
</Project>

Todas as propriedades do projeto

Algumas propriedades de projeto são associadas a opções de banco de dados que se aplicam apenas a bancos de dados do SQL Server ou versões específicas do SQL Server. Antes de incluir uma propriedade de projeto em seu projeto, examine a documentação associada da opção de banco de dados para entender o comportamento dos requisitos de propriedade e banco de dados.

1. O valor padrão difere com base na versão do mecanismo e nas configurações do servidor.
2. Opções de configuração no escopo do banco de dados.
3. AUTO é definido com o valor 0.
4. Aplica-se apenas como uma CREATE DATABASEopção .

Conteúdo relacionado

• Visão geral da plataforma de destino
• Análise de código SQL para melhorar a qualidade do código
• Ferramentas de projetos SQL
• Opções de ALTER DATABASE SET (Transact-SQL)