utilitário dtadta Utility

O utilitário dta é a versão do prompt de comando do Orientador de Otimização do Mecanismo de Banco de Dados.The dta utility is the command prompt version of Database Engine Tuning Advisor. O utilitário dta foi projetado para permitir o uso da funcionalidade do Orientador de Otimização do Mecanismo de Banco de Dados em aplicativos e scripts.The dta utility is designed to allow you to use Database Engine Tuning Advisor functionality in applications and scripts.

Assim como o Orientador de Otimização do Mecanismo de Banco de Dados, o utilitário dta analisa uma carga de trabalho e recomenda estruturas de design físico para melhorar o desempenho do servidor para a carga de trabalho.Like Database Engine Tuning Advisor, the dta utility analyzes a workload and recommends physical design structures to improve server performance for that workload. A carga de trabalho pode ser um cache de plano, um arquivo de rastreamento ou tabela do SQL Server ProfilerSQL Server Profiler , ou um 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. Estruturas de design físico incluem índices, exibições indexadas e particionamento.Physical design structures include indexes, indexed views, and partitioning. Depois de analisar uma carga de trabalho, o utilitário dta produz uma recomendação para o design físico de bancos de dados e gera o script necessário para implementar a recomendação.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. Podem ser especificadas cargas de trabalho no prompt de comando com o argumento -if ou -it .Workloads can be specified from the command prompt with the -if or the -it argument. Também é possível especificar um arquivo de entrada XML no prompt de comando com o argumento -ix .You can also specify an XML input file from the command prompt with the -ix argument. Nesse caso, a carga de trabalho é especificada no arquivo de entrada XML.In that case, the workload is specified in the XML input file.

SintaxeSyntax


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

ArgumentosArguments

-?-?
Exibe informações de uso.Displays usage information.

-A time_for_tuning_in_minutes-A time_for_tuning_in_minutes
Especifica o prazo de ajuste em minutos.Specifies the tuning time limit in minutes. Odta usa a quantidade especificada de tempo para ajustar a carga de trabalho e gerar um script com as mudanças de design físico recomendadas.dta uses the specified amount of time to tune the workload and generate a script with the recommended physical design changes. Por padrão, o dta assume um tempo de ajuste de 8 horas.By default dta assumes a tuning time of 8 hours. Especificar 0 permite um tempo de ajuste ilimitado.Specifying 0allows unlimited tuning time. Odta pode terminar o ajuste da carga de trabalho inteira antes que o prazo expire.dta might finish tuning the entire workload before the time limit expires. No entanto, para garantir que a carga de trabalho inteira seja ajustada, é aconselhável que você especifique um tempo de ajuste ilimitado (-A 0).However, to make sure that the entire workload is tuned, we recommend that you specify unlimited tuning time (-A 0).

-a-a
Ajusta a carga de trabalho e aplica a recomendação sem uma solicitação.Tunes workload and applies the recommendation without prompting you.

-B storage_size-B storage_size
Especifica o espaço máximo em megabytes que pode ser consumido pelo índice e particionamento recomendados.Specifies the maximum space in megabytes that can be consumed by the recommended index and partitioning. Quando múltiplos bancos de dados são ajustados, as recomendações para todos os bancos de dados são consideradas no cálculo do espaço.When multiple databases are tuned, recommendations for all databases are considered for the space calculation. Por padrão, dta assume o menor dos seguintes tamanhos de armazenamento:By default, dta assumes the smaller of the following storage sizes:

  • Três vezes o tamanho de dados brutos atuais, o que inclui o tamanho total de heaps e índices cluster em tabelas no banco de dados.Three times the current raw data size, which includes the total size of heaps and clustered indexes on tables in the database.

  • Os espaços livres em todas as unidades de disco anexas mais o tamanho dos dados brutos.The free space on all attached disk drives plus the raw data size.

    O tamanho de armazenamento padrão não inclui índices não clusterizados e exibições indexadas.The default storage size does not include nonclustered indexes and indexed views.

    -C max_columns_in_index-C max_columns_in_index
    Especifica o número máximo de colunas nos índices proposto por dta .Specifies the maximum number of columns in indexes that dta proposes. O valor máximo é 1024.The maximum value is 1024. Por padrão, esse argumento é definido como 16.By default, this argument is set to 16.

    -c max_key_columns_in_index-c max_key_columns_in_index
    Especifica o número máximo de colunas principais nos índices proposto por dta .Specifies the maximum number of key columns in indexes that dta proposes. O valor padrão é 16, o valor máximo permitido.The default value is 16, the maximum value allowed. Odta também considera a criação de índices com colunas incluídas.dta also considers creating indexes with included columns. Os índices recomendados com colunas incluídas podem exceder o número de colunas especificado neste argumento.Indexes recommended with included columns may exceed the number of columns specified in this argument.

    -D database_name-D database_name
    Especifica o nome de cada banco de dados que será ajustado.Specifies the name of each database that is to be tuned. O primeiro banco de dados é o banco de dados padrão.The first database is the default database. É possível especificar bancos de dados múltiplos separando os nomes do banco de dados com vírgulas, por exemplo:You can specify multiple databases by separating the database names with commas, for example:

dta –D database_name1, database_name2...  

Como alternativa, você pode especificar bancos de dados múltiplos usando o argumento –D para cada nome de banco de dados, por exemplo: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  

O argumento -D é obrigatório.The -D argument is mandatory. Se o argumento -d não foi especificado, dta se conectará inicialmente ao banco de dados que é especificado com a primeira cláusula USE database_name na carga de trabalho.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 não houver a cláusula explícita USE database_name na carga de trabalho, será necessário usar o argumento -d .If there is not explicit USE database_name clause in the workload, you must use the -d argument.

Por exemplo, caso tenha uma carga de trabalho que não contém nenhuma cláusula USE database_name explícita e você usar o seguinte comando dta , uma recomendação não será gerada: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...  

Mas, se você usar a mesma carga de trabalho e usar o seguinte comando dta que usa o argumento -d , uma recomendação será gerada: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
Especifica o primeiro banco de dados ao qual dta se conecta ao ajustar uma carga de trabalho.Specifies the first database to which dta connects when tuning a workload. Apenas um banco de dados pode ser especificado para esse argumento.Only one database can be specified for this argument. Por exemplo:For example:

dta -d AdventureWorks2012 ...  

Se forem especificados vários nomes de banco de dados, dta retornará um erro.If multiple database names are specified, then dta returns an error. O argumento -d é opcional.The -d argument is optional.

Se você estiver usando uma entrada de arquivo XML, poderá especificar o primeiro banco de dados ao qual dta se conecta, usando o elemento DatabaseToConnect que está localizado no 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. Para saber mais, confira Database Engine Tuning Advisor.For more information, see Database Engine Tuning Advisor.

Se você estiver ajustando apenas um banco de dados, o argumento -d fornecerá uma funcionalidade que é semelhante ao argumento -d no utilitário sqlcmd , mas não executará a instrução 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. Para saber mais, confira sqlcmd Utility.For more information, see sqlcmd Utility.

-E-E
Usa uma conexão confiável em vez de pedir uma senha.Uses a trusted connection instead of requesting a password. O argumento -E ou -U , que especifica uma ID de logon, deve ser usado.Either the -E argument or the -U argument, which specifies a login ID, must be used.

-e tuning_log_name-e tuning_log_name
Especifica o nome da tabela ou do arquivo em que dta registra eventos que não puderam ser ajustados.Specifies the name of the table or file where dta records events that it could not tune. A tabela é criada no servidor onde o ajuste é executado.The table is created on the server where the tuning is performed.

Se uma tabela for usada, especifique seu nome no formato: [database_name].[owner_name].table_name.If a table is used, specify its name in the format: [database_name].[owner_name].table_name. A seguinte tabela mostra os valores padrão para cada parâmetro:The following table shows the default values for each parameter:

ParâmetroParameter Valor padrãoDefault value DetalhesDetails
database_namedatabase_name database_name especificado com a opção –Ddatabase_name specified with the –D option
owner_nameowner_name dbodbo owner_name deve ser dbo.owner_name must be dbo. Se qualquer outro valor for especificado, a execução de dta falhará e retornará um erro.If any other value is specified, then dta execution fails and it returns an error.
table_nametable_name NenhumaNone

Se um arquivo for usado, especifique .xml como sua extensão.If a file is used, specify .xml as its extension. Por exemplo, TuningLog.xml.For example, TuningLog.xml.

Observação

O utilitário dta não excluirá o conteúdo das tabelas de log de ajuste especificadas pelo usuário se a sessão for excluída.The dta utility does not delete the contents of user-specified tuning log tables if the session is deleted. Ao ajustar cargas de trabalho muito grandes, é recomendável que uma tabela seja especificada para o log de ajuste.When tuning very large workloads, we recommend that a table be specified for the tuning log. Como o ajuste de cargas de trabalho grandes pode resultar em logs de ajuste grandes, as sessões podem ser excluídas muito mais rapidamente ao usar uma tabela.Since tuning large workloads can result in large tuning logs, the sessions can be deleted much faster when a table is used.

-F-F
Permite que dta substitua um arquivo de saída existente.Permits dta to overwrite an existing output file. Se um arquivo de saída com o mesmo nome já existir e -F não for especificado, dtaretornará um erro.If an output file with the same name already exists and -F is not specified, dtareturns an error. Você pode usar -F com -of, -orou -ox.You can use -F with -of, -or, or -ox.

-fa physical_design_structures_to_add-fa physical_design_structures_to_add
Especifica que tipos de estruturas de design físico dta deve incluir na recomendação.Specifies what types of physical design structures dta should include in the recommendation. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.The following table lists and describes the values that can be specified for this argument. Quando nenhum valor é especificado, dta usa o padrão -faIDX.When no value is specified, dta uses the default -faIDX.

ValorValue DescriçãoDescription
IDX_IVIDX_IV Índices e exibições indexadas.Indexes and indexed views.
IDXIDX Somente índices.Indexes only.
IVIV Somente exibições indexadas.Indexed views only.
NCL_IDXNCL_IDX Somente índices não clusterizadosNonclustered indexes only.

-fi-fi
Especifica que os índices filtrados serão considerados em novas recomendações.Specifies that filtered indexes be considered for new recommendations. Para saber mais, confira Create Filtered Indexes.For more information, see Create Filtered Indexes.

-fc-fc
Especifica que os índices columnstore serão considerados em novas recomendações.Specifies that columnstore indexes be considered for new recommendations. DTA considerará índices columnstore clusterizados e não clusterizados.DTA will consider both clustered and non-clustered columnstore indexes. Para obter mais informações, consulteFor more information, see
Recomendações de índice ColumnStore no banco de dados ajuste de DTA (orientador mecanismo).Columnstore index recommendations in Database Engine Tuning Advisor (DTA). ||
|-|
|Aplica-se a: do SQL Server 2016SQL Server 2016 ao 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
Especifica quais estruturas de design físico dta deve reter ao gerar sua recomendação.Specifies what existing physical design structures dta must retain when generating its recommendation. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.The following table lists and describes the values that can be specified for this argument:

ValorValue DescriçãoDescription
NenhumaNONE Nenhuma estrutura existenteNo existing structures
ALLALL Todas as estruturas existentesAll existing structures
ALIGNEDALIGNED Todas as estruturas alinhadas por partição.All partition-aligned structures.
CL_IDXCL_IDX Todos os índices clusterizados em tabelasAll clustered indexes on tables
IDXIDX Todos os índices clusterizados e não clusterizados em tabelasAll clustered and nonclustered indexes on tables

-fp partitioning_strategy-fp partitioning_strategy
Especifica se as novas estruturas de design físico (índices e exibições indexadas) propostas por dta devem ser particionadas e como particioná-las.Specifies whether new physical design structures (indexes and indexed views) that dta proposes should be partitioned, and how they should be partitioned. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.The following table lists and describes the values that can be specified for this argument:

ValorValue DescriçãoDescription
NenhumaNONE Nenhum particionamentoNo partitioning
FULLFULL Particionamento completo (escolha para melhorar o desempenho).Full partitioning (choose to enhance performance)
ALIGNEDALIGNED Somente particionamento alinhado (escolha para melhorar a capacidade de gerenciamento)Aligned partitioning only (choose to enhance manageability)

ALIGNED significa que, na recomendação gerada por dta , todo índice proposto é particionado exatamente do mesmo modo que a tabela subjacente para a qual o índice foi definido.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. Índices não clusterizados em uma exibição indexada são alinhados com a exibição indexada.Nonclustered indexes on an indexed view are aligned with the indexed view. Só um valor pode ser especificado para esse argumento.Only one value can be specified for this argument. O padrão é -fpNONE.The default is -fpNONE.

-fx drop_only_mode-fx drop_only_mode
Especifica que dta só considera a remoção das estruturas de design físico existentes.Specifies that dta only considers dropping existing physical design structures. Nenhuma estrutura de design físico nova é considerada.No new physical design structures are considered. Quando esta opção é especificada, o dta avalia a utilidade de estruturas de design físico existentes e recomenda descartar as estruturas raramente usadas.When this option is specified, dta evaluates the usefulness of existing physical design structures and recommends dropping seldom used structures. Este argumento não leva nenhum valor.This argument takes no values. Não pode ser usado com os argumentos -fa, -fpou -fk ALLIt cannot be used with the -fa, -fp, or -fk ALL arguments

-ID session_ID-ID session_ID
Especifica um identificador numérico para a sessão de ajuste.Specifies a numerical identifier for the tuning session. Se não estiver especificado, dta gerará um número de identificação.If not specified, then dta generates an ID number. Você pode usar esse identificador para exibir informações para sessões de ajuste existentes.You can use this identifier to view information for existing tuning sessions. Se você não especificar um valor para -ID, um nome de sessão deverá ser especificado com -s.If you do not specify a value for -ID, then a session name must be specified with -s.

-ip-ip
Especifica que o cache de plano seja usado como a carga de trabalho.Specifies that the plan cache be used as the workload. Os primeiros 1.000 eventos de cache de plano para bancos de dados selecionados explicitamente são analisados.The top 1,000 plan cache events for explicitly selected databases are analyzed. Esse valor pode ser alterado usando a opção –n .This value can be changed using the –n option.

-QI-iq
Especifica que o repositório de consultas seja usado como a carga de trabalho.Specifies that the Query Store be used as the workload. Os primeiros 1.000 eventos do repositório de consultas para bancos de dados selecionados explicitamente são analisados.The top 1,000 events from the Query Store for explicitly selected databases are analyzed. Esse valor pode ser alterado usando a opção –n .This value can be changed using the –n option. Consulte repositório de consultas e ajuste de banco de dados usando cargas de trabalho do repositório de consultas para obter mais informações.See Query Store and Tuning Database Using Workload from Query Store for more information. ||
|-|
|Aplica-se a: do SQL Server 2016SQL Server 2016 ao SQL Server 2017SQL Server 2017.Applies to: SQL Server 2016SQL Server 2016 through SQL Server 2017SQL Server 2017.|

-if workload_file-if workload_file
Especifica o caminho e o nome do arquivo de carga de trabalho a ser usado como entrada para ajuste.Specifies the path and name of the workload file to use as input for tuning. O arquivo deve estar em um destes formatos: .trc (arquivo de rastreamento do SQL Server Profiler), .sql (arquivo de SQL) ou .log (arquivo de rastreamento do 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). Um arquivo de carga de trabalho ou uma tabela de carga de trabalho deve ser especificada.Either one workload file or one workload table must be specified.

-it workload_trace_table_name-it workload_trace_table_name
Especifica o nome de uma tabela que contém o rastreamento de carga de trabalho para ajuste.Specifies the name of a table containing the workload trace for tuning. O nome é especificado no formato: [database_name].[owner_name].table_name.The name is specified in the format: [database_name].[owner_name].table_name.

A tabela a seguir mostra os valores padrão de cada um:The following table shows the default values for each:

ParâmetroParameter Valor padrãoDefault value
database_namedatabase_name database_name especificado com a opção –D .database_name specified with –D option.
owner_nameowner_name dbo.dbo.
table_nametable_name Nenhum.None.
Observação

owner_name deve ser dbo.owner_name must be dbo. Se qualquer outro valor for especificado, a execução de dta falhará e um erro será retornado.If any other value is specified, execution of dta fails and an error is returned. Também observe que uma tabela de carga de trabalho ou um arquivo de carga de trabalho deve ser especificado.Also note that either one workload table or one workload file must be specified.

-ix input_XML_file_name-ix input_XML_file_name
Especifica o nome do arquivo XML que contém informações de entrada de dta .Specifies the name of the XML file containing dta input information. Esse deve ser um documento XML válido em conformidade com o DTASchema.xsd.This must be a valid XML document conforming to DTASchema.xsd. Argumentos em conflito especificados no prompt de comando para opções de ajuste anulam o valor correspondente no arquivo XML.Conflicting arguments specified from the command prompt for tuning options override the corresponding value in this XML file. A única exceção será se uma configuração especificada pelo usuário for digitada dentro do modo de avaliação no arquivo de entrada XML.The only exception is if a user-specified configuration is entered in the evaluate mode in the XML input file. Por exemplo, se uma configuração for digitada no elemento Configuration do arquivo de entrada XML e o elemento EvaluateConfiguration também for especificado como um das opções de ajuste, as opções de ajuste especificadas no arquivo de entrada XML substituirão a opção de ajuste digitada no prompt de comando.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
Especifica a porcentagem mínima de melhoria que a configuração recomendada deve satisfazer.Specifies the minimum percentage of improvement that the recommended configuration must satisfy.

-N online_option-N online_option
Especifica se são criadas estruturas de design físico online.Specifies whether physical design structures are created online. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.The following table lists and describes the values you can specify for this argument:

ValorValue DescriçãoDescription
OFFOFF Nenhuma estrutura de design físico recomendada pode ser criada online.No recommended physical design structures can be created online.
ONON Todas as estruturas de design físico recomendadas podem ser criadas online.All recommended physical design structures can be created online.
MIXEDMIXED O Orientador de Otimização do Mecanismo de Banco de Dados tenta recomendar estruturas de design físico que podem ser criadas online quando possível.Database Engine Tuning Advisor attempts to recommend physical design structures that can be created online when possible.

Se forem criados índices online, ONLINE = ON será anexado à definição de objeto.If indexes are created online, ONLINE = ON is appended to its object definition.

-n number_of_events-n number_of_events
Especifica o número de eventos na carga de trabalho que dta deve ajustar.Specifies the number of events in the workload that dta should tune. Se esse argumento for especificado e a carga de trabalho for um arquivo de rastreamento que contém informações de duração, dta ajustará os eventos em ordem decrescente de duração.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. Esse argumento é útil para comparar duas configurações de estruturas de design físico.This argument is useful to compare two configurations of physical design structures. Para comparar duas configurações, especifique o mesmo número de eventos a serem ajustados para ambas as configurações e também especifique um tempo de ajuste ilimitado para ambos como segue: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  

Nessecaso, é importante especificar um tempo de ajuste ilimitado (-A 0).In this case, it is important to specify an unlimited tuning time (-A 0). Caso contrário, o Orientador de Otimização do Mecanismo de Banco de Dados assume, por padrão, um tempo de ajuste de 8 horas.Otherwise, Database Engine Tuning Advisor assumes an 8 hour tuning time by default.

-I time_window_in_hours -I time_window_in_hours
Especifica a janela de tempo (em horas) quando uma consulta deve ter executado para que ela seja considerada pelo DTA para ajustar ao usar -QI opção (carga de trabalho do repositório de consultas).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  

Nesse caso, DTA será usar o repositório de consultas como a fonte de carga de trabalho e considerar apenas consultas que foram executadas nas últimas 48 horas.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.
||
|-|
|Aplica-se a: do SQL Server 2016SQL Server 2016 ao 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
Especifica que dta grava a recomendação como um script Transact-SQLTransact-SQL no nome de arquivo e destino especificados.Specifies that dta writes the recommendation as a Transact-SQLTransact-SQL script to the file name and destination specified.

Você pode usar -F com essa opção.You can use -F with this option. Verifique se o nome de arquivo é exclusivo, especialmente se você também estiver usando -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
Especifica que dta grava a recomendação em um relatório de saída em XML.Specifies that dta writes the recommendation to an output report in XML. Se um nome de arquivo for fornecido, as recomendações serão gravadas nesse destino.If a file name is supplied, then the recommendations are written to that destination. Caso contrário, o dta usa o nome de sessão para gerar o nome de arquivo e grava-o no diretório atual.Otherwise, dta uses the session name to generate the file name and writes it to the current directory.

Você pode usar -F com essa opção.You can use -F with this option. Verifique se o nome de arquivo é exclusivo, especialmente se você também estiver usando -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
Especifica que dta grava a recomendação como um arquivo XML no nome de arquivo e destino fornecidos.Specifies that dta writes the recommendation as an XML file to the file name and destination supplied. Verifique se o Orientador de Otimização do Mecanismo de Banco de Dados tem permissões para gravar no diretório de destino.Ensure that Database Engine Tuning Advisor has permissions to write to the destination directory.

Você pode usar -F com essa opção.You can use -F with this option. Verifique se o nome de arquivo é exclusivo, especialmente se você também estiver usando -of e -or.Make sure that the file name is unique, especially if you are also using -of and -or.

-P password-P password
Especifica a senha para a ID de logon.Specifies the password for the login ID. Se essa opção não for usada, o dta solicitará a senha.If this option is not used, dta prompts for a password.

-q-q
Define o modo silencioso.Sets quiet mode. Nenhuma informação é gravada no console, inclusive informações de progresso e de cabeçalho.No information is written to the console, including progress and header information.

-rl analysis_report_list-rl analysis_report_list
Especifica a lista de relatórios de análise a serem gerados.Specifies the list of analysis reports to generate. A seguinte tabela lista os valores que podem ser especificados para esse argumento:The following table lists the values that can be specified for this argument:

ValorValue RelatórioReport
ALLALL Todos os relatórios de análiseAll analysis reports
STMT_COSTSTMT_COST Relatório de custo da instruçãoStatement cost report
EVT_FREQEVT_FREQ Relatório de frequência de eventoEvent frequency report
STMT_DETSTMT_DET Relatório de detalhe de instruçãoStatement detail report
CUR_STMT_IDXCUR_STMT_IDX Relatório de relações do índice de instrução (configuração atual)Statement-index relations report (current configuration)
REC_STMT_IDXREC_STMT_IDX Relatório de relações do índice de instrução (configuração recomendada)Statement-index relations report (recommended configuration)
STMT_COSTRANGESTMT_COSTRANGE Relatório de intervalo de custo da instruçãoStatement cost range report
CUR_IDX_USAGECUR_IDX_USAGE Relatório de uso de índice (configuração atual)Index usage report (current configuration)
REC_IDX_USAGEREC_IDX_USAGE Relatório de uso de índice (configuração recomendada)Index usage report (recommended configuration)
CUR_IDX_DETCUR_IDX_DET Relatório de detalhe de índice (configuração atual)Index detail report (current configuration)
REC_IDX_DETREC_IDX_DET Relatório de detalhe de índice (configuração recomendada)Index detail report (recommended configuration)
VIW_TABVIW_TAB Relatório de relações da tabela de exibiçãoView-table relations report
WKLD_ANLWKLD_ANL Relatório de análise da carga de trabalhoWorkload analysis report
DB_ACCESSDB_ACCESS Relatório de acesso ao banco de dadosDatabase access report
TAB_ACCESSTAB_ACCESS Relatório de acesso à tabelaTable access report
COL_ACCESSCOL_ACCESS Relatório de acesso à colunaColumn access report

Especifica relatórios múltiplos separando os valores com vírgulas, por exemplo: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]
Especifica o nome do computador e a instância do SQL ServerSQL Server para conexão.Specifies the name of the computer and instance of SQL ServerSQL Server to connect to. Se nenhum server_name for especificado, dta se conectará à instância padrão do SQL ServerSQL Server no computador local.If no server_name is specified, dta connects to the default instance of SQL ServerSQL Server on the local computer. Essa opção é requerida na conexão à uma instância nomeada ou na execução de dta de um computador remoto na rede.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
Especifica o nome da sessão de ajuste.Specifies the name of the tuning session. Isso será obrigatório se -ID não for especificado.This is required if -ID is not specified.

-Tf table_list_file-Tf table_list_file
Especifica o nome de um arquivo que contém uma lista de tabelas a ser ajustada.Specifies the name of a file containing a list of tables to be tuned. Cada tabela listada dentro do arquivo deve começar em uma linha nova.Each table listed within the file should begin on a new line. Nomes de tabela devem ser qualificados com nomeação de três partes, por exemplo, AdventureWorks2012.HumanResources.Department.Table names should be qualified with three-part naming, for example, AdventureWorks2012.HumanResources.Department. Opcionalmente, para invocar o recurso do escalamento de tabela, o nome de uma tabela existente pode ser seguido de um número que indica o número projetado de linhas na tabela.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. O Orientador de Otimização do Mecanismo de Banco de Dados leva em conta o número projetado de linhas ao ajustar ou avaliar as instruções na carga de trabalho que referenciam estas tabelas.Database Engine Tuning Advisor takes into consideration the projected number of rows while tuning or evaluating statements in the workload that reference these tables. Observe que pode haver um ou mais espaços entre a contagem 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.

Este é o formato de arquivo para 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]

Esse argumento é uma alternativa à inserção de uma lista de tabela no prompt de comando (-Tl).This argument is an alternative to entering a table list at the command prompt (-Tl). Não use um arquivo de lista de tabela (-Tf) se você estiver usando -Tl.Do not use a table list file (-Tf) if you are using -Tl. Se ambos os argumentos forem usados, o dta falhará e retornará um erro.If both arguments are used, dta fails and returns an error.

Se os argumentos -Tf e -Tl forem omitidos, todas as tabelas de usuário nos bancos de dados especificados serão consideradas para o ajuste.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
Especifica ao prompt de comando uma lista de tabelas a serem ajustadas.Specifies at the command prompt a list of tables to be tuned. Coloque vírgulas entre os nomes de tabela para separá-los.Place commas between table names to separate them. Se apenas um banco de dados for especificado com o argumento -D , os nomes de tabela não precisarão ser qualificados com um nome de banco de dados.If only one database is specified with the -D argument, then table names do not need to be qualified with a database name. Caso contrário, o nome totalmente qualificado no formato: database_name.schema_name.table_name será obrigatório para cada tabela.Otherwise, the fully qualified name in the format: database_name.schema_name.table_name is required for each table.

Esse argumento é uma alternativa ao uso de um arquivo de lista de tabela (-Tf).This argument is an alternative to using a table list file (-Tf). Se -Tl e -Tf forem usados, dta falhará e retornará um erro.If both -Tl and -Tf are used, dta fails and returns an error.

-U login_id-U login_id
Especifica a ID de logon usada para conectar-se ao SQL ServerSQL Server.Specifies the login ID used to connect to SQL ServerSQL Server.

-u-u
Inicia a GUI do Orientador de Otimização do Mecanismo de Banco de Dados.Launches the Database Engine Tuning Advisor GUI. Todos os parâmetros são tratados como as configurações iniciais para a interface com o usuário.All parameters are treated as the initial settings for the user interface.

-x-x
Inicia a sessão de ajuste e sai.Starts tuning session and exits.

ComentáriosRemarks

Pressione CTRL+C uma vez para parar a sessão de ajuste e gerar recomendações com base na análise do dta concluída até este ponto.Press CTRL+C once to stop the tuning session and generate recommendations based on the analysis dta has completed up to this point. Você será solicitado a indicar se deseja ou não gerar recomendações.You will be prompted to decide whether you want to generate recommendations or not. Pressione CTRL+C novamente para parar a sessão de ajuste sem gerar recomendações.Press CTRL+C again to stop the tuning session without generating recommendations.

ExemplosExamples

A. Ajustar uma carga de trabalho que inclui índices e exibições indexadas em sua recomendaçãoA. Tune a workload that includes indexes and indexed views in its recommendation

Esse exemplo usa uma conexão segura (-E) para se conectar ao banco de dados tpcd1G no MyServer para analisar uma carga de trabalho e criar recomendações.This example uses a secure connection (-E) to connect to the tpcd1G database on MyServer to analyze a workload and create recommendations. Grava a saída em um arquivo de script nomeado script.sql.It writes the output to a script file named script.sql. Se o script.sql já existir, dta substituirá o arquivo porque o argumento -F foi especificado.If script.sql already exists, then dta will overwrite the file because the -F argument has been specified. A sessão de ajuste é executada por um tempo ilimitado para garantir uma análise completa da carga de trabalho (-A 0).The tuning session runs for an unlimited length of time to ensure a complete analysis of the workload (-A 0). A recomendação deve fornecer uma melhoria mínima de 5% (-m 5).The recommendation must provide a minimum improvement of 5% (-m 5). dta deve incluir índices e exibições indexadas em sua recomendação final (-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. Limite o uso de discoB. Limit disk use

Esse exemplo limita o tamanho de banco de dados total, que inclui os dados brutos e os índices adicionais, a 3 gigabytes (GB) (-B 3000) e direciona a saída para 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. Ele é executado por no máximo 1 hora (-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. Limitar o número de consultas de ajusteC. Limit the number of tuned queries

Esse exemplo limita o número de consultas lidas do arquivo orders_wkld.sql a um máximo de 10 (-n 10) e é executado por 15 minutos (-A 15), o que ocorrer primeiro.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. Para garantir que todas as 10 consultas sejam ajustadas, especifique um tempo de ajuste ilimitado com -A 0.To make sure that all 10 queries are tuned, specify an unlimited tuning time with -A 0. Se o tempo for importante, determine um prazo apropriado, especificando o número de minutos que estão disponíveis para ajuste com o argumento -A , como mostrado neste exemplo.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. Ajusta tabelas específicas listadas em um arquivoD. Tune specific tables listed in a file

Este exemplo demonstra o uso de table_list_file (o argumento -Tf ).This example demonstrates the use of table_list_file (the -Tf argument). O conteúdo do arquivo table_list.txt é:The contents of the file table_list.txt are as follows:

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

O conteúdo de table_list.txt especifica que:The contents of table_list.txt specifies that:

  • Deve-se ajustar apenas as tabelas Customer, Storee Product no banco de dados.Only the Customer, Store, and Product tables in the database should be tuned.

  • Presume-se que o número de linhas nas tabelas Customer e Product seja 100.000 e 2.000.000, respectivamente.The number of rows in the Customer and Product tables are assumed to be 100,000 and 2,000,000, respectively.

  • Presume-se que em Store o número de linhas seja o número atual de linhas na tabela.The number of rows in Store are assumed to be the current number of rows in the table.

    Observe que pode haver um ou mais espaços entre a contagem de número de linhas e o nome de tabela anterior em 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.

    O tempo de ajuste é de 2 horas (-A 120) e a saída é gravada em um arquivo 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  

Consulte tambémSee Also

Referência de utilitários de prompt de comando (Mecanismo de Banco de Dados) Command Prompt Utility Reference (Database Engine)
Orientador de Otimização do Mecanismo de Banco de DadosDatabase Engine Tuning Advisor