SQL-projektek tulajdonságai

A következőkre vonatkozik:SQL Server Azure SQL Database Felügyelt Azure SQL-példány SQL-adatbázis a Microsoft Fabricben

Az egyes .sql fájlok tartalma mellett az SQL-adatbázisprojektek olyan tulajdonságokat is tartalmaznak, amelyek meghatározzák a projekt viselkedését és adatbázisszintű beállításait. Ezek a tulajdonságok a .sqlproj fájlban vannak tárolva, és közvetlenül a .sqlproj fájl szerkesztésével állíthatók be. Egyes SQL-projektek eszközei, például a Visual Studio és a VS Code hozzáférést biztosítanak néhány vagy több projekttulajdonság szerkesztéséhez grafikus felhasználói felületen. Ez a cikk áttekintést nyújt az SQL Database-projektekhez beállítható tulajdonságokról.

Az SQL-projektek gyakran használt tulajdonságai a következők:

Célplatform (DSP)
Kódelemzés
DacApplicationName és DacVersion
Alapértelmezett séma
TreatTSqlWarningsAsErrors

Adatbázis-beállítások módosításainak letiltása

Az SQL-projekt közzététele során az adatbázis beállításainak módosítása a projekt tulajdonságaiban és az alapértelmezett projektértékekben meghatározott értékek alapján lesz szkriptelve. Ha meg szeretné akadályozni, hogy az adatbázis beállításai módosuljanak a közzététel során, egy olyan eszközzel, mint az SqlPackage CLI vagy a Visual Studio, állítsa a közzétételi tulajdonságot hamisra ScriptDatabaseOptions. Ez a beállítás egy közzétételi profilba is beépíthető.

Gyakori projekttulajdonságok

A célplatform tulajdonság határozza meg az SQL Server azon verzióját, amelyet a projekt megcélzott. A DSP tulajdonság az SQL-projekt célplatformjának beállítására szolgál. A célplatformról további információt a célplatform cikkben talál.

A kódelemzés jelentősen javíthatja a folyamatos integrációs és üzembehelyezési folyamatot azáltal, hogy a fejlesztési életciklus korai szakaszában észleli a lehetséges problémákat. Tudjon meg többet a kódelemzés engedélyezéséről és az egyéni szabályok beillesztéséről az SQL kódelemzési című cikkben.

Adatrétegbeli alkalmazástulajdonságok

A következő tulajdonságok határozzák meg az SQL-projekt létrehozásakor létrehozott adatréteg-alkalmazást (DAC).

DacApplicationName: Az adatréteg-alkalmazás neve .dacpac. Az alapértelmezett érték a projekt neve.
DacDescription: Az adatréteg-alkalmazás .dacpacopcionális leírása.
DacVersion: Az adatrétegű alkalmazás verziója .dacpac. Az alapértelmezett érték a 1.0.0.0.

Alapértelmezett séma

A DefaultSchema tulajdonság beállítja az SQL-projekt alapértelmezett sémáját. Ez a tulajdonság egyrészes, elnevezett objektumokra vonatkozik. Az alapértelmezett érték a dbo.

T-SQL-figyelmeztetések

A SuppressTSqlWarnings és TreatTSqlWarningsAsErrors tulajdonságok szabályozzák a T-SQL-figyelmeztetések kezelését a projekt összeállítása során. A SuppressTSqlWarnings tulajdonság letiltja a T-SQL-figyelmeztetéseket a projekt összeállítása során, amely a hibaszámok vesszővel tagolt listájaként van megadva.

A TreatTSqlWarningsAsErrors tulajdonság hibaként kezeli a T-SQL-figyelmeztetéseket, ami azt eredményezi, hogy a T-SQL-figyelmeztetések sikertelenek lesznek a buildelés során. A TreatTSqlWarningsAsErrors alapértelmezett értéke False.

Példa a projekttulajdonságok használatára

Az alábbi példa bemutatja, hogyan állíthatja be a CompatibilityMode, IsChangeTrackingOnés TreatTSqlWarningsAsErrors tulajdonságait egy SQL-projektfájlban. A CompatibilityMode tulajdonság értéke 130, a IsChangeTrackingOn tulajdonság értéke True, a TreatTSqlWarningsAsErrors tulajdonság értéke pedig True. A TreatSqlWarningsAsErrors tulajdonság csak True-re van állítva a Release build konfiguráción.

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

Minden projekttulajdonság

Egyes projekttulajdonságok olyan adatbázis-beállításokhoz vannak társítva, amelyek csak az SQL Server-adatbázisokra vagy az SQL Server adott verzióira vonatkoznak. Mielőtt belevenné egy projekttulajdonságot a projektbe, tekintse át az adatbázis-beállítás kapcsolódó dokumentációját a tulajdonság és az adatbázis követelményeinek viselkedésének megértéséhez.

Property	`DATABASE SET` lehetőség	Felhasználói felület címkéje	AZ SQL-projekt alapértelmezett értéke	Engedélyezett értékek
AllowSnapshotIsolation	`ALLOW_SNAPSHOT_ISOLATION`	Adatbázis-beállítások, Működési, Pillanatkép-elkülönítés engedélyezése	False	{True\|False}
AnsiNulls	`ANSI_NULLS`	Adatbázis-beállítások, SET ANSI_NULLS	True	{True\|False}
AnsiPadding	`ANSI_PADDING`	Adatbázis-beállítások, SET ANSI_PADDING	True	{True\|False}
AnsiWarnings	`ANSI_WARNINGS`	Adatbázis-beállítások, SET ANSI_WARNINGS	True	{True\|False}
ArithAbort	`ARITHABORT`	Adatbázis-beállítások, SET ARITHABORT	True	{True\|False}
AutoClose	`AUTO_CLOSE`	Adatbázis-beállítások, Működés, Automatikus bezárás	False	{True\|False}
AutoCreateStatistics	`AUTO_CREATE_STATISTICS`	Adatbázis-beállítások, Operatív, Automatikus statisztika létrehozása	True	{True\|False}
AutoCreateStatisticsIncremental	`AUTO_CREATE_STATISTICS` (`INCREMENTAL`)	Adatbázis-beállítások, Működés, Automatikus fokozatos létrehozás	False	{True\|False}
AutoShrink	`AUTO_SHRINK`	Adatbázis-beállítások, Működés, Automatikus zsugorítás	False	{True\|False}
AutoUpdateStatistics	`AUTO_UPDATE_STATISTICS`	Adatbázis-beállítások, működési, automatikus frissítési statisztikák	True	{True\|False}
AutoUpdateStatisticsAsynchronously	`AUTO_UPDATE_STATISTICS_ASYNC`	Adatbázis-beállítások, működési, automatikus frissítési statisztikák aszinkron módon	False	{True\|False}
ChangeTrackingRetentionPeriod	`CHANGE_RETENTION`	Adatbázis-beállítások, Működési, Változáskövetési megőrzési időszak	2	{integer}
ChangeTrackingRetentionUnit	`CHANGE_RETENTION`	Adatbázis-beállítások, Működési, Változáskövetési megőrzési időszak	MINUTES	{DAYS\|HOURS\|MINUTES}
CloseCursorOnCommitEnabled	`CURSOR_CLOSE_ON_COMMIT`	Adatbázis-beállítások, Működés, Kurzor bezárása a véglegesítésen engedélyezve	False	{True\|False}
CompatibilityMode	`COMPATIBILITY_LEVEL`	Adatbázis-beállítások, kompatibilitási szint		{100\|110\|120\|130\|140\|150\|160\|170}¹
ConcatNullYieldsNull	`CONCAT_NULL_YIELDS_NULL`	Adatbázis-beállítások, SET CONCAT_NULL_YIELDS_NULL	True	{True\|False}
Containment	`CONTAINMENT`	Adatbázis-beállítások, Tartalmazás	NONE	{NONE\|PARTIAL}
DacApplicationName		Adatrétegbeli alkalmazás (`.dacpac`) tulajdonságai, neve	A projekt neve	{string}
DacDescription		Adatrétegbeli alkalmazás (`.dacpac`) tulajdonságai, leírása		{string}
DacVersion		Adatrétegű alkalmazás (`.dacpac`) tulajdonságai, verziója	1.0.0.0	{szemantikai verziószám}
DatabaseAccess	`db_user_access_option`	Adatbázis-beállítások, Adatbázis-hozzáférés	MULTI_USER	{MULTI_USER\|SINGLE_USER\|RESTRICTED_USER}
DatabaseChaining	`DB_CHAINING`	Adatbázis-beállítások, adatbázisláncolás	False	{True\|False}
DatabaseDefaultFulltextLanguage	`DEFAULT_FULLTEXT_LANGUAGE`	Adatbázis-beállítások, Alapértelmezett teljes szöveges nyelv	1033	{egész szám nyelvazonosító}
DatabaseDefaultLanguage	`DEFAULT_LANGUAGE`	Adatbázis-beállítások, alapértelmezett nyelv	1033	{egész szám nyelvazonosító}
DatabaseState	`db_state_option`	Adatbázis-beállítások, Adatbázis állapota	ONLINE	{ONLINE\|OFFLINE}
DbScopedConfigLegacyCardinalityEstimation	`LEGACY_CARDINALITY_ESTIMATION` ²	Adatbázis-hatókörű konfiguráció, örökölt számosság becslése	Off	{Off\|On}
DbScopedConfigLegacyCardinalitySecondaryEstimation	`LEGACY_CARDINALITY_SECONDARY_ESTIMATION` ²	Adatbázis-hatókörű konfiguráció, másodlagos adatok örökölt kardinalitásának becslése	Primary	{Primary\|Off\|On}
DbScopedConfigParameterSniffing	`PARAMETER_SNIFFING` ²	Adatbázis-hatókörű konfiguráció, paraméterérzékelés	On	{On\|Off}
DbScopedConfigParameterSniffingSecondary	`PARAMETER_SNIFFING_SECONDARY` ²	Adatbázis-hatókörű konfiguráció, paraméter detektálás másodlagos elemekhez	Primary	{Primary\|Off\|On}
DbScopedConfigOptimizerHotfixes	`OPTIMIZER_HOTFIXES` ²	Adatbázis-hatókörű konfiguráció, lekérdezésoptimalizáló gyorsjavítások	Off	{Off\|On}
DbScopedConfigOptimizerHotfixesSecondary	`OPTIMIZER_HOTFIXES_SECONDARY` ²	Adatbázis-hatókörű konfiguráció, lekérdezésoptimalizáló gyorsjavítások másodlagoshoz	Primary	{Primary\|Off\|On}
DbScopedConfigMaxDOP	`MAXDOP` ²	Adatbázis-hatókörű konfiguráció, Maximális párhuzamossági fok	0	{integer}
DbScopedConfigMaxDOPSecondary	`MAXDOP_SECONDARY` ²	Adatbázis-hatókörrel rendelkező konfiguráció, a másodlagos párhuzamosság maximális foka		{integer}
DbScopedConfigDWCompatibilityLevel	`DW_COMPATIBILITY_LEVEL` ²	Adatbázis-hatókörű konfiguráció, DW kompatibilitási szint	0	{0\|10\|20\|30\|40\|50\|9000}³
DefaultCollation	`COLLATE` ⁴	Adatbázis-beállítások, adatbázis-rendezés	SQL_Latin1_General_CP1_CI_AS	Az érvényes értékekért lásd SQL Server kollációs név.
DefaultCursor	`CURSOR_DEFAULT`	Adatbázis-beállítások, Operatív, Alapértelmezett kurzor	Local	{Global\|Local}
DefaultFilegroup		Adatbázis-beállítások, Operatív, Alapértelmezett fájlcsoport	PRIMARY	{string}
DefaultFileStreamFilegroup	Adatbázis-beállítások, Működési, Alapértelmezett fájlstream-fájlcsoport		{string}
DefaultSchema		Általános projektbeállítás, alapértelmezett séma	dbo	{string}
DelayedDurability	`DELAYED_DURABILITY`	Adatbázis-beállítások, Működési beállítások, Késleltetett tartósságú tranzakciók	DISABLED	{DISABLED\|ALLOWED\|FORCED}
DSP		Az SQL-projekt célplatformja		Az érvényes értékek megtekintéséhez tekintse meg a(z) célplatformot.
EnableFullTextSearch		Adatbázis-beállítások, Teljes szöveges keresés engedélyezése	True	{True\|False}
FileStreamDirectoryName	`FILESTREAM` (`DIRECTORY_NAME`)	Adatbázis-beállítások, FILESTREAM-címtár neve		{string}
IsBrokerPriorityHonored	`HONOR_BROKER_PRIORITY`	Adatbázis-beállítások, a broker prioritása tiszteletben tartva	False	{True\|False}
IsChangeTrackingAutoCleanupOn	`CHANGE_TRACKING`	Adatbázis-beállítások, Működés, Változáskövetés automatikus törlése	True	{True\|False}
IsChangeTrackingOn	`CHANGE_TRACKING`	Adatbázis-beállítások, Működés, Változáskövetés	False	{True\|False}
IsEncryptionOn	`ENCRYPTION`	Adatbázis-beállítások, Titkosítás engedélyezve	False	{True\|False}
IsLedgerOn	`LEDGER` ⁴	Adatbázis-beállítások, Főkönyv engedélyezése	False	{True\|False}
IsNestedTriggersOn	`NESTED_TRIGGERS`	Adatbázis-beállítások, beágyazott eseményindítók engedélyezve	True	{True\|False}
IsTransformNoiseWordsOn	`TRANSFORM_NOISE_WORDS`	Adatbázis-beállítások, Zajszavak átalakítása	False	{True\|False}
MemoryOptimizedElevateToSnapshot	`MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT`	Adatbázis-beállítások, működési, memóriaoptimalizált emelés pillanatképre	False	{True\|False}
ModelCollation		Projektbeállítások, Kolláció	1033,CI	{egész szám nyelvazonosító}, {CI\|CS}
NonTransactedFileStreamAccess	`NON_TRANSACTED_ACCESS`	Adatbázis-beállítások, FILESTREAM nem tranzakcionált hozzáférés	OFF	{OFF\|READ_ONLY\|FULL}
NumericRoundAbort	`NUMERIC_ROUNDABORT`	Adatbázis-beállítások: SET NUMERIC_ROUNDABORT	False	{True\|False}
OutputPath		Buildbeállítások, Kimeneti elérési út	`bin\Debug` és `bin\Release`	{string}
PageVerify	`PAGE_VERIFY`	Adatbázis-beállítások, Működés, Lap ellenőrzése	NONE	{NONE\|TORN_PAGE_DETECTION\|CHECKSUM}
Parameterization	`PARAMETERIZATION`	Adatbázis-beállítások, paraméterezés	SIMPLE	{SIMPLE\|FORCED}
QueryStoreCaptureMode	`QUERY_STORE` (`QUERY_CAPTURE_MODE`)	Adatbázis-beállítások, Működési, Lekérdezéstár rögzítési módja	ALL	{OFF\|ALL\|AUTO}
QueryStoreDesiredState	`QUERY_STORE` (`OPERATION_MODE`)	Adatbázis-beállítások, Működési, Lekérdezéstár műveleti mód	OFF	{OFF\|READ_WRITE\|READ_ONLY}
QueryStoreFlushInterval	`QUERY_STORE` (`DATA_FLUSH_INTERVAL_SECONDS`)	Adatbázis-beállítások, Működési, Lekérdezéstár adatöblítési időköze (másodperc)	900	{integer}
QueryStoreIntervalLength	`QUERY_STORE` (`INTERVAL_LENGTH_MINUTES`)	Adatbázis-beállítások, Működési, Lekérdezéstár intervallumhossza (perc)	60	{integer}
QueryStoreMaxPlansPerQuery	`QUERY_STORE` (`MAX_PLANS_PER_QUERY`)	Adatbázis-beállítások, Működési, Lekérdezéstár maximális tervek lekérdezésenként	200	{integer}
QueryStoreMaxStorageSize	`QUERY_STORE` (`MAX_STORAGE_SIZE_MB`)	Adatbázis-beállítások, Operatív, Lekérdezéstár maximális tárhelymérete (MB)	100	{integer}
QueryStoreStaleQueryThreshold	`QUERY_STORE` (`STALE_QUERY_THRESHOLD_DAYS`)	Adatbázis-beállítások, Működési, Lekérdezéstár elavult lekérdezési küszöbértéke (nap)	367	{integer}
QuotedIdentifier	`QUOTED_IDENTIFIER`	Adatbázis-beállítások, SET QUOTED_IDENTIFIER	True	{True\|False}
ReadCommittedSnapshot	`READ_COMMITTED_SNAPSHOT`	Adatbázis-beállítások, Üzemi, Olvasási elkötelezettségi pillanatkép	False	{True\|False}
Recovery	`RECOVERY`	Adatbázis-beállítások, Működés, Helyreállítás	FULL	{FULL\|SIMPLE\|BULK_LOGGED}
RecursiveTriggersEnabled	`RECURSIVE_TRIGGERS`	Adatbázis-beállítások, rekurzív eseményindítók engedélyezve	False	{True\|False}
ServiceBrokerOption	`SERVICE_BROKER`	Adatbázis-beállítások, Szolgáltatásközvetítő beállításai	DisableBroker	{DisableBroker\|EnableBroker\|NewBroker\|ErrorBrokerConversations}
SuppressTSqlWarnings		Buildbeállítások, T-SQL-figyelmeztetések letiltása (T-SQL-figyelmeztető kódok vesszővel tagolt listája)		{string}
TargetRecoveryTimePeriod	Adatbázis-beállítások, üzemeltetési és célzott helyreállítási idő (másodperc)	A közvetett ellenőrzőpontok gyakoriságát határozza meg adatbázisonként.	60	{integer}
TargetRecoveryTimeUnit		Adatbázis-beállítások, működési beállítások, célzott helyreállítási idő	SECONDS	{MINUTES\|SECONDS}
TreatTSqlWarningsAsErrors		Beállítások a buildhez, T-SQL-figyelmeztetések kezelése hibaként	False	{True\|False}
Trustworthy	`TRUSTWORTHY`	Adatbázis-beállítások, Megbízható	False	{True\|False}
TwoDigitYearCutoff	`TWO_DIGIT_YEAR_CUTOFF`	Adatbázis-beállítások, Kétjegyű év határértéke	2049	{integer}
UpdateOptions	`db_update_option`	Adatbázis-beállítások, Frissítési beállítások	READ_WRITE	{READ_WRITE\|READ_ONLY}
ValidateCasingOnIdentifiers		Általános projektbeállítás, az azonosítók burkolatának ellenőrzése	True	{True\|False}

Az alapértelmezett érték a motorkiadástól és a kiszolgáló beállításaitól függően eltérő.
Adatbázisra vonatkozó konfigurációs beállítások.
Az AUTO a 0 értékkel van beállítva.
Kizárólag CREATE DATABASEopcióként alkalmazható.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-11-18