SQL 项目属性

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Microsoft Fabric 中的 SQL 数据库

除了单个 .sql 文件的内容外，SQL 数据库项目还包含用于定义项目行为和数据库级设置的属性。 这些属性存储在 .sqlproj 文件中，可以通过直接编辑 .sqlproj 文件来设置。 某些 SQL 项目工具（如 Visual Studio 和 VS Code）提供在图形用户界面中编辑几个或许多项目属性的访问权限。 本文概述了可以为 SQL 数据库项目设置的属性。

常用的 SQL 项目属性包括：

• 目标平台 （DSP）
• 代码分析
• DacApplicationName 和 DacVersion
• 默认架构
• TreatTSqlWarningsAsErrors

禁用数据库选项更改

在 SQL 项目发布期间，数据库选项的更改会根据项目属性和默认项目值中定义的值编写脚本。 若要防止在发布期间修改数据库选项，请使用 SqlPackage CLI 或 Visual Studio 等工具将发布属性设置为 ScriptDatabaseOptions false。 此设置也可以合并到发布配置文件中。

常见项目属性

目标平台属性指定项目面向的 SQL Server 版本。 该 DSP 属性用于设置 SQL 项目的目标平台。 有关目标平台的详细信息，请参阅 目标平台 文章。

代码分析可以通过在开发生命周期早期捕获潜在问题来显著改善持续集成和部署过程。 详细了解如何启用代码分析并在 SQL 代码分析 文章中包含自定义规则。

数据层应用程序属性

以下属性用于定义在生成 SQL 项目时创建的数据层应用程序（DAC）。

• DacApplicationName：数据层应用程序 .dacpac的名称。 默认值为项目名称。
• DacDescription：数据层应用程序的 .dacpac可选说明。
• DacVersion：数据层应用程序的 .dacpac版本。 默认值是 1.0.0.0。

默认架构

该 DefaultSchema 属性设置 SQL 项目的默认架构。 此属性适用于单部件命名对象。 默认值是 dbo。

T-SQL 警告

SuppressTSqlWarnings和TreatTSqlWarningsAsErrors属性控制在项目生成期间如何处理 T-SQL 警告。 该 SuppressTSqlWarnings 属性在项目生成期间禁止显示 T-SQL 警告，该警告指定为逗号分隔的错误号列表。

TreatTSqlWarningsAsErrors 属性将 T-SQL 警告视为错误，从而导致任何 T-SQL 警告都会使生成失败。 TreatTSqlWarningsAsErrors 的默认值为 False。

项目属性的示例用法

以下示例演示如何在 SQL 项目文件中设置CompatibilityMode和IsChangeTrackingOnTreatTSqlWarningsAsErrors属性。 属性CompatibilityMode设置为130，属性IsChangeTrackingOn设置为True，并且属性TreatTSqlWarningsAsErrors设置为True。 在 Release 生成配置中，TreatSqlWarningsAsErrors 属性仅设置为 True。

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

所有项目属性

某些项目属性与仅适用于 SQL Server 数据库或特定版本的 SQL Server 的数据库选项相关联。 在项目中包括项目属性之前，请查看数据库选项的相关文档，以了解属性和数据库要求的行为。

1. 默认值因引擎版本和服务器设置而异。
2. 数据库范围的配置 选项。
3. AUTO 设置为 0 值。
4. 仅作为CREATE DATABASE选项应用。

相关内容

• 目标平台概述
• 用于提高代码质量的 SQL 代码分析
• SQL 项目工具
• ALTER DATABASE SET 选项 (Transact SQL)