Eigenschappen van SQL-projecten

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Naast de inhoud van de afzonderlijke .sql bestanden bevatten SQL-databaseprojecten eigenschappen waarmee het gedrag en de instellingen op databaseniveau van het project worden gedefinieerd. In het .sqlproj bestand worden deze eigenschappen opgeslagen. U kunt deze eigenschappen instellen door het .sqlproj bestand rechtstreeks te bewerken. Sommige hulpprogramma's voor SQL-projecten, zoals Visual Studio en VS Code, bieden toegang tot het bewerken van enkele of veel van de projecteigenschappen in een grafische gebruikersinterface. Dit artikel bevat een overzicht van de eigenschappen die u kunt instellen voor SQL-databaseprojecten.

Veelgebruikte eigenschappen van SQL-projecten zijn onder andere:

• Doelplatform (DSP)
• Codeanalyse
• DacApplicationName en DacVersion
• Standaardschema
• TreatTSqlWarningsAsErrors
• Sdk-updatewaarschuwingen

Wijzigingen in databaseopties uitschakelen

Tijdens het publiceren van SQL-projecten worden de processcripts gewijzigd in de databaseopties op basis van de waarden die zijn gedefinieerd in de projecteigenschappen en standaardprojectwaarden. Als u wilt voorkomen dat de databaseopties tijdens het publiceren worden gewijzigd, stelt u de ScriptDatabaseOptions publicatie-eigenschap false in op met behulp van een hulpprogramma zoals SqlPackage CLI of Visual Studio. U kunt deze instelling ook opnemen in een publicatieprofiel.

Algemene projecteigenschappen

Met de eigenschap doelplatform geeft u de versie van SQL Server op waarop het project is gericht. Gebruik de DSP eigenschap om het doelplatform voor het SQL-project in te stellen. Zie het artikel over het doelplatform voor meer informatie.

Codeanalyse kan het continue integratie- en implementatieproces aanzienlijk verbeteren door potentiële problemen vroeg in de ontwikkelingslevenscyclus te ondervangen. Zie het artikel over SQL-codeanalyse voor meer informatie over het inschakelen van codeanalyse en het opnemen van aangepaste regels.

Toepassingseigenschappen voor gegevenslagen

Gebruik de volgende eigenschappen om de gegevenslaagtoepassing (DAC) te definiëren die u maakt wanneer u het SQL-project bouwt.

• DacApplicationName: de naam van de toepassing voor de gegevenslaag .dacpac. De standaardwaarde is de projectnaam.
• DacDescription: een optionele beschrijving van de toepassing .dacpacvoor de gegevenslaag.
• DacVersion-: de versie van de gegevenslaagtoepassing .dacpac. De standaardwaarde is 1.0.0.0.

Standaardschema

De eigenschap DefaultSchema stelt het standaardschema voor het SQL-project in. Deze eigenschap is van toepassing op objecten met eendelige namen. De standaardwaarde is dbo.

T-SQL-waarschuwingen

De eigenschappen SuppressTSqlWarnings en TreatTSqlWarningsAsErrors bepalen hoe T-SQL-waarschuwingen worden verwerkt tijdens de projectbuild. De eigenschap SuppressTSqlWarnings onderdrukt T-SQL-waarschuwingen tijdens de projectbuild, die is opgegeven als een door komma's gescheiden lijst met foutnummers.

De eigenschap TreatTSqlWarningsAsErrors behandelt T-SQL-waarschuwingen als fouten, waardoor T-SQL-waarschuwingen mislukken in de build. De standaardwaarde voor TreatTSqlWarningsAsErrors is False.

Sdk-updatewaarschuwingen

De Microsoft. Build.Sql project SDK controleert automatisch op nieuwe versies van de SDK tijdens het bouwen van het project en geeft een waarschuwing weer als er een nieuwere versie beschikbaar is. Het up-to-date houden van projecten met de nieuwste SDK zorgt ervoor dat u toegang hebt tot de nieuwste functies en verbeteringen, waaronder oplossingen voor fouten en toevoegingen van syntaxis. Als u dit gedrag wilt uitschakelen, stelt u de SkipCheckForNewSDKVersion eigenschap in op true.

Voorbeeld van het gebruik van projecteigenschappen

In het volgende voorbeeld ziet u hoe u de eigenschappen CompatibilityMode, IsChangeTrackingOnen TreatTSqlWarningsAsErrors instelt in een SQL-projectbestand. De eigenschap CompatibilityMode is ingesteld op 130, de eigenschap IsChangeTrackingOn is ingesteld op Trueen de eigenschap TreatTSqlWarningsAsErrors is ingesteld op True. De eigenschap TreatSqlWarningsAsErrors is alleen ingesteld op True in de Release-buildconfiguratie.

<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build">
  <Sdk Name="Microsoft.Build.Sql" Version="2.2.0" />
  <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>

Alle projecteigenschappen

Sommige projecteigenschappen zijn gekoppeld aan databaseopties die alleen van toepassing zijn op SQL Server-databases of specifieke versies van SQL Server. Voordat u een projecteigenschap in uw project op neemt, raadpleegt u de bijbehorende documentatie voor de databaseoptie om inzicht te hebben in het gedrag van de eigenschappen- en databasevereisten.

1. De standaardwaarde verschilt op basis van engine-editie- en serverinstellingen.
2. configuratie van databasebereik opties.
3. AUTO wordt ingesteld met de 0-waarde.
4. Is alleen van toepassing als CREATE DATABASEoptie.
5. Niet van toepassing op Azure SQL Database, waarbij de optie altijd is ingeschakeld.

Verwante inhoud

• Overzicht van doelplatform
• SQL-codeanalyse om de kwaliteit van code te verbeteren
• hulpprogramma's voor SQL-projecten
• ALTER DATABASE SET opties (Transact-SQL)