Condividi tramite

Proprietà dei progetti SQL

si applica a:SQL Serverdatabase SQL di AzureIstanza gestita di SQL di Azuredatabase SQL in Microsoft Fabric

Oltre al contenuto dei singoli file di .sql, i progetti di database SQL contengono proprietà che definiscono il comportamento del progetto e le impostazioni a livello di database. Queste proprietà vengono archiviate nel file .sqlproj e possono essere impostate modificando direttamente il file .sqlproj. Alcuni strumenti di progetti SQL, ad esempio Visual Studio e VS Code, forniscono l'accesso per modificare alcune o molte delle proprietà del progetto in un'interfaccia utente grafica. Questo articolo offre una panoramica delle proprietà che è possibile impostare per i progetti di database SQL.

Le proprietà dei progetti SQL comunemente usate includono:

Disabilitare le modifiche alle opzioni del database

Durante la pubblicazione del progetto SQL, le modifiche apportate alle opzioni del database vengono compilate in base ai valori definiti nelle proprietà del progetto e ai valori predefiniti del progetto. Per impedire che le opzioni di database vengano modificate durante la pubblicazione, usando uno strumento come 'interfaccia della riga di comando di SqlPackage o Visual Studio, impostare la proprietà publish su ScriptDatabaseOptions su false. Questa impostazione può essere incorporata anche in un profilo di pubblicazione.

Proprietà comuni del progetto

La proprietà della piattaforma di destinazione specifica la versione di SQL Server di destinazione del progetto. La proprietà DSP viene usata per impostare la piattaforma di destinazione per il progetto SQL. Altre informazioni sulla piattaforma di destinazione sono disponibili nell'articolo piattaforma di destinazione.

L'analisi del codice può migliorare notevolmente il processo di integrazione e distribuzione continua rilevando potenziali problemi all'inizio del ciclo di vita dello sviluppo. Per saperne di più sull'abilitazione dell'analisi del codice e sull'inclusione di regole personalizzate, consulta l'articolo sull'analisi del codice SQL .

Proprietà dell'applicazione a livello dati

Le proprietà seguenti vengono usate per definire l'applicazione livello dati creata al momento della compilazione del progetto SQL.

  • DacApplicationName: nome dell'applicazione livello dati .dacpac. Il valore predefinito è il nome del progetto.
  • dacDescription: descrizione facoltativa dell'applicazione livello dati .dacpac.
  • DacVersion: La versione dell'applicazione al livello dati .dacpac. Il valore predefinito è 1.0.0.0.

Schema predefinito

La proprietà DefaultSchema imposta lo schema predefinito per il progetto SQL. Questa proprietà si applica agli oggetti denominati in 1 parte. Il valore predefinito è dbo.

Avvisi T-SQL

Le proprietà SuppressTSqlWarnings e TreatTSqlWarningsAsErrors controllano la modalità di gestione degli avvisi T-SQL durante la compilazione del progetto. La proprietà SuppressTSqlWarnings elimina gli avvisi T-SQL durante la compilazione del progetto, specificata come elenco delimitato da virgole di numeri di errore.

La proprietà TreatTSqlWarningsAsErrors considera gli avvisi T-SQL come errori, causando l'esito negativo della compilazione di eventuali avvisi T-SQL. Il valore predefinito per TreatTSqlWarningsAsErrors è False.

Esempio di utilizzo delle proprietà del progetto

Nell'esempio seguente viene illustrato come impostare le proprietà CompatibilityMode, IsChangeTrackingOne TreatTSqlWarningsAsErrors in un file di progetto SQL. La proprietà CompatibilityMode è impostata su 130, la proprietà IsChangeTrackingOn è impostata su Truee la proprietà TreatTSqlWarningsAsErrors è impostata su True. La proprietà TreatSqlWarningsAsErrors è impostata solo su True nella configurazione di compilazione 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>

Tutte le proprietà del progetto

Alcune proprietà del progetto sono associate alle opzioni di database che si applicano solo ai database di SQL Server o a versioni specifiche di SQL Server. Prima di includere una proprietà di progetto nel progetto, esaminare la documentazione associata per l'opzione di database per comprendere il comportamento delle proprietà e dei requisiti del database.

Proprietà opzione DATABASE SET Etichetta dell'interfaccia utente Valore predefinito del progetto SQL Valori consentiti
ConsentiIsolamentoSnapshot ALLOW_SNAPSHOT_ISOLATION Impostazioni del database, Operazionali, Consenti isolamento snapshot Falso {Vero|Falso}
AnsiNulls ANSI_NULLS Impostazioni del database, SET ANSI_NULLS Vero {Vero|Falso}
AnsiPadding ANSI_PADDING Impostazioni del database, SET ANSI_PADDING Vero {Vero|Falso}
AnsiWarnings ANSI_WARNINGS Impostazioni del database: SET ANSI_WARNINGS Vero {Vero|Falso}
ArithAbort ARITHABORT Impostazioni del database, SET ARITHABORT Vero {Vero|Falso}
Chiusura Automatica AUTO_CLOSE Impostazioni del database, Operativo, Chiusura automatica Falso {Vero|Falso}
AutoCreateStatistics (CreazioneAutomaticaStatistiche) AUTO_CREATE_STATISTICS Impostazioni del database, Operativo, Creazione automatica statistiche Vero {Vero|Falso}
CreazioneAutomaticaStatisticheIncrementale AUTO_CREATE_STATISTICS (INCREMENTAL) Impostazioni del database, Operativo, Creazione automatica incrementale Falso {Vero|Falso}
Riduzione Automatica AUTO_SHRINK Impostazioni del database, Operativo, Compattazione automatica Falso {Vero|Falso}
Aggiornamento automatico delle statistiche AUTO_UPDATE_STATISTICS Impostazioni del database, Operativo, Statistiche di aggiornamento automatico Vero {Vero|Falso}
AggiornaStatisticheAutomaticamenteInModoAsincrono AUTO_UPDATE_STATISTICS_ASYNC Impostazioni del database, Operativo, Aggiornamento automatico statistiche in modo asincrono Falso {Vero|Falso}
Periodo di Conservazione del Tracciamento delle Modifiche CHANGE_RETENTION Impostazioni del database, Operativo, Periodo di conservazione per il tracciamento delle modifiche 2 {integer}
Unità di Retenzione del Tracciamento delle Modifiche CHANGE_RETENTION Impostazioni del database, Operativo, Periodo di conservazione per il tracciamento delle modifiche VERBALE {GIORNI|ORE|MINUTI}
CloseCursorOnCommitAbilitato CURSOR_CLOSE_ON_COMMIT Impostazioni del database, Modalità operativa, Chiudere il cursore al commit è abilitato Falso {Vero|Falso}
Modalità di Compatibilità COMPATIBILITY_LEVEL Impostazioni del database, livello di compatibilità {100|110|120|130|140|150|160|170}1
ConcatNullYieldsNull CONCAT_NULL_YIELDS_NULL Impostazioni del database: impostare CONCAT_NULL_YIELDS_NULL Vero {Vero|Falso}
Arginamento CONTAINMENT Impostazioni del database, contenimento NESSUNO {NONE|PARTIAL}
DacApplicationName Proprietà dell'applicazione a livello di dati (.dacpac), nome Nome del progetto {string}
Descrizione Dac Proprietà dell'applicazione di livello dati (.dacpac), descrizione {string}
DacVersion Proprietà dell'applicazione del livello dati (.dacpac), versione 1.0.0.0 {numero di versione semantica}
DatabaseAccess db_user_access_option Impostazioni del database, Accesso al database multiutente {UTENTE_MULTIPLO|UTENTE_SINGOLO|UTENTE_RISTRETTO}
Collegamento del database DB_CHAINING Impostazioni del database, concatenamento del database Falso {Vero|Falso}
LinguaPredefinitaDelTestoCompletoDelDatabase DEFAULT_FULLTEXT_LANGUAGE Impostazioni del database, lingua full-text predefinita 1033 {integer identificativo lingua}
LinguaPredefinitaDelDatabase DEFAULT_LANGUAGE Impostazioni del database, lingua predefinita 1033 {integer identificativo lingua}
DatabaseState db_state_option Impostazioni del database, Stato del database SU INTERNET {ONLINE|OFFLINE}
DbScopedConfigLegacyCardinalityEstimation LEGACY_CARDINALITY_ESTIMATION 2 Configurazione a livello di database, stima della cardinalità legacy Spento {Off|On}
ConfigurazioneScopedBdLegacyCardinalitàSecondariaStima LEGACY_CARDINALITY_SECONDARY_ESTIMATION 2 Configurazione con ambito specifico, stima della cardinalità legacy per i database secondari Primario {Primario|Disattivato |On}
DbScopedConfigParameterSniffing PARAMETER_SNIFFING 2 Configurazione con ambito database, analisi dei parametri Su {On|Off}
DbScopedConfigParameterSniffingSecondary PARAMETER_SNIFFING_SECONDARY 2 Configurazione a livello di database, analisi dei parametri per il secondario Primario {Primario|Disattivato |On}
DbScopedConfigOptimizerHotfixes OPTIMIZER_HOTFIXES 2 Configurazione con ambito database, hotfix per Query Optimizer Disattivato {Off|On}
ConfigurazioneOttimizzatoreDbCorrettoSecondario OPTIMIZER_HOTFIXES_SECONDARY 2 Configurazione con ambito database, hotfix dell'ottimizzatore di query per repliche secondarie Primario {Primario|Disattivato |On}
DbScopedConfigMaxDOP MAXDOP 2 Configurazione con ambito database, gradi massimi di parallelismo 0 {integer}
DbScopedConfigMaxDOPSecondary MAXDOP_SECONDARY 2 Configurazione con ambito limitato al database, massimo grado di parallelismo per il secondario {integer}
DbScopedConfigDWCompatibilityLevel DW_COMPATIBILITY_LEVEL 2 Configurazione specifica del database, livello di compatibilità DW 0 {0|10|20|30|40|50|9000}3
CollazionePredefinita COLLATE 4 Impostazioni del database, regole di confronto del database SQL_Latin1_General_CP1_CI_AS Consultare nome delle regole di confronto di SQL Server per ottenere i valori validi.
CursorePredefinito CURSOR_DEFAULT Impostazioni del database, Operativo, Cursore predefinito Locale {Global|Locale}
GruppoFilePredefinito Impostazioni del database, Operativo, Filegroup predefinito PRIMARIO {string}
Gruppo di file predefinito per FileStream Impostazioni del database, Operativo, Filegroup filestream predefinito {string}
SchemaPredefinito Impostazione generale del progetto, schema predefinito dbo {string}
Durabilità Ritardata DELAYED_DURABILITY Impostazioni del database, Operativo, Transazioni con durabilità ritardata DISATTIVATO {DISABILITATO|CONSENTITO|OBBLIGATORIO}
Processore di Segnale Digitale (DSP) della piattaforma di destinazione per il progetto SQL Vedere la piattaforma di destinazione per i valori validi.
AbilitaRicercaTestoCompleto Impostazioni del database, Abilitare la ricerca full-text Vero {Vero|Falso}
FileStreamDirectoryName FILESTREAM (DIRECTORY_NAME) Impostazioni del database, nome della directory FILESTREAM {string}
La priorità del broker è rispettata HONOR_BROKER_PRIORITY Impostazioni del database, priorità del broker rispettata Falso {Vero|Falso}
ÈAttivaLaPuliziaAutomaticaDelTracciamentoDelleModifiche CHANGE_TRACKING Impostazioni del database, Operazionale, Pulizia automatica del rilevamento modifiche Vero {Vero|Falso}
TracciamentoModificheAttivo CHANGE_TRACKING Impostazioni del database, Operativo, Rilevamento modifiche Falso {Vero|Falso}
CrittografiaAttiva ENCRYPTION Impostazioni del database, Crittografia abilitata Falso {Vero|Falso}
IsLedgerOn LEDGER 4 Impostazioni del database, Abilita libro mastro Falso {Vero|Falso}
IsNestedTriggersOn NESTED_TRIGGERS Impostazioni del database, abilitazione dei trigger annidati Vero {Vero|Falso}
TrasformaLeParoleDiDisturbo TRANSFORM_NOISE_WORDS Impostazioni del database, Trasforma parole superflue Falso {Vero|Falso}
MemoryOttimizzataElevataASnapshot MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT Impostazioni del database, Operatività, Ottimizzazione della memoria elevata a snapshot Falso {Vero|Falso}
ModelCollation Impostazioni del progetto, Regole di confronto 1033,CI {integer identificativo lingua}, {CI|CS}
AccessoFlussoFileNonTransazionato NON_TRANSACTED_ACCESS Impostazioni del database, accesso non transazionato FILESTREAM SPENTO {OFF|SOLO_LETTURA|COMPLETO}
NumericRoundAbort NUMERIC_ROUNDABORT Impostazioni del database, SET NUMERIC_ROUNDABORT Falso {Vero|Falso}
OutputPath Impostazioni di compilazione, percorso di output bin\Debug e bin\Release {string}
PageVerify PAGE_VERIFY Impostazioni del database, Operativo, Verifica della pagina NESSUNO {NESSUNO|RILEVAMENTO_PAGINA_STRAPPATA|CONTROLLA_SOMMA}
Parametrizzazione PARAMETERIZATION Impostazioni del database, parametrizzazione SEMPLICE {SEMPLICE|FORZATO}
QueryStoreCaptureMode QUERY_STORE (QUERY_CAPTURE_MODE) Impostazioni del database, Operativo, modalità di acquisizione del Query Store TUTTO {SPENTO|TUTTI|AUTOMATICO}
StatoDesideratoQueryStore QUERY_STORE (OPERATION_MODE) Impostazioni del database, operatività, modalità d'esercizio del query store OFF {SPENTO|LETTURA_SCRITTURA|SOLO_LETTURA}
IntervalloDiSvuotamentoDelQueryStore QUERY_STORE (DATA_FLUSH_INTERVAL_SECONDS) Impostazioni del database, Operativo, Intervallo di scaricamento dei dati dell'archivio query (secondi) 900 {integer}
QueryStoreIntervalLength QUERY_STORE (INTERVAL_LENGTH_MINUTES) Impostazioni del database, Operazionale, Intervallo di archiviazione delle query (minuti) 60 {integer}
QueryStoreMaxPlansPerQuery (Impostazioni per il massimo dei piani per query) QUERY_STORE (MAX_PLANS_PER_QUERY) Impostazioni del database, Operativo, Archivio delle query numero massimo di piani per query 200 {integer}
Dimensione massima di archiviazione di Query Store QUERY_STORE (MAX_STORAGE_SIZE_MB) Impostazioni del database, Operativo, Dimensione massima di archiviazione dell'archivio query (MB) 100 {integer}
QueryStoreStaleQueryThreshold QUERY_STORE (STALE_QUERY_THRESHOLD_DAYS) Impostazioni del database, Operative, Soglia di inattività delle query (giorni) 367 {integer}
Identificatore Citato QUOTED_IDENTIFIER Impostazioni del database, SET QUOTED_IDENTIFIER Vero {Vero|Falso}
istantanea di lettura confermata READ_COMMITTED_SNAPSHOT Impostazioni del database, Operazionali, Snapshot di lettura confermata Falso {Vero|Falso}
Recupero RECOVERY Impostazioni del database, Operativo, Ripristino PIENO {FULL|SIMPLE |BULK_LOGGED}
Trigger Ricorsivi Abilitati RECURSIVE_TRIGGERS Impostazioni del database con trigger ricorsivi abilitati Falso {Vero|Falso}
ServiceBrokerOption SERVICE_BROKER Impostazioni del database, opzioni di Service Broker DisableBroker {DisattivaBroker|AbilitaBroker|NuovoBroker|ErroreConversazioniBroker}
SuppressTSqlWarnings Impostazioni di compilazione, Elimina avvisi T-SQL (elenco delimitato da virgole di codici di avviso T-SQL) {string}
Periodo di Tempo Obiettivo per il Ripristino Impostazioni del database, Modalità operativa, Tempo stimato di ripristino (secondi) Specifica la frequenza dei checkpoint indiretti per ogni database. 60 {integer}
UnitàDiTempoObiettivoDiRecupero Impostazioni del database, operativo, tempo di recupero previsto SECONDI {MINUTI|SECONDI}
TreatTSqlWarningsAsErrors Impostazioni di compilazione, Considerare gli avvisi T-SQL come errori Falso {Vero|Falso}
Attendibile TRUSTWORTHY Impostazioni del database, Trustworthy Falso {Vero|Falso}
Data di Riferimento per Anni a Due Cifre TWO_DIGIT_YEAR_CUTOFF Impostazioni database, soglia anno a due cifre 2049 {integer}
Opzioni di Aggiornamento db_update_option Impostazioni del database, Opzioni di aggiornamento LETTURA_SCRITTURA {LETTURA_SCRITTURA|SOLO_LETTURA}
ConvalidaCasingSuIdentificatori Impostazione generale del progetto, verifica la maiuscolatura degli identificatori Vero {Vero|Falso}
  1. Il valore predefinito è diverso in base alle impostazioni dell'edizione del motore e del server.
  2. opzioni di configurazione con ambito database.
  3. AUTO viene impostato con il valore 0.
  4. Si applica solo come opzione CREATE DATABASE.

Contenuto correlato