Vlastnosti projektů SQL
platí pro:SQL Server
Azure SQL Database
Azure SQL Managed Instance
SQL database v Microsoft Fabric
Kromě obsahu jednotlivých souborů .sql
obsahují databázové projekty SQL vlastnosti, které definují chování projektu a nastavení na úrovni databáze. Tyto vlastnosti jsou uloženy v souboru .sqlproj
a lze je nastavit úpravou .sqlproj
souboru přímo. Některé nástroje projektů SQL, například Visual Studio a VS Code, poskytují přístup k úpravám několika nebo mnoha vlastností projektu v grafickém uživatelském rozhraní. Tento článek obsahuje přehled vlastností, které můžete nastavit pro projekty databáze SQL.
Mezi běžně používané vlastnosti projektů SQL patří:
- cílová platforma (DSP)
- analýza kódu
- DacApplicationName a DacVersion
- výchozí schéma
- TreatTSqlWarningsAsErrors
Zakázání změn možností databáze
Během publikování projektu SQL se změny možností databáze skriptují na základě hodnot definovaných ve vlastnostech projektu a výchozích hodnotách projektu. Pokud chcete zabránit úpravám možností databáze během publikování, použijte nástroj, jako je rozhraní příkazového řádku SqlPackage nebo Visual Studio, nastavte vlastnost publikování na ScriptDatabaseOptions
na false. Toto nastavení lze také začlenit do profilu publikování.
Společné vlastnosti projektu
Vlastnost cílové platformy určuje verzi SQL Serveru, na kterou projekt cílí. Vlastnost DSP
slouží k nastavení cílové platformy pro projekt SQL. Další informace o cílové platformě najdete v článku cílové platformě.
Analýza kódu může výrazně zlepšit proces kontinuální integrace a nasazování zachycením potenciálních problémů v rané fázi životního cyklu vývoje. Přečtěte si další informace o povolení analýzy kódu a zahrnutí vlastních pravidel v článku analýze kódu SQL.
Vlastnosti aplikace datové úrovně
Následující vlastnosti slouží k definování aplikace datové vrstvy (DAC), která se vytvoří při sestavení projektu SQL.
-
DacApplicationName: Název aplikace datové vrstvy
.dacpac
. Výchozí hodnota je název projektu. -
DacDescription: Volitelný popis aplikace datové vrstvy
.dacpac
. -
DacVersion: Verze datové vrstvy aplikace
.dacpac
. Výchozí hodnota je1.0.0.0
.
Výchozí schéma
Vlastnost DefaultSchema
nastaví výchozí schéma pro projekt SQL. Tato vlastnost se vztahuje na 1-dílné pojmenované objekty. Výchozí hodnota je dbo
.
Upozornění T-SQL
Vlastnosti SuppressTSqlWarnings
a TreatTSqlWarningsAsErrors
řídí způsob zpracování upozornění T-SQL během sestavování projektu. Vlastnost SuppressTSqlWarnings
potlačí upozornění T-SQL během sestavení projektu, která jsou určena jako seznam chyb oddělených čárkami.
Vlastnost TreatTSqlWarningsAsErrors
zpracovává upozornění T-SQL jako chyby, což způsobuje selhání sestavení při upozorněních T-SQL. Výchozí hodnota pro TreatTSqlWarningsAsErrors
je False
.
Příklad použití vlastností projektu
Následující příklad ukazuje, jak nastavit vlastnosti CompatibilityMode
, IsChangeTrackingOn
a TreatTSqlWarningsAsErrors
v souboru projektu SQL. Vlastnost CompatibilityMode
je nastavena na 130
, vlastnost IsChangeTrackingOn
je nastavena na True
a vlastnost TreatTSqlWarningsAsErrors
je nastavena na True
. Vlastnost TreatSqlWarningsAsErrors
je nastavená pouze na True
v konfiguraci sestavení 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>
Všechny vlastnosti projektu
Některé vlastnosti projektu jsou přidruženy k možnostem databáze, které platí pouze pro databáze SQL Serveru nebo konkrétní verze SQL Serveru. Než do projektu zahrnete vlastnost projektu, projděte si přidruženou dokumentaci pro možnost databáze a seznamte se s chováním vlastností a požadavků na databázi.
Vlastnost | možnost DATABASE SET |
Popisek uživatelského rozhraní | Výchozí hodnota projektu SQL | Povolené hodnoty |
---|---|---|---|---|
AllowSnapshotIsolation | ALLOW_SNAPSHOT_ISOLATION |
Nastavení databáze, Provozní, Povolit izolaci snímků | Falešný | {Pravda|Nepravda} |
AnsiNulls | ANSI_NULLS |
Nastavení databáze, SET ANSI_NULLS | Pravda | {Pravda|Nepravda} |
AnsiPadding | ANSI_PADDING |
Nastavení databáze, SET ANSI_PADDING | Pravda | {Pravda|Nepravda} |
AnsiWarnings | ANSI_WARNINGS |
Nastavení databáze, SET ANSI_WARNINGS | Pravda | {Pravda|Nepravda} |
ArithAbort | ARITHABORT |
Nastavení databáze, SET ARITHABORT | Pravda | {Pravda|Nepravda} |
Automatické zavření | AUTO_CLOSE |
Nastavení databáze, Provozní, Automatické zavření | Falešný | {Pravda|Nepravda} |
Automatické vytváření statistik | AUTO_CREATE_STATISTICS |
Nastavení databáze, Provozní, Automatické vytváření statistik | Pravda | {Pravda|Nepravda} |
AutoShrink | AUTO_SHRINK |
Nastavení databáze, Provozní, Automatické zmenšení | Falešný | {Pravda|Nepravda} |
AutoUpdateStatistics | AUTO_UPDATE_STATISTICS |
Nastavení databáze, Provozní, Statistika automatické aktualizace | Pravda | {Pravda|Nepravda} |
AutomatickáAktualizaceStatistikAsynchronně | AUTO_UPDATE_STATISTICS_ASYNC |
Nastavení databáze, Provozní, Automatické aktualizace statistiky asynchronně | Falešný | {Pravda|Nepravda} |
Doba uchovávání sledování změn | CHANGE_RETENTION |
Nastavení databáze, Provozní nastavení, Doba uchovávání změn sledování | 2 | {integer} |
JednotkaUchováváníSledováníZměn | CHANGE_RETENTION |
Nastavení databáze, Provozní, Doba uchovávání sledování změn | Zápis | {DNY|HODINY|MINUTY} |
ZavřeníKurzorPřiPotvrzeníPovoleno | CURSOR_CLOSE_ON_COMMIT |
Nastavení databáze, Provozní, Zavření kurzoru při potvrzení je povoleno | Falešný | {Pravda|Nepravda} |
Režim kompatibility | COMPATIBILITY_LEVEL |
Nastavení databáze, úroveň kompatibility | {100|110|120|130|140|150|160|170}1 | |
ConcatNullYieldsNull | CONCAT_NULL_YIELDS_NULL |
Nastavení databáze, SET CONCAT_NULL_YIELDS_NULL | Pravda | {Pravda|Nepravda} |
Omezení | CONTAINMENT |
Nastavení databáze, omezení | ŽÁDNÝ | {NONE|PARTIAL} |
DacAplikaceName | Vlastnosti aplikace datové vrstvy (.dacpac ) a název |
Název projektu | {string} | |
DacDescription | Vlastnosti aplikace datové vrstvy (.dacpac ) a popis |
{string} | ||
DacVersion | Vlastnosti aplikace datové vrstvy (.dacpac ), verze |
1.0.0.0 | {sémantické číslo verze} | |
DatabaseAccess | db_user_access_option |
Nastavení databáze, přístup k databázi | VÍCEUŽIVATELSKÝ | {VÍCE UŽIVATELŮ|JEDEN UŽIVATEL|OMEZENÝ UŽIVATEL} |
Propojování databází | DB_CHAINING |
Nastavení databáze, řetězení databází | Falešný | {Pravda|Nepravda} |
Výchozí jazyk pro fulltextovou databázi | DEFAULT_FULLTEXT_LANGUAGE |
Nastavení databáze, výchozí jazyk fulltextu | 1033 | {celé číslo ID jazyka} |
Výchozí jazyk databáze | DEFAULT_LANGUAGE |
Nastavení databáze, výchozí jazyk | 1033 | {celé číslo ID jazyka} |
DatabaseState | db_state_option |
Nastavení databáze, stav databáze | ONLINE | {ONLINE|OFFLINE} |
DbScopedConfigOdhadKardinalityDědictví |
LEGACY_CARDINALITY_ESTIMATION
2 |
Konfigurace s vymezeným oborem databáze, odhad kardinality ve starším režimu | Vypnuto | {Vypnuto|Zapnuto} |
DbScopedConfigLegacyCardinalitySecondaryEstimation |
LEGACY_CARDINALITY_SECONDARY_ESTIMATION
2 |
Konfigurace s vymezeným oborem databáze, historický odhad kardinality pro sekundární fázi/sekundární indexy | Primární | {Primární|Vypnuto|Zapnuto} |
DbScopedConfigParameterSniffing |
PARAMETER_SNIFFING
2 |
Konfigurace s vymezeným oborem databáze, šifrování parametrů | Na | {Zapnuto|Vypnuto} |
ParametrKonfiguraceDB-DetekceSekundární |
PARAMETER_SNIFFING_SECONDARY
2 |
Konfigurace s vymezeným oborem databáze, zjišťování parametrů pro sekundární | Primární | {Primární|Vypnuto|Zapnuto} |
DbScopedConfigOptimizerOpravyHotfixů |
OPTIMIZER_HOTFIXES
2 |
Konfigurace s vymezeným oborem databáze, opravy hotfix optimalizátoru dotazů | Vypnuto | {Vypnuto|Zapnuto} |
DbScopedConfigOptimizerHotfixesSekundární |
OPTIMIZER_HOTFIXES_SECONDARY
2 |
Konfigurace s vymezeným oborem databáze, opravy hotfix pro optimalizátor dotazů pro sekundární | Primární | {Primární|Vypnuto|Zapnuto} |
DbScopedConfigMaxDOP |
MAXDOP
2 |
Konfigurace v rozsahu databáze, maximální stupně paralelismu | 0 | {integer} |
DbScopedConfigMaxDOPSecondary |
MAXDOP_SECONDARY
2 |
Konfigurace s oborem databáze, maximální počet stupňů paralelismu pro sekundární úlohy | {integer} | |
DbScopedConfigDWCompatibilityLevel |
DW_COMPATIBILITY_LEVEL
2 |
Konfigurace s vymezeným oborem databáze, úroveň kompatibility DW | 0 | {0|10|20|30|40|50|9000}3 |
DefaultCollation |
COLLATE
4 |
Nastavení databáze, kolace databáze | SQL_Latin1_General_CP1_CI_AS | Pro platné hodnoty viz název kolace SQL Serveru. |
DefaultCursor | CURSOR_DEFAULT |
Nastavení databáze, Provozní, Výchozí kurzor | Místní | {Global|Místní} |
Výchozí skupina souborů | Nastavení databáze, Provozní, Výchozí skupina souborů | PRIMÁRNÍ | {string} | |
DefaultFileStreamFilegroup | Nastavení databáze, Provozní, Výchozí souborová skupina pro filestream | {string} | ||
výchozí schéma | Obecné nastavení projektu, výchozí schéma | dbo | {string} | |
Zpožděná odolnost | DELAYED_DURABILITY |
Nastavení databáze, Provozní, Zpožděná trvanlivost transakcí | INVALIDNÍ | {ZAKÁZÁNO|POVOLENO|VYNUCENO} |
Digitální zpracování signálu | Cílová platforma pro projekt SQL | Podívejte se na cílovou platformu pro platné hodnoty. | ||
PovolitCelotextovéVyhledávání | Nastavení databáze, povolení fulltextové vyhledávání | Pravda | {Pravda|Nepravda} | |
FileStreamDirectoryName |
FILESTREAM (DIRECTORY_NAME ) |
Nastavení databáze, název adresáře FILESTREAM | {string} | |
IsBrokerPriorityHonored | HONOR_BROKER_PRIORITY |
Nastavení databáze, priorita zprostředkovatele byla dodržena. | Falešný | {Pravda|Nepravda} |
IsChangeTrackingAutoCleanupOn (or Je automatické vyčištění sledování změn zapnuto?) | CHANGE_TRACKING |
Nastavení databáze, Provozní, Automatické vyčištění sledování změn | Pravda | {Pravda|Nepravda} |
JeSledováníZměnZapnuto | CHANGE_TRACKING |
Nastavení databáze, Provozní, Sledování změn | Falešný | {Pravda|Nepravda} |
JeŠifrováníZapnuto | ENCRYPTION |
Nastavení databáze, povolené šifrování | Falešný | {Pravda|Nepravda} |
IsLedgerOn |
LEDGER
4 |
Nastavení databáze, povolení registru | Falešný | {Pravda|Nepravda} |
IsNestedTriggersOn | NESTED_TRIGGERS |
Nastavení databáze, povolené vnořené triggery | Pravda | {Pravda|Nepravda} |
IsTransformNoiseWordsOn | TRANSFORM_NOISE_WORDS |
Nastavení databáze, transformace šumových slov | Falešný | {Pravda|Nepravda} |
MemoryOptimizedElevateToSnapshot | MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT |
Nastavení databáze, provozní, optimalizovaná paměť, povýšení na snímek | Falešný | {Pravda|Nepravda} |
ModelCollation | Nastavení projektu, úprava řazení | 1033,CI | {celé číslo ID jazyka}, {CI|CS} | |
Přístup k nesprávovanému proudovému souboru | NON_TRANSACTED_ACCESS |
Nastavení databáze, přístup FILESTREAM bez transakce | VYPNUTO | {VYPNUTO|POUZE_KE_ČTENÍ|ÚPLNÝ} |
NumericRoundAbort | NUMERIC_ROUNDABORT |
Nastavení databáze, parametr SET NUMERIC_ROUNDABORT | Falešný | {Pravda|Nepravda} |
Výstupní cesta | Nastavení sestavení, výstupní cesta |
bin\Debug a bin\Release |
{string} | |
OvěřeníStránky | PAGE_VERIFY |
Nastavení databáze, Provozní, Ověření stránky | ŽÁDNÝ | {NONE|TORN_PAGE_DETECTION|CHECKSUM} |
Parametrizace | PARAMETERIZATION |
Nastavení databáze, parametrizace | JEDNODUCHÝ | {JEDNODUCHÉ|VNUCENÉ} |
Režim zachycení QueryStore |
QUERY_STORE (QUERY_CAPTURE_MODE ) |
Nastavení databáze, Provozní režim, Režim zachytávání úložiště dotazů | VŠICHNI | {VYPNUTO|VŠE|AUTO} |
DotazStorePožadovanýStav |
QUERY_STORE (OPERATION_MODE ) |
Nastavení databáze, Provozní režim, Režim operace úložiště dotazů | VYPNUTO | {VYPNUTO|ČTENÍ/ZÁPIS|POUZE ČTENÍ} |
QueryStoreFlushInterval |
QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS ) |
Nastavení databáze, Provozní nastavení, Interval vyprázdnění dat úložiště dotazů (sekundy) | 900 | {integer} |
Délka intervalu dotazovacího úložiště |
QUERY_STORE (INTERVAL_LENGTH_MINUTES ) |
Nastavení databáze, Provozní, Délka intervalu úložiště dotazů (minuty) | 60 | {integer} |
QueryStoreMaxPlansPerQuery |
QUERY_STORE (MAX_PLANS_PER_QUERY ) |
Nastavení databáze, Provozní, Úložiště dotazů – maximální počet plánů na jeden dotaz | 200 | {integer} |
QueryStoreMaxStorageSize |
QUERY_STORE (MAX_STORAGE_SIZE_MB ) |
Nastavení databáze, Provozní, Úložiště dotazů – maximální velikost úložiště (MB) | 100 | {integer} |
QueryStoreStaleQueryThreshold |
QUERY_STORE (STALE_QUERY_THRESHOLD_DAYS ) |
Nastavení databáze, Provozní, Úložiště dotazů – prahová hodnota zastaralého dotazu (dny) | 367 | {integer} |
QuotedIdentifier | QUOTED_IDENTIFIER |
Nastavení databáze, SET QUOTED_IDENTIFIER | Pravda | {Pravda|Nepravda} |
ReadCommittedSnapshot | READ_COMMITTED_SNAPSHOT |
Nastavení databáze, operační, čtení potvrzeného snímku | Falešný | {Pravda|Nepravda} |
Zotavení | RECOVERY |
Nastavení databáze, provozní, obnovení | PLNÝ | {FULL|SIMPLE|BULK_LOGGED} |
RekurzivníAktivovánoSpouštěče | RECURSIVE_TRIGGERS |
Nastavení databáze, povolené rekurzivní triggery | Falešný | {Pravda|Nepravda} |
ServiceBrokerOption | SERVICE_BROKER |
Nastavení databáze, možnosti služby Service Broker | DisableBroker | {ZakázatZprostředkovatele|PovolteZprostředkovatele|NovýZprostředkovatel|ChybaKonverzaceZprostředkovatele} |
SuppressTSqlWarnings | Nastavení sestavení, potlačení upozornění T-SQL (seznam kódů upozornění T-SQL oddělený čárkami) | {string} | ||
Cílová doba obnovy | Nastavení databáze, provozní, cílový čas obnovení (sekundy) | Určuje frekvenci nepřímých kontrolních bodů pro jednotlivé databáze. | 60 | {integer} |
TargetRecoveryTimeUnit | Nastavení databáze, provozní nastavení, cílový čas záznamu | SEKUNDY | {MINUTES|SECONDS} | |
ZacházejteSVarovánímiTSqlJakoSChybami | Nastavení sestavení, zpracování upozornění T-SQL jako chyb | Falešný | {Pravda|Nepravda} | |
Důvěryhodný | TRUSTWORTHY |
Nastavení databáze, důvěryhodnost | Falešný | {Pravda|Nepravda} |
HraničníHodnotaProDvouCifernýRok | TWO_DIGIT_YEAR_CUTOFF |
Nastavení databáze, hranice pro dvoumístné roky | 2049 | {integer} |
Možnosti aktualizace | db_update_option |
Nastavení databáze, možnosti aktualizace | čtení/zápis | {Čtení a zápis|Jen pro čtení} |
ValidateCasingOnIdentifiers | Obecné nastavení projektu, ověřit správnost velikosti písmen identifikátorů | Pravda | {Pravda|Nepravda} |
- Výchozí hodnota se liší v závislosti na edici modulu a nastavení serveru.
- Konfigurační možnosti s vymezeným oborem databáze.
- Funkce AUTO je nastavena s hodnotou 0.
- Platí pouze jako možnost
CREATE DATABASE
.