Udostępnij za pośrednictwem

Właściwości projektów SQL

  • Artykuł

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL Database w usłudze Microsoft Fabric

Oprócz zawartości poszczególnych plików .sql projekty bazy danych SQL zawierają właściwości definiujące zachowanie projektu i ustawienia na poziomie bazy danych. Te właściwości są przechowywane w pliku .sqlproj i można je ustawić, edytując plik .sqlproj bezpośrednio. Niektóre narzędzia projektów SQL, takie jak Visual Studio i VS Code, zapewniają dostęp do edytowania kilku lub wielu właściwości projektu w graficznym interfejsie użytkownika. Ten artykuł zawiera omówienie właściwości, które można ustawić dla projektów bazy danych SQL.

Często używane właściwości projektów SQL obejmują:

Wyłączanie zmian opcji bazy danych

Podczas publikowania projektu SQL zmiany opcji bazy danych są skryptowane na podstawie wartości zdefiniowanych we właściwościach projektu i domyślnych wartościach projektu. Aby zapobiec modyfikacji opcji bazy danych podczas publikowania, użyj narzędzia, takiego jak SqlPackage CLI lub Visual Studio, ustaw właściwość publish na wartość fałsz ScriptDatabaseOptions. To ustawienie można również włączyć w profilu publikowania.

Typowe właściwości projektu

Właściwość platformy docelowej określa wersję programu SQL Server przeznaczoną dla projektu. Właściwość DSP służy do ustawiania platformy docelowej dla projektu SQL. Więcej informacji na temat platformy docelowej można znaleźć w artykule platformy docelowej.

Analiza kodu może znacznie poprawić proces ciągłej integracji i wdrażania, przechwytując potencjalne problemy na wczesnym etapie cyklu projektowania. Dowiedz się więcej o włączaniu analizy kodu i uwzględnianiu reguł niestandardowych w artykule o analizie kodu SQL.

Właściwości aplikacji warstwy danych

Następujące właściwości służą do definiowania aplikacji warstwy danych (DAC), która jest tworzona podczas kompilowania projektu SQL.

  • DacApplicationName: nazwa aplikacji warstwy danych .dacpac. Wartość domyślna to nazwa projektu.
  • DacDescription: opcjonalny opis aplikacji warstwy danych .dacpac.
  • DacVersion: wersja aplikacji warstwy danych .dacpac. Wartość domyślna to 1.0.0.0.

Schemat domyślny

Właściwość DefaultSchema ustawia domyślny schemat projektu SQL. Ta właściwość ma zastosowanie do jednoczęściowych obiektów nazwanych. Wartość domyślna to dbo.

Ostrzeżenia języka T-SQL

Właściwości SuppressTSqlWarnings i TreatTSqlWarningsAsErrors kontrolują sposób obsługi ostrzeżeń języka T-SQL podczas kompilacji projektu. Właściwość SuppressTSqlWarnings pomija ostrzeżenia języka T-SQL podczas kompilacji projektu określone jako rozdzielona przecinkami lista numerów błędów.

Właściwość TreatTSqlWarningsAsErrors traktuje ostrzeżenia języka T-SQL jako błędy, powodując niepowodzenie kompilacji wszelkie ostrzeżenia języka T-SQL. Wartość domyślna TreatTSqlWarningsAsErrors to False.

Przykładowe użycie właściwości projektu

W poniższym przykładzie pokazano, jak ustawić właściwości CompatibilityMode, IsChangeTrackingOni TreatTSqlWarningsAsErrors w pliku projektu SQL. Właściwość CompatibilityMode jest ustawiona na wartość 130, właściwość IsChangeTrackingOn jest ustawiona na wartość True, a właściwość TreatTSqlWarningsAsErrors jest ustawiona na wartość True. Właściwość TreatSqlWarningsAsErrors jest ustawiona tylko na wartość True w konfiguracji kompilacji 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>

Wszystkie właściwości projektu

Niektóre właściwości projektu są skojarzone z opcjami bazy danych, które mają zastosowanie tylko do baz danych programu SQL Server lub określonych wersji programu SQL Server. Przed dołączeniem właściwości projektu, przejrzyj skojarzoną dokumentację opcji bazy danych, aby zrozumieć zachowanie właściwości oraz wymagania bazy danych.

Własność opcja DATABASE SET Etykieta interfejsu użytkownika Wartość domyślna projektu SQL Dozwolone wartości
Zezwalaj na izolację migawek ALLOW_SNAPSHOT_ISOLATION Ustawienia bazy danych, Operacyjne, Zezwalaj na izolację migawek Fałsz {Prawda|Fałsz}
AnsiNulls ANSI_NULLS Ustawienia bazy danych, SET ANSI_NULLS Prawda {Prawda|Fałsz}
AnsiPadding ANSI_PADDING Ustawienia bazy danych, SET ANSI_PADDING Prawda {Prawda|Fałsz}
AnsiWarnings ANSI_WARNINGS Ustawienia bazy danych, SET ANSI_WARNINGS Prawda {Prawda|Fałsz}
ArithAbort ARITHABORT Ustawienia bazy danych, SET ARITHABORT Prawda {Prawda|Fałsz}
Automatyczne zamykanie AUTO_CLOSE Ustawienia bazy danych, Operacyjne, Automatyczne zamykanie Fałsz {Prawda|Fałsz}
Autotworzenie statystyk AUTO_CREATE_STATISTICS Ustawienia bazy danych, operacyjne, automatyczne tworzenie statystyk Prawda {Prawda|Fałsz}
AutoShrink AUTO_SHRINK Ustawienia bazy danych, operacyjne, automatyczne zmniejszanie Fałsz {Prawda|Fałsz}
AutomatycznaAktualizacjaStatystyk AUTO_UPDATE_STATISTICS Ustawienia bazy danych, operacyjne, automatyczne aktualizowanie statystyk Prawda {Prawda|Fałsz}
AutomatycznaAktualizacjaStatystykAsynchronicznie AUTO_UPDATE_STATISTICS_ASYNC Ustawienia bazy danych, operacyjne, automatyczne aktualizowanie statystyk asynchronicznie Fałszywy {Prawda|Fałsz}
Okres przechowywania śledzenia zmian CHANGE_RETENTION Ustawienia bazy danych, operacyjne, okres przechowywania śledzenia zmian 2 {liczba całkowita}
JednostkaPrzechowywaniaŚledzeniaZmian CHANGE_RETENTION Ustawienia bazy danych, operacyjne, okres przechowywania śledzenia zmian PROTOKÓŁ {DNI|GODZINY|MINUTY}
CloseCursorOnCommitEnabled CURSOR_CLOSE_ON_COMMIT Ustawienia bazy danych, Operacyjne, Zamknij kursor przy włączonym zatwierdzeniu Fałszywy {Prawda|Fałsz}
Tryb zgodności COMPATIBILITY_LEVEL Ustawienia bazy danych, poziom zgodności {100|110|120|130|140|150|160|170}1
ConcatNullYieldsNull CONCAT_NULL_YIELDS_NULL Ustawienia bazy danych, SET CONCAT_NULL_YIELDS_NULL Prawda {Prawda|Fałsz}
Powstrzymanie CONTAINMENT Ustawienia bazy danych, ograniczenie ŻADEN {NONE|CZĘŚCIOWE}
DacApplicationName Aplikacja warstwy danych (.dacpac) właściwości, nazwa Nazwa projektu {string}
Opis DAC Aplikacja poziomu danych (.dacpac), właściwości i opis {string}
DacVersion Właściwości aplikacji warstwy danych (.dacpac), wersja 1.0.0.0 {semantyczny numer wersji}
DatabaseAccess db_user_access_option Ustawienia bazy danych, dostęp do bazy danych Wielu użytkowników {WIELOUŻYTKOWNIKOWY|JEDNOUŻYTKOWNIKOWY|OGRANICZONY_UŻYTKOWNIK}
Łańcuchowanie baz danych DB_CHAINING Ustawienia bazy danych, tworzenie łańcuchów baz danych Fałszywy {Prawda|Fałsz}
DomyślnyJęzykPełnotekstowyBazyDanych DEFAULT_FULLTEXT_LANGUAGE Ustawienia bazy danych, domyślny język pełnotekstowy 1033 {liczba całkowita identyfikator języka}
DomyślnyJęzykBazyDanych DEFAULT_LANGUAGE Ustawienia bazy danych, język domyślny 1033 {liczba całkowita identyfikator języka}
DatabaseState db_state_option Ustawienia bazy danych, stan bazy danych ONLINE {ONLINE|OFFLINE}
DbScopedConfigLegacyCardinalityEstimation (Konfiguracja zakresowa bazy danych z szacowaniem liczebności - funkcja legacy) LEGACY_CARDINALITY_ESTIMATION 2 Konfiguracja w zakresie bazy danych, Szacowanie klasycznej kardynalności Wyłączony {Wyłączone|Włączone}
Starsza kardynalność wtórne oszacowanie w DbScopedConfig LEGACY_CARDINALITY_SECONDARY_ESTIMATION 2 Konfiguracja w zakresie bazy danych, Szacowanie starszej kardynalności dla pomocniczej Podstawowy {Podstawowe|Wyłączone|Włączone}
DbScopedConfigParameterSniffing PARAMETER_SNIFFING 2 Konfiguracja w zakresie bazy danych, analiza parametrów Na {Włączone|Wyłączone}
DbScopedConfigParameterSniffingSecondary PARAMETER_SNIFFING_SECONDARY 2 Konfiguracja zakresu bazy danych, rozpoznawanie parametrów dla bazy pomocniczej Podstawowy {Główne|Wyłączone|Włączone}
DbScopedConfigOptimizerHotfixes OPTIMIZER_HOTFIXES 2 Konfiguracja w zakresie bazy danych, poprawki optymalizatora zapytań Wyłączony {Wyłączone|Włączone}
KonfiguracjaZZakresemDbOptymalizatorHotfixesPomocnicze OPTIMIZER_HOTFIXES_SECONDARY 2 Konfiguracja w zakresie bazy danych, poprawki optymalizatora zapytań dla instancji zapasowej. Podstawowy {Podstawowy|Wyłączone|Włączone}
DbScopedConfigMaxDOP MAXDOP 2 Konfiguracja w zakresie bazy danych, Maksymalny stopień równoległości 0 {liczba całkowita}
DbScopedConfigMaxDOPSecondary MAXDOP_SECONDARY 2 Konfiguracja w zakresie bazy danych, Maksymalny stopień równoległości dla pomocniczej instancji {liczba całkowita}
DbScopedConfigDWCompatibilityLevel DW_COMPATIBILITY_LEVEL 2 Konfiguracja w zakresie bazy danych, poziom zgodności usługi DW 0 {0|10|20|30|40|50|9000}3
Domyślna kolejność COLLATE 4 Ustawienia bazy danych, sortowanie bazy danych SQL_Latin1_General_CP1_CI_AS Zobacz nazwę sortowania programu SQL Server, aby uzyskać prawidłowe wartości.
DefaultCursor CURSOR_DEFAULT Ustawienia bazy danych, operacyjne, kursor domyślny Lokalny {Globalny|Lokalny}
Domyślna Grupa Plików Ustawienia bazy danych, operacyjna, domyślna grupa plików PODSTAWOWY {string}
DefaultFileStreamFilegroup Ustawienia bazy danych, operacyjne, domyślna grupa plików filestream {string}
DefaultSchema Ogólne ustawienie projektu, domyślny schemat DBO {string}
OpóźnionaTrwałość DELAYED_DURABILITY Ustawienia bazy danych, operacyjne, transakcje z opóźnioną trwałością NIEPEŁNOSPRAWNY {WYŁĄCZONE|DOZWOLONE|WYMUSZONE}
DSP (Cyfrowe Przetwarzanie Sygnałów) Platforma docelowa dla projektu SQL Aby uzyskać prawidłowe wartości, zobacz platformy docelowej.
WłączPełnotekstoweWyszukiwanie Ustawienia bazy danych, Włączanie wyszukiwania pełnotekstowego Prawda {Prawda|Fałsz}
FileStreamDirectoryName FILESTREAM (DIRECTORY_NAME) Ustawienia bazy danych, nazwa katalogu FILESTREAM {string}
Czy Priorytet Brokera Jest Przestrzegany HONOR_BROKER_PRIORITY Ustawienia bazy danych, priorytet brokera uwzględniony Fałszywy {Prawda|Fałsz}
Czy automatyczne czyszczenie śledzenia zmian jest włączone CHANGE_TRACKING Ustawienia bazy danych, operacyjne, automatyczne czyszczenie śledzenia zmian Prawda {Prawda|Fałsz}
CzyŚledzenieZmianJestWłączone CHANGE_TRACKING Ustawienia bazy danych, operacyjne, śledzenie zmian Fałsz {Prawda|Fałsz}
CzySzyfrowanieJestWłączone ENCRYPTION Ustawienia bazy danych, włączone szyfrowanie Fałszywy {Prawda|Fałsz}
IsLedgerOn LEDGER 4 Ustawienia bazy danych, Włączanie rejestru Fałszywy {Prawda|Fałsz}
IsNestedTriggersOn NESTED_TRIGGERS Ustawienia bazy danych, zagnieżdżone wyzwalacze włączone Prawdziwy {Prawda|Fałsz}
IsTransformNoiseWordsOn TRANSFORM_NOISE_WORDS Ustawienia bazy danych, Konwersja słów szumowych Fałszywy {Prawda|Fałsz}
MemoryOptimizedElevateToSnapshot MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT Ustawienia bazy danych, operacyjne, zoptymalizowane pod kątem pamięci, podniesione do poziomu migawek. Nieprawda {Prawda|Fałsz}
Porządkowanie Modelu Ustawienia projektu, sortowanie 1033, ciągła integracja {integer identyfikator języka}, {CI|CS}
Dostęp do strumienia plików bez transakcji NON_TRANSACTED_ACCESS Ustawienia bazy danych, dostęp bez transakcji FILESTREAM WYŁĄCZONE {WYŁĄCZONY|READ_ONLY|PEŁNY}
NumericRoundAbort NUMERIC_ROUNDABORT Ustawienia bazy danych, SET NUMERIC_ROUNDABORT Fałszywy {Prawda|Fałsz}
Ścieżka Wyjściowa Ustawienia kompilacji, ścieżka wyjściowa bin\Debug i bin\Release {string}
PageVerify PAGE_VERIFY Ustawienia bazy danych, Operacyjne, Weryfikowanie strony ŻADEN {NONE|WYKRYWANIE ROZERWANEJ STRONY|SUMA KONTROLNA}
Parametryzacja PARAMETERIZATION Ustawienia bazy danych, parametryzacja PROSTY {SIMPLE|WYMUSZONE}
QueryStoreCaptureMode QUERY_STORE (QUERY_CAPTURE_MODE) Ustawienia bazy danych, operacyjny, tryb przechwytywania magazynu zapytań WSZYSTKO {WYŁĄCZ|WSZYSTKIE|AUTO}
ZapytaniePrzechowujŻądanyStan QUERY_STORE (OPERATION_MODE) Ustawienia bazy danych, działanie, tryb działania magazynu zapytań WYŁ. {WYŁĄCZONY|ODCZYT_ZAPIS|TYLKO_DO_ODCZYTU}
QueryStoreFlushInterval QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS) Ustawienia bazy danych, operacyjne, interwał opróżniania danych magazynu zapytań (w sekundach) 900 {liczba całkowita}
QueryStoreIntervalLength QUERY_STORE (INTERVAL_LENGTH_MINUTES) Ustawienia bazy danych, operacyjne, długość interwału magazynu zapytań (w minutach) 60 {liczba całkowita}
QueryStoreMaxPlansPerQuery QUERY_STORE (MAX_PLANS_PER_QUERY) Ustawienia bazy danych, Operacja, maksymalna liczba planów w repozytorium zapytań na jedno zapytanie 200 {liczba całkowita}
QueryStoreMaxStorageSize QUERY_STORE (MAX_STORAGE_SIZE_MB) Ustawienia bazy danych, operacyjne, maksymalny rozmiar magazynu zapytań (MB) 100 {liczba całkowita}
QueryStoreStaleQueryThreshold QUERY_STORE (STALE_QUERY_THRESHOLD_DAYS) Ustawienia bazy danych, operacyjne, próg nieaktualności zapytań w magazynie zapytań (dni) 367 {liczba całkowita}
CudzysłowionyIdentyfikator QUOTED_IDENTIFIER Ustawienia bazy danych: SET QUOTED_IDENTIFIER Prawda {Prawda|Fałsz}
ReadCommittedSnapshot READ_COMMITTED_SNAPSHOT Ustawienia bazy danych, operacyjny, odczyt zatwierdzonej migawki Fałszywy {Prawda|Fałsz}
Odzyskiwanie RECOVERY Ustawienia bazy danych, operacyjne, odzyskiwanie PEŁNY {FULL|SIMPLE|BULK_LOGGED}
WłączonoRekursywneWyzwalacze RECURSIVE_TRIGGERS Ustawienia bazy danych, wyzwalacze cykliczne włączone Fałsz {Prawda|Fałsz}
ServiceBrokerOption SERVICE_BROKER Ustawienia bazy danych, opcje brokera usług WyłączPośrednika {WyłączBroker|WłączBroker|NowyBroker|BłądKonwersacjeBrokera}
SuppressTSqlWarnings Ustawienia kompilacji, pomijanie ostrzeżeń języka T-SQL (rozdzielona przecinkami lista kodów ostrzegawczych języka T-SQL) {string}
Docelowy czas odbudowy Ustawienia bazy danych, operacyjny, docelowy czas odzyskiwania (w sekundach) Określa częstotliwość pośrednich punktów kontrolnych dla poszczególnych baz danych. 60 {liczba całkowita}
DocelowaJednostkaCzasuOdzyskiwania Ustawienia bazy danych, operacyjny, docelowy czas rejestratora SEKUND {MINUTES|SEKUNDY}
OznaczajOstrzezeniaTSqlJakoBledy Ustawienia kompilacji, traktuj ostrzeżenia języka T-SQL jako błędy Fałszywy {Prawda|Fałsz}
Godny zaufania TRUSTWORTHY Ustawienia bazy danych, godne zaufania Fałszywy {Prawda|Fałsz}
GranicaDwucyfrowegoRoku TWO_DIGIT_YEAR_CUTOFF Ustawienia bazy danych, próg dwucyfrowego roku 2049 {liczba całkowita}
OpcjeAktualizacji db_update_option Ustawienia bazy danych, Opcje aktualizacji ODCZYT_ZAPIS {ODCZYT_ZAPIS|TYLKO_ODCZYT}
WalidujWielkośćLiterDlaIdentyfikatorów Ogólne ustawienie projektu, weryfikowanie wielkości liter identyfikatorów Prawda {Prawda|Fałsz}
  1. Wartość domyślna różni się w zależności od wersji silnika i ustawień serwera.
  2. Opcje konfiguracji w zakresie bazy danych.
  3. Funkcja AUTO jest ustawiana z wartością 0.
  4. Ma zastosowanie tylko jako opcja CREATE DATABASE.

Powiązana zawartość