dta - utilitàdta Utility

In questo argomento si applica a: SìSQL ServernonDatabase SQL di AzurenonAzure SQL Data Warehouse non Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse Il dta utilità è la versione del prompt dei comandi di ottimizzazione guidata motore di Database. The dta utility is the command prompt version of Database Engine Tuning Advisor. L'utilità dta è stata sviluppata per consentire l'utilizzo della funzionalità Ottimizzazione guidata motore di database in applicazioni e script.The dta utility is designed to allow you to use Database Engine Tuning Advisor functionality in applications and scripts.

In modo analogo a Ottimizzazione guidata motore di database, l'utilità dta analizza il carico di lavoro e propone strutture di progettazione fisica per ottimizzare le prestazioni a livello di server per il carico di lavoro specifico.Like Database Engine Tuning Advisor, the dta utility analyzes a workload and recommends physical design structures to improve server performance for that workload. Il carico di lavoro può essere una cache dei piani, un file o una tabella di traccia di SQL Server ProfilerSQL Server Profiler o uno script Transact-SQLTransact-SQL .The workload can be a plan cache, a SQL Server ProfilerSQL Server Profiler trace file or table, or a Transact-SQLTransact-SQL script. Le strutture di progettazione fisica includono indici, viste indicizzate e schemi di partizionamento.Physical design structures include indexes, indexed views, and partitioning. Dopo aver analizzato un carico di lavoro, l'utilità dta visualizza un'indicazione di progettazione fisica dei database e quindi genera lo script necessario per implementare tale indicazione.After analyzing a workload, the dta utility produces a recommendation for the physical design of databases and can generate the necessary script to implement the recommendation. I carichi di lavoro possono essere specificati dal prompt dei comandi con gli argomenti -if o -it .Workloads can be specified from the command prompt with the -if or the -it argument. È anche possibile specificare un file di input XML dal prompt dei comandi con l'argomento -ix .You can also specify an XML input file from the command prompt with the -ix argument. In quest'ultimo caso, il carico di lavoro viene specificato nel file di input XML.In that case, the workload is specified in the XML input file.

SintassiSyntax


dta  
[ -? ] |  
[  
      [ -S server_name[ \instance ] ]  
      { { -U login_id [-P password ] } | –E  }  
      { -D database_name [ ,...n ] }  
      [ -d database_name ]   
      [ -Tl table_list | -Tf table_list_file ]  
      { -if workload_file | -it workload_trace_table_name  |   
        -ip | -iq }  
      { -ssession_name | -IDsession_ID }  
      [ -F ]  
      [ -of output_script_file_name ]  
      [ -or output_xml_report_file_name ]  
      [ -ox output_XML_file_name ]  
      [ -rl analysis_report_list [ ,...n ] ]  
      [ -ix input_XML_file_name ]  
      [ -A time_for_tuning_in_minutes ]  
      [ -n number_of_events ]
      [ -I time_window_in_hours ]  
      [ -m minimum_improvement ]  
      [ -fa physical_design_structures_to_add ]  
      [ -fi filtered_indexes]  
      [ -fc columnstore_indexes]  
      [ -fp partitioning_strategy ]  
      [ -fk keep_existing_option ]  
      [ -fx drop_only_mode ]  
      [ -B storage_size ]  
      [ -c max_key_columns_in_index ]  
      [ -C max_columns_in_index ]  
      [ -e | -e tuning_log_name ]  
      [ -N online_option]  
      [ -q ]  
      [ -u ]  
      [ -x ]  
      [ -a ]  
]  

ArgomentiArguments

-?-?
Visualizza le informazioni sull'utilizzo.Displays usage information.

-A time_for_tuning_in_minutes-A time_for_tuning_in_minutes
Specifica il limite di tempo di ottimizzazione espresso in minuti.Specifies the tuning time limit in minutes. dta utilizza l'intervallo di tempo specificato per ottimizzare il carico di lavoro e generare uno script in base alle indicazioni relative alla modifica della progettazione fisica.dta uses the specified amount of time to tune the workload and generate a script with the recommended physical design changes. Per impostazione predefinita, dta utilizza un tempo di ottimizzazione pari a 8 ore.By default dta assumes a tuning time of 8 hours. Se si specifica 0, viene impostato un tempo di ottimizzazione illimitato.Specifying 0allows unlimited tuning time. È possibile che l'utilitàdta termini l'ottimizzazione dell'intero carico di lavoro prima che sia trascorso il limite di tempo specificato.dta might finish tuning the entire workload before the time limit expires. Per garantire l'ottimizzazione dell'intero carico di lavoro, è tuttavia consigliabile specificare un tempo di ottimizzazione illimitato (-A 0).However, to make sure that the entire workload is tuned, we recommend that you specify unlimited tuning time (-A 0).

-a-a
Ottimizza il carico di lavoro e applica l'indicazione senza richiedere conferma all'utente.Tunes workload and applies the recommendation without prompting you.

-B storage_size-B storage_size
Specifica lo spazio massimo, espresso in megabyte, che può essere utilizzato dall'indice e dal partizionamento consigliati.Specifies the maximum space in megabytes that can be consumed by the recommended index and partitioning. Se si ottimizzano più database, per il calcolo dello spazio vengono considerate le indicazioni per tutti i database.When multiple databases are tuned, recommendations for all databases are considered for the space calculation. Per impostazione predefinita, dta utilizza il valore più basso delle dimensioni dello spazio di archiviazione riportate di seguito:By default, dta assumes the smaller of the following storage sizes:

  • Valore triplo della dimensione corrente dei dati non elaborati, incluse le dimensioni totali degli heap e degli indici cluster nelle tabelle del database.Three times the current raw data size, which includes the total size of heaps and clustered indexes on tables in the database.

  • Lo spazio disponibile su tutte le unità disco collegate sommato alle dimensioni dei dati non elaborati.The free space on all attached disk drives plus the raw data size.

    Le dimensioni dello spazio di archiviazione predefinite non includono gli indici non cluster e le viste indicizzate.The default storage size does not include nonclustered indexes and indexed views.

    -C max_columns_in_index-C max_columns_in_index
    Specifica il numero massimo di colonne negli indici proposto da dta .Specifies the maximum number of columns in indexes that dta proposes. Il valore massimo è 1024.The maximum value is 1024. Per impostazione predefinita, questo argomento è impostato su 16.By default, this argument is set to 16.

    -c max_key_columns_in_index-c max_key_columns_in_index
    Specifica il numero massimo di colonne chiave negli indici proposto da dta .Specifies the maximum number of key columns in indexes that dta proposes. Il valore predefinito è 16, ovvero il valore massimo consentito.The default value is 16, the maximum value allowed. Indta viene inoltre presa in considerazione la creazione di indici con colonne incluse.dta also considers creating indexes with included columns. Gli indici con colonne incluse indicati dall'utilità potrebbero superare il numero di colonne specificato in questo argomento.Indexes recommended with included columns may exceed the number of columns specified in this argument.

    -D database_name-D database_name
    Specifica il nome di ogni database da ottimizzare.Specifies the name of each database that is to be tuned. Il primo database è il database predefinito.The first database is the default database. Per specificare più database, separare i relativi nomi con una virgola, ad esempio:You can specify multiple databases by separating the database names with commas, for example:

dta –D database_name1, database_name2...  

In alternativa, è possibile specificare più database utilizzando l'argomento –D per ogni nome di database, ad esempio:Alternatively, you can specify multiple databases by using the –D argument for each database name, for example:

dta –D database_name1 -D database_name2... n  

L'argomento -D è obbligatorio.The -D argument is mandatory. Se si omette l'argomento -d , dta si connette inizialmente al database specificato nella prima clausola USE database_name del carico di lavoro.If the -d argument has not been specified, dta initially connects to the database that is specified with the first USE database_name clause in the workload. Se non è presente alcuna clausola USE database_name esplicita nel carico di lavoro, è necessario usare l'argomento -d .If there is not explicit USE database_name clause in the workload, you must use the -d argument.

Se, ad esempio, un carico di lavoro non include una clausola USE database_name esplicita e si utilizza il comando dta seguente, non verrà generata alcuna indicazione.For example, if you have a workload that contains no explicit USE database_name clause, and you use the following dta command, a recommendation will not be generated:

dta -D db_name1, db_name2...  

Se invece si usa lo stesso carico di lavoro e si specifica il comando dta seguente con l'argomento -d , viene generata un'indicazione:But if you use the same workload, and use the following dta command that uses the -d argument, a recommendation will be generated:

dta -D db_name1, db_name2 -d db_name1  

-d database_name-d database_name
Specifica il primo database al quale si connette dta per ottimizzare un carico di lavoro.Specifies the first database to which dta connects when tuning a workload. Per questo argomento è possibile specificare solo un database.Only one database can be specified for this argument. Esempio:For example:

dta -d AdventureWorks2012 ...  

Se vengono specificati più nomi di database, dta restituisce un errore.If multiple database names are specified, then dta returns an error. L'argomento -d è facoltativo.The -d argument is optional.

Se si utilizza un file di input XML, è possibile specificare il primo database al quale l'utilità dta si connette usando l'elemento DatabaseToConnect che si trova sotto l'elemento TuningOptions .If you are using an XML input file, you can specify the first database to which dta connects by using the DatabaseToConnect element that is located under the TuningOptions element. Per altre informazioni, vedere Database Engine Tuning Advisor.For more information, see Database Engine Tuning Advisor.

In caso di ottimizzazione di un solo database, l'argomento -d è caratterizzato da una funzionalità simile all'argomento -d dell'utilità sqlcmd , ma non esegue l'istruzione USE database_name .If you are tuning only one database, the -d argument provides functionality that is similar to the -d argument in the sqlcmd utility, but it does not execute the USE database_name statement. Per altre informazioni, vedere sqlcmd Utility.For more information, see sqlcmd Utility.

-E-E
Utilizza una connessione trusted anziché richiedere una password.Uses a trusted connection instead of requesting a password. È necessario usare l'argomento -E o -U , che specifica un ID di accesso.Either the -E argument or the -U argument, which specifies a login ID, must be used.

-e tuning_log_name-e tuning_log_name
Specifica il nome della tabella o del file in cui dta registra gli eventi che non possono essere ottimizzati.Specifies the name of the table or file where dta records events that it could not tune. La tabella viene creata nel server in cui viene eseguita l'ottimizzazione.The table is created on the server where the tuning is performed.

Se si usa una tabella, specificarne il nome in formato [database_name].[owner_name].table_name.If a table is used, specify its name in the format: [database_name].[owner_name].table_name. Nella tabella seguente sono riportati i valori predefiniti per ogni parametro.The following table shows the default values for each parameter:

ParametroParameter Valore predefinitoDefault value DettagliDetails
database_namedatabase_name database_name specificato con l'opzione –Ddatabase_name specified with the –D option
owner_nameowner_name dbodbo owner_name deve essere dbo.owner_name must be dbo. Se si specifica un qualsiasi altro valore, l'esecuzione di dta ha esito negativo e viene restituito un errore.If any other value is specified, then dta execution fails and it returns an error.
table_nametable_name NessunoNone

Se si utilizza un file, specificare l'estensione xml,If a file is used, specify .xml as its extension. ad esempio TuningLog.xml.For example, TuningLog.xml.

Nota

L'utilità dta non elimina il contenuto delle tabelle del log di ottimizzazione specificate dall'utente se la sessione viene eliminata.The dta utility does not delete the contents of user-specified tuning log tables if the session is deleted. Quando si esegue l'ottimizzazione di carichi di lavoro molto estesi, è consigliabile specificare una tabella per il log di ottimizzazione.When tuning very large workloads, we recommend that a table be specified for the tuning log. Poiché l'ottimizzazione di carichi di lavoro estesi può generare log di ottimizzazione estesi, è possibile eliminare le sessioni molto più velocemente in caso di utilizzo di una tabella.Since tuning large workloads can result in large tuning logs, the sessions can be deleted much faster when a table is used.

-F-F
Consente a dta di sovrascrivere un file di output esistente.Permits dta to overwrite an existing output file. Se esiste già un file di output con lo stesso nome e si omette -F , dtarestituisce un errore.If an output file with the same name already exists and -F is not specified, dtareturns an error. È possibile usare -F con -of, -oroppure -ox.You can use -F with -of, -or, or -ox.

-fa physical_design_structures_to_add-fa physical_design_structures_to_add
Specifica i tipi di strutture di progettazione fisica che dta deve includere nell'indicazione.Specifies what types of physical design structures dta should include in the recommendation. Nella tabella seguente sono riportati e descritti i valori che è possibile specificare per questo argomento.The following table lists and describes the values that can be specified for this argument. Se non si specifica alcun valore, dta usa l'argomento predefinito -faIDX.When no value is specified, dta uses the default -faIDX.

ValoreValue DescrizioneDescription
IDX_IVIDX_IV Indici e viste indicizzate.Indexes and indexed views.
IDXIDX Solo indici.Indexes only.
IVIV Solo viste indicizzate.Indexed views only.
NCL_IDXNCL_IDX Solo indici non cluster.Nonclustered indexes only.

-fi-fi
Specifica gli indici filtrati da considerare per le nuove indicazioni.Specifies that filtered indexes be considered for new recommendations. Per altre informazioni, vedere Create Filtered Indexes.For more information, see Create Filtered Indexes.

-fc-fc
Specifica che gli indici columnstore deve essere considerata per le nuove indicazioni.Specifies that columnstore indexes be considered for new recommendations. DTA prenderà in considerazione entrambi gli indici columnstore cluster e non cluster.DTA will consider both clustered and non-clustered columnstore indexes. Per ulteriori informazioni, vedereFor more information, see
Indicazioni relative agli indici ColumnStore nel Database di ottimizzazione guidata motore (DTA).Columnstore index recommendations in Database Engine Tuning Advisor (DTA). ||
|-|
|Si applica a: SQL Server 2016SQL Server 2016 tramite SQL Server 2017SQL Server 2017.Applies to: SQL Server 2016SQL Server 2016 through SQL Server 2017SQL Server 2017.|

-fk keep_existing_option-fk keep_existing_option
Specifica le strutture di progettazione fisica esistenti che dta deve conservare durante la generazione dell'indicazione.Specifies what existing physical design structures dta must retain when generating its recommendation. Nella tabella seguente sono riportati e descritti i valori che è possibile specificare per questo argomento.The following table lists and describes the values that can be specified for this argument:

ValoreValue DescrizioneDescription
NessunoNONE Nessuna struttura esistente.No existing structures
ALLALL Tutte le strutture esistenti.All existing structures
ALIGNEDALIGNED Tutte le strutture con partizionamento allineato.All partition-aligned structures.
CL_IDXCL_IDX Tutti gli indici cluster nelle tabelle.All clustered indexes on tables
IDXIDX Tutti gli indici cluster e non cluster nelle tabelle.All clustered and nonclustered indexes on tables

-fp partitioning_strategy-fp partitioning_strategy
Specifica se le nuove strutture di progettazione fisica, ovvero indici e viste indicizzate, proposte da dta devono essere partizionate e definisce la modalità di partizionamento.Specifies whether new physical design structures (indexes and indexed views) that dta proposes should be partitioned, and how they should be partitioned. Nella tabella seguente sono riportati e descritti i valori che è possibile specificare per questo argomento.The following table lists and describes the values that can be specified for this argument:

ValoreValue DescrizioneDescription
NessunoNONE Nessun partizionamento.No partitioning
FULLFULL Partizionamento completo (scegliere questo valore per ottimizzare le prestazioni).Full partitioning (choose to enhance performance)
ALIGNEDALIGNED Solo partizionamento allineato (scegliere questo valore per ottimizzare la gestione).Aligned partitioning only (choose to enhance manageability)

Se si specifica ALIGNED, nell'indicazione generata da dta ogni indice proposto viene partizionato esattamente nello stesso modo della tabella sottostante per la quale è stato definito l'indice.ALIGNED means that in the recommendation generated by dta every proposed index is partitioned in exactly the same way as the underlying table for which the index is defined. Gli indici non cluster in una vista indicizzata sono allineati in base alla vista indicizzata.Nonclustered indexes on an indexed view are aligned with the indexed view. Per questo argomento è possibile specificare solo un valore.Only one value can be specified for this argument. Il valore predefinito è -fpNONE.The default is -fpNONE.

-fx drop_only_mode-fx drop_only_mode
Specifica che dta prende in considerazione esclusivamente l'eliminazione delle strutture di progettazione fisica esistenti.Specifies that dta only considers dropping existing physical design structures. Non verranno considerate le nuove strutture di progettazione fisica.No new physical design structures are considered. Se si specifica questa opzione, dta valuta l'utilità delle strutture di progettazione fisica esistenti e propone di eliminare le strutture utilizzate meno di frequente.When this option is specified, dta evaluates the usefulness of existing physical design structures and recommends dropping seldom used structures. Questo argomento non utilizza alcun valoreThis argument takes no values. e non può essere usato in combinazione con gli argomenti -fa, -fpo -fk ALLIt cannot be used with the -fa, -fp, or -fk ALL arguments

-ID session_ID-ID session_ID
Specifica l'identificatore numerico per la sessione di ottimizzazione.Specifies a numerical identifier for the tuning session. Se omesso, dta genera un numero di identificazione.If not specified, then dta generates an ID number. È possibile utilizzare questo identificatore per visualizzare le informazioni relative alle sessioni di ottimizzazione correnti.You can use this identifier to view information for existing tuning sessions. Se per -IDnon si specifica alcun valore, è necessario specificare un nome di sessione usando -s.If you do not specify a value for -ID, then a session name must be specified with -s.

-ip-ip
Specifica che la cache dei piani deve essere utilizzata come carico di lavoro.Specifies that the plan cache be used as the workload. Vengono analizzati i primi 1.000 eventi della cache dei piani per i database selezionati in modo esplicito.The top 1,000 plan cache events for explicitly selected databases are analyzed. Questo valore può essere modificato tramite l'opzione –n .This value can be changed using the –n option.

-iq-iq
Specifica che l'archivio Query utilizzabile come carico di lavoro.Specifies that the Query Store be used as the workload. Vengono analizzati i primi 1.000 eventi dall'archivio Query per i database selezionati in modo esplicito.The top 1,000 events from the Query Store for explicitly selected databases are analyzed. Questo valore può essere modificato tramite l'opzione –n .This value can be changed using the –n option. Vedere archivio Query e ottimizzazione di Database con carico di lavoro dall'archivio Query per ulteriori informazioni.See Query Store and Tuning Database Using Workload from Query Store for more information. ||
|-|
|Si applica a: SQL Server 2016SQL Server 2016 tramite SQL Server 2017SQL Server 2017.Applies to: SQL Server 2016SQL Server 2016 through SQL Server 2017SQL Server 2017.|

-if workload_file-if workload_file
Specifica il percorso e il nome del file del carico di lavoro da utilizzare come input per l'ottimizzazione.Specifies the path and name of the workload file to use as input for tuning. Il file deve essere in formato trc (file di traccia di SQL Server Profiler), sql (file SQL) oppure log (file di traccia di SQL ServerSQL Server ).The file must be in one of these formats: .trc (SQL Server Profiler trace file), .sql (SQL file), or .log ( SQL ServerSQL Server trace file). È inoltre necessario specificare un file o una tabella del carico di lavoro.Either one workload file or one workload table must be specified.

-it workload_trace_table_name-it workload_trace_table_name
Specifica il nome della tabella contenente la traccia del carico di lavoro per l'ottimizzazione.Specifies the name of a table containing the workload trace for tuning. Il nome viene specificato in formato [database_name].[owner_name].table_name.The name is specified in the format: [database_name].[owner_name].table_name.

Nella tabella seguente sono riportati i valori predefiniti per ogni parametro.The following table shows the default values for each:

ParametroParameter Valore predefinitoDefault value
database_namedatabase_name database_name specificato con l'opzione –D .database_name specified with –D option.
owner_nameowner_name dbodbo.
table_nametable_name nessuna.None.

Nota

owner_name deve essere dbo.owner_name must be dbo. Se viene specificato un altro valore, l'esecuzione di dta ha esito negativo e viene restituito un errore.If any other value is specified, execution of dta fails and an error is returned. È inoltre necessario specificare una tabella o un file del carico di lavoro.Also note that either one workload table or one workload file must be specified.

-ix input_XML_file_name-ix input_XML_file_name
Specifica il nome del file XML contenente le informazioni di input di dta .Specifies the name of the XML file containing dta input information. Tale file deve essere un documento XML valido conforme a DTASchema.xsd.This must be a valid XML document conforming to DTASchema.xsd. Gli argomenti in conflitto specificati nel prompt dei comandi per le opzioni di ottimizzazione hanno la priorità sul valore corrispondente incluso in questo file XML.Conflicting arguments specified from the command prompt for tuning options override the corresponding value in this XML file. L'unica eccezione è rappresentata dal caso in cui una configurazione definita dall'utente venga specificata in modalità di valutazione nel file di input XML.The only exception is if a user-specified configuration is entered in the evaluate mode in the XML input file. Se, ad esempio, si specifica una configurazione nell'elemento Configuration del file di input XML e si specifica anche l'elemento EvaluateConfiguration come una delle opzioni di ottimizzazione, le opzioni di ottimizzazione specificate nel file di input XML avranno la priorità su qualsiasi opzione di ottimizzazione specificata nel prompt dei comandi.For example, if a configuration is entered in the Configuration element of the XML input file and the EvaluateConfiguration element is also specified as one of the tuning options, the tuning options specified in the XML input file will override any tuning options entered from the command prompt.

-m minimum_improvement-m minimum_improvement
Specifica la percentuale minima di miglioramento che la configurazione consigliata deve soddisfare.Specifies the minimum percentage of improvement that the recommended configuration must satisfy.

-N online_option-N online_option
Specifica se le strutture di progettazione fisica vengono create online.Specifies whether physical design structures are created online. Nella tabella seguente sono riportati e descritti i valori che è possibile specificare per questo argomento.The following table lists and describes the values you can specify for this argument:

ValoreValue DescrizioneDescription
OFFOFF Le strutture di progettazione fisica indicate non possono essere create online.No recommended physical design structures can be created online.
ONON Tutte le strutture di progettazione fisica indicate possono essere create online.All recommended physical design structures can be created online.
MIXEDMIXED Ottimizzazione guidata motore di database indica le strutture di progettazione fisica che possono essere create online quando possibile.Database Engine Tuning Advisor attempts to recommend physical design structures that can be created online when possible.

Se gli indici vengono creati online, ONLINE = ON viene aggiunto alla relativa definizione di oggetto.If indexes are created online, ONLINE = ON is appended to its object definition.

-n number_of_events-n number_of_events
Specifica il numero di eventi nel carico di lavoro che dta deve ottimizzare.Specifies the number of events in the workload that dta should tune. Se si specifica questo argomento e il carico di lavoro è un file di traccia contenente informazioni sulla durata, dta ottimizza gli eventi in base all'ordine decrescente di durata.If this argument is specified and the workload is a trace file that contains duration information, then dta tunes events in decreasing order of duration. Questo argomento risulta utile per confrontare due configurazioni di strutture di progettazione fisica.This argument is useful to compare two configurations of physical design structures. Per confrontare due configurazioni, per entrambe le configurazioni specificare lo stesso numero di eventi da ottimizzare e quindi un tempo di ottimizzazione illimitato nel modo illustrato di seguito:To compare two configurations, specify the same number of events to be tuned for both configurations and then specify an unlimited tuning time for both also as follows:

dta -n number_of_events -A 0  

In questo caso, è importante specificare un tempo di ottimizzazione illimitato (-A 0).In this case, it is important to specify an unlimited tuning time (-A 0). In caso contrario, Ottimizzazione guidata motore di database utilizza il tempo di ottimizzazione predefinito pari a 8 ore.Otherwise, Database Engine Tuning Advisor assumes an 8 hour tuning time by default.

-I time_window_in_hours -I time_window_in_hours
Specifica l'intervallo di tempo (in ore) quando deve avere eseguita una query per essere considerato come DTA per l'ottimizzazione quando si utilizza -iq opzione (carico di lavoro dall'archivio Query).Specifies the time window (in hours) when a query must have executed for it to be considered by DTA for tuning when using -iq option (Workload from Query Store).

dta -iq -I 48  

In questo caso, DTA verrà usare archivio Query come origine del carico di lavoro e prendere in considerazione solo le query eseguite con le ultime 48 ore.In this case, DTA will use Query Store as the source of workload and only consider queries that have executed with the past 48 hours.
||
|-|
|Si applica a: SQL Server 2016SQL Server 2016 tramite SQL Server 2017SQL Server 2017.Applies to: SQL Server 2016SQL Server 2016 through SQL Server 2017SQL Server 2017.|

-of output_script_file_name-of output_script_file_name
Specifica che dta scrive l'indicazione sotto forma di script Transact-SQLTransact-SQL nel nome file e nella destinazione specificati.Specifies that dta writes the recommendation as a Transact-SQLTransact-SQL script to the file name and destination specified.

È possibile usare -F con questa opzione.You can use -F with this option. Assicurarsi che il nome file sia univoco, soprattutto se vengono specificate anche le opzioni -or e -ox.Make sure that the file name is unique, especially if you are also using -or and -ox.

-or output_xml_report_file_name-or output_xml_report_file_name
Specifica che dta scrive l'indicazione in un report di output in formato XML.Specifies that dta writes the recommendation to an output report in XML. Se si specifica un nome di file, le indicazioni vengono scritte in tale destinazione.If a file name is supplied, then the recommendations are written to that destination. In caso contrario, dta utilizza il nome di sessione per generare il nome file e lo scrive nella directory corrente.Otherwise, dta uses the session name to generate the file name and writes it to the current directory.

È possibile usare -F con questa opzione.You can use -F with this option. Assicurarsi che il nome file sia univoco, soprattutto se vengono specificate anche le opzioni -of e -ox.Make sure that the file name is unique, especially if you are also using -of and -ox.

-ox output_XML_file_name-ox output_XML_file_name
Specifica che dta scrive l'indicazione sotto forma di file XML nel nome file e nella destinazione specificati.Specifies that dta writes the recommendation as an XML file to the file name and destination supplied. Assicurarsi che Ottimizzazione guidata motore di database disponga delle autorizzazioni di scrittura adeguate per la directory di destinazione.Ensure that Database Engine Tuning Advisor has permissions to write to the destination directory.

È possibile usare -F con questa opzione.You can use -F with this option. Assicurarsi che il nome file sia univoco, soprattutto se vengono specificate anche le opzioni -of e -or.Make sure that the file name is unique, especially if you are also using -of and -or.

-P password-P password
Specifica la password per l'ID di accesso.Specifies the password for the login ID. Se si omette questa opzione, dta richiede una password.If this option is not used, dta prompts for a password.

-q-q
Imposta la modalità non interattiva.Sets quiet mode. Le informazioni, incluse quelle relative alle intestazioni e allo stato, non vengono scritte nella console.No information is written to the console, including progress and header information.

-rl analysis_report_list-rl analysis_report_list
Specifica l'elenco dei report di analisi da generare.Specifies the list of analysis reports to generate. Nella tabella seguente sono riportati i valori che è possibile specificare per questo argomento.The following table lists the values that can be specified for this argument:

ValoreValue ReportReport
ALLALL Tutti i report di analisiAll analysis reports
STMT_COSTSTMT_COST Report costo istruzioniStatement cost report
EVT_FREQEVT_FREQ Report frequenza eventiEvent frequency report
STMT_DETSTMT_DET Report dettagli istruzioniStatement detail report
CUR_STMT_IDXCUR_STMT_IDX Report relazioni istruzioni-indici (configurazione corrente)Statement-index relations report (current configuration)
REC_STMT_IDXREC_STMT_IDX Report relazioni istruzioni-indici (configurazione consigliata)Statement-index relations report (recommended configuration)
STMT_COSTRANGESTMT_COSTRANGE Report intervallo di costi istruzioneStatement cost range report
CUR_IDX_USAGECUR_IDX_USAGE Report utilizzo indici (configurazione corrente)Index usage report (current configuration)
REC_IDX_USAGEREC_IDX_USAGE Report utilizzo indici (configurazione consigliata)Index usage report (recommended configuration)
CUR_IDX_DETCUR_IDX_DET Report dettagli indici (configurazione corrente)Index detail report (current configuration)
REC_IDX_DETREC_IDX_DET Report dettagli indici (configurazione consigliata)Index detail report (recommended configuration)
VIW_TABVIW_TAB Report relazioni viste-tabelleView-table relations report
WKLD_ANLWKLD_ANL Report analisi carico di lavoroWorkload analysis report
DB_ACCESSDB_ACCESS Report accessi a databaseDatabase access report
TAB_ACCESSTAB_ACCESS Report accessi a tabelleTable access report
COL_ACCESSCOL_ACCESS Report accessi a colonneColumn access report

Per specificare più report, separare i valori utilizzando la virgola, ad esempio:Specify multiple reports by separating the values with commas, for example:

... -rl EVT_FREQ, VIW_TAB, WKLD_ANL ...  

-S server_name[ \instance]-S server_name[ \instance]
Specifica il nome del computer e dell'istanza di SQL ServerSQL Server a cui connettersi.Specifies the name of the computer and instance of SQL ServerSQL Server to connect to. Se si omette server_name , dta si connette all'istanza predefinita di SQL ServerSQL Server nel computer locale.If no server_name is specified, dta connects to the default instance of SQL ServerSQL Server on the local computer. Questa opzione è obbligatoria in caso di connessione a un'istanza denominata oppure quando si esegue dta da un computer remoto in rete.This option is required when connecting to a named instance or when executing dta from a remote computer on the network.

-s session_name-s session_name
Specifica il nome della sessione di ottimizzazione.Specifies the name of the tuning session. Questa opzione è obbligatoria se non si specifica -ID .This is required if -ID is not specified.

-Tf table_list_file-Tf table_list_file
Specifica il nome del file contenente l'elenco di tabelle da ottimizzare.Specifies the name of a file containing a list of tables to be tuned. Ogni tabella inclusa nel file deve iniziare su una nuova riga.Each table listed within the file should begin on a new line. Le tabelle devono essere qualificate con nomi di tabella composti da tre parti, ad esempio AdventureWorks2012.HumanResources.Department.Table names should be qualified with three-part naming, for example, AdventureWorks2012.HumanResources.Department. In alternativa, per richiamare la funzionalità di ridimensionamento delle tabelle, il nome di una tabella esistente può essere seguito da un numero che indica il numero previsto di righe nella tabella.Optionally, to invoke the table-scaling feature, the name of an existing table can be followed by a number indicating the projected number of rows in the table. Ottimizzazione guidata motore di database utilizza il numero previsto di righe durante l'ottimizzazione o la valutazione delle istruzioni nel carico di lavoro che fanno riferimento a queste tabelle.Database Engine Tuning Advisor takes into consideration the projected number of rows while tuning or evaluating statements in the workload that reference these tables. Possono essere presenti uno o più spazi tra il numero di number_of_rows e table_name.Note that there can be one or more spaces between the number_of_rows count and the table_name.

Il formato di file per table_list_fileè:This is the file format for table_list_file:

database_name.[schema_name].table_name [number_of_rows]database_name.[schema_name].table_name [number_of_rows]

database_name.[schema_name].table_name [number_of_rows]database_name.[schema_name].table_name [number_of_rows]

database_name.[schema_name].table_name [number_of_rows]database_name.[schema_name].table_name [number_of_rows]

Questo argomento rappresenta un'alternativa all'immissione di un elenco di tabelle al prompt dei comandi (-Tl).This argument is an alternative to entering a table list at the command prompt (-Tl). Non usare un file contenente un elenco di tabelle (-Tf) se si specifica -Tl.Do not use a table list file (-Tf) if you are using -Tl. Se vengono utilizzati entrambi gli argomenti, l'esecuzione di dta ha esito negativo e viene restituito un errore.If both arguments are used, dta fails and returns an error.

Se si omettono gli argomenti -Tf e -Tl , tutte le tabelle utente nei database specificati verranno considerate per l'ottimizzazione.If the -Tf and -Tl arguments are omitted, all user tables in the specified databases are considered for tuning.

-Tl table_list-Tl table_list
Specifica al prompt dei comandi un elenco di tabelle da ottimizzare.Specifies at the command prompt a list of tables to be tuned. Per separare i nomi di tabella, utilizzare la virgola.Place commas between table names to separate them. Se con l'argomento -D viene specificato solo un database, non è necessario che i nomi delle tabelle vengano qualificati con un nome di database.If only one database is specified with the -D argument, then table names do not need to be qualified with a database name. In caso contrario, per ogni tabella sarà necessario specificare il nome completo nel formato: database_name.schema_name.table_name .Otherwise, the fully qualified name in the format: database_name.schema_name.table_name is required for each table.

Questo argomento rappresenta un'alternativa all'utilizzo di un file contenente un elenco di tabelle (-Tf).This argument is an alternative to using a table list file (-Tf). Se vengono usati entrambi gli argomenti -Tl e -Tf , l'esecuzione di dta non riesce e viene restituito un errore.If both -Tl and -Tf are used, dta fails and returns an error.

-U login_id-U login_id
Specifica l'ID di accesso utilizzato per connettersi a SQL ServerSQL Server.Specifies the login ID used to connect to SQL ServerSQL Server.

-u-u
Avvia l'interfaccia utente di Ottimizzazione guidata motore di database.Launches the Database Engine Tuning Advisor GUI. Tutti i parametri vengono considerati come impostazioni iniziali dell'interfaccia utente.All parameters are treated as the initial settings for the user interface.

-x-x
Avvia la sessione di ottimizzazione e chiude l'utilità.Starts tuning session and exits.

OsservazioniRemarks

Premere CTRL+C una volta per arrestare la sessione di ottimizzazione e generare le indicazioni in base all'analisi completata da dta fino a quel momento.Press CTRL+C once to stop the tuning session and generate recommendations based on the analysis dta has completed up to this point. Verrà richiesto di decidere se generare le indicazioni o meno.You will be prompted to decide whether you want to generate recommendations or not. Premere nuovamente CTRL+C per arrestare la sessione di ottimizzazione senza generare le indicazioni.Press CTRL+C again to stop the tuning session without generating recommendations.

EsempiExamples

A. Ottimizzare un carico di lavoro che include indici e viste indicizzate nell'indicazioneA. Tune a workload that includes indexes and indexed views in its recommendation

Questo esempio usa una connessione sicura (-E) per connettersi al database tpcd1G in MyServer per analizzare un carico di lavoro e creare indicazioni.This example uses a secure connection (-E) to connect to the tpcd1G database on MyServer to analyze a workload and create recommendations. Scrive l'output in un file di script denominato script.sql.It writes the output to a script file named script.sql. Se script.sql esiste già, l'utilità dta sovrascriverà il file in quanto è stato specificato l'argomento -F .If script.sql already exists, then dta will overwrite the file because the -F argument has been specified. La sessione di ottimizzazione viene eseguita per un periodo illimitato di tempo per garantire l'analisi completa del carico di lavoro (-A 0).The tuning session runs for an unlimited length of time to ensure a complete analysis of the workload (-A 0). L'indicazione deve fornire un miglioramento minimo del 5% (-m 5).The recommendation must provide a minimum improvement of 5% (-m 5). dta deve includere indici e viste indicizzate nell'indicazione finale (-fa IDX_IV).dta should include indexes and indexed views in its final recommendation (-fa IDX_IV).

dta –S MyServer –E -D tpcd1G -if tpcd_22.sql -F –of script.sql –A 0 -m 5 -fa IDX_IV  

B. Limitare l'utilizzo del discoB. Limit disk use

Nell'esempio seguente viene limitata la dimensione totale del database, che include i dati non elaborati e gli indici aggiuntivi, a 3 GB (-B 3000) e l'output viene reindirizzato su d:\result_dir\script1.sql.This example limits the total database size, which includes the raw data and the additional indexes, to 3 gigabytes (GB) (-B 3000) and directs the output to d:\result_dir\script1.sql. Il tempo di esecuzione non è maggiore di 1 ora (-A 60).It runs for no more than 1 hour (-A 60).

dta –D tpcd1G –if tpcd_22.sql -B 3000 –of "d:\result_dir\script1.sql" –A 60  

C. Limitare il numero di query ottimizzateC. Limit the number of tuned queries

Nell'esempio seguente il numero di query lette dal file orders_wkld.sql viene limitato a un massimo di 10 (-n 10) oppure il tempo di esecuzione viene limitato a 15 minuti (-A 15), a seconda di quale dei due eventi si verifica per primo.This example limits the number of queries read from the file orders_wkld.sql to a maximum of 10 (-n 10) and runs for 15 minutes (-A 15), whichever comes first. Per assicurarsi che tutte e 10 le query vengano ottimizzate, specificare un tempo di ottimizzazione illimitato tramite -A 0.To make sure that all 10 queries are tuned, specify an unlimited tuning time with -A 0. Se il fattore tempo è rilevante, specificare un limite di tempo adeguato impostando il numero di minuti disponibili per l'ottimizzazione con l'argomento -A come illustrato nell'esempio seguente.If time is important, specify an appropriate time limit by specifying the number of minutes that are available for tuning with the -A argument as shown in this example.

dta –D orders –if orders_wkld.sql –of script.sql –A 15 -n 10  

D. Ottimizzazione di tabelle specifiche elencate in un fileD. Tune specific tables listed in a file

Questo esempio mostra l'utilizzo di table_list_file , ovvero l'argomento -Tf .This example demonstrates the use of table_list_file (the -Tf argument). Il contenuto del file table_list.txt è riportato di seguito.The contents of the file table_list.txt are as follows:

AdventureWorks2012.Sales.Customer  100000  
AdventureWorks2012.Sales.Store  
AdventureWorks2012.Production.Product  2000000  

Il contenuto di table_list.txt determina quanto segue:The contents of table_list.txt specifies that:

  • Verranno ottimizzate solo le tabelle Customer, Storee Product .Only the Customer, Store, and Product tables in the database should be tuned.

  • Si presuppone che il numero di righe delle tabelle Customer e Product sia rispettivamente 100.000 e 2.000.000.The number of rows in the Customer and Product tables are assumed to be 100,000 and 2,000,000, respectively.

  • Si presuppone inoltre che il numero di righe della tabella Store sia il numero corrente di righe di questa tabella.The number of rows in Store are assumed to be the current number of rows in the table.

    Possono essere presenti uno o più spazi tra il numero totale delle righe e il nome precedente della tabella in table_list_file.Note that there can be one or more spaces between the number of rows count and the preceding table name in the table_list_file.

    La durata dell'ottimizzazione è pari a 2 ore (-A 120) e l'output viene scritto in un file XML (-ox XMLTune.xml).The tuning time is 2 hours (-A 120) and the output is written to an XML file (-ox XMLTune.xml).

dta –D pubs –if pubs_wkld.sql –ox XMLTune.xml –A 120 –Tf table_list.txt  

Vedere ancheSee Also

Guida di riferimento alle utilità del prompt dei comandi (Motore di database) Command Prompt Utility Reference (Database Engine)
Ottimizzazione guidata motore di databaseDatabase Engine Tuning Advisor