Egenskaper för SQL-projekt

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Förhandsversion av Microsoft Fabric

Förutom innehållet i enskilda .sql filer innehåller SQL-databasprojekt egenskaper som definierar projektets beteende och inställningar på databasnivå. Dessa egenskaper lagras i filen .sqlproj och kan anges genom att redigera .sqlproj-filen direkt. Vissa SQL-projektverktyg, till exempel Visual Studio och VS Code, ger åtkomst till att redigera några eller många av projektegenskaperna i ett grafiskt användargränssnitt. Den här artikeln innehåller en översikt över de egenskaper som du kan ange för SQL-databasprojekt.

Exempel på vanliga SQL-projektegenskaper är:

• Målplattform (DSP)
• Code analysis
• DacApplicationName och DacVersion
• Default schema
• TreatTSqlWarningsAsErrors

Inaktivera ändringar av databasalternativ

Under SQL-projektpublicering skriptas ändringar av databasalternativen baserat på de värden som definierats i projektegenskaperna och standardvärdena för projektet. Om du vill förhindra att databasalternativen ändras under publiceringen med hjälp av ett verktyg som SqlPackage CLI- eller Visual Studio anger du publiceringsegenskapen till ScriptDatabaseOptions till false. Den här inställningen kan också införlivas i en publiceringsprofil.

Vanliga projektegenskaper

Egenskapen målplattform anger vilken version av SQL Server som projektet riktar sig mot. Egenskapen DSP används för att ange målplattformen för SQL-projektet. Mer information om målplattformen finns i artikeln målplattform.

Kodanalys kan avsevärt förbättra processen för kontinuerlig integrering och distribution genom att fånga upp potentiella problem tidigt i utvecklingslivscykeln. Läs mer om att aktivera kodanalys och inkludera anpassade regler i artikeln SQL-kodanalys.

Egenskaper för dataskiktsapplikation

Följande egenskaper används för att definiera det datanivåprogram (DAC) som skapas när SQL-projektet skapas.

• DacApplicationName: Namnet på datanivåprogrammet .dacpac. Standardvärdet är projektnamnet.
• DacDescription: En valfri beskrivning av datanivåprogrammet .dacpac.
• DacVersion: Versionen av datanivåprogrammet .dacpac. Standardvärdet är 1.0.0.0.

Default schema

Egenskapen DefaultSchema anger standardschemat för SQL-projektet. Den här egenskapen gäller för en-del namngivna objekt. Standardvärdet är dbo.

T-SQL warnings

Egenskaperna SuppressTSqlWarnings och TreatTSqlWarningsAsErrors styr hur T-SQL-varningar hanteras under projektversionen. Egenskapen SuppressTSqlWarnings undertrycker T-SQL-varningar under projektversionen, som anges som en kommaavgränsad lista med felnummer.

Egenskapen TreatTSqlWarningsAsErrors behandlar T-SQL-varningar som fel, vilket gör att eventuella T-SQL-varningar misslyckas med bygget. Standardvärdet för TreatTSqlWarningsAsErrors är False.

Exempel på användning av projektegenskaper

I följande exempel visas hur du anger egenskaperna CompatibilityMode, IsChangeTrackingOnoch TreatTSqlWarningsAsErrors i en SQL-projektfil. Egenskapen CompatibilityMode är inställd på 130, egenskapen IsChangeTrackingOn är inställd på Trueoch egenskapen TreatTSqlWarningsAsErrors är inställd på True. Egenskapen TreatSqlWarningsAsErrors är bara inställd på True i konfigurationen för Release build.

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

Alla projektegenskaper

Vissa projektegenskaper är associerade med databasalternativ som endast gäller för SQL Server-databaser eller specifika versioner av SQL Server. Innan du inkluderar en projektegenskap i projektet läser du den associerade dokumentationen för databasalternativet för att förstå beteendet för egenskapen och databaskraven.

1. Standardvärdet skiljer sig beroende på motorversion och serverinställningar.
2. databasspecifik konfigurationsalternativ
3. AUTO anges med värdet 0.
4. Gäller endast som ett CREATE DATABASEalternativ.

Related content

• översikt över Target-plattformen
• SQL-kodanalys för att förbättra kodkvaliteten
• SQL-projektverktyg
• ALTER DATABASE SET-alternativ (Transact-SQL)