Programa utilitário DTA

Aplica-se:SQL Server

O programa utilitário DTA é a versão do prompt de comando do Orientador de Otimização do Mecanismo de Banco de Dados. 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.

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. A carga de trabalho pode ser um cache de planos, uma tabela ou arquivo de rastreamento do SQL Server Profiler ou um script Transact-SQL. Estruturas de design físico incluem índices, exibições indexadas e particionamento.

Depois que o utilitário dta analisa uma carga de trabalho, ele produz uma recomendação para o design físico de bancos de dados e pode gerar o script necessário para implementar a recomendação. As cargas de trabalho podem ser especificadas no prompt de comando com o -if argumento ou o -it argumento. Você também pode especificar um arquivo de entrada XML no prompt de comando com o -ix argumento. Nesse caso, a carga de trabalho é especificada no arquivo de entrada XML.

Sintaxe

dta
[ -? ] |
[
      [ -S server_name [ \instance ] ]
      { { -U login_id [ -P password ] } | -E }
      { -ce connection_encrypt_option }
      { -tc }
      { -hc hostname_in_certificate }
      { -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 ]
      [ -l 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 ]
]

Argumentos

-?

Exibe informações de uso.

-Um time_for_tuning_in_minutes

Especifica o prazo de ajuste em minutos. 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. Por padrão, o dta assume um tempo de ajuste de 8 horas. Especificar 0 permite um tempo de ajuste ilimitado. Odta pode terminar o ajuste da carga de trabalho inteira antes que o prazo expire. No entanto, para garantir que a carga de trabalho inteira seja ajustada, é aconselhável que você especifique um tempo de ajuste ilimitado (-A 0).

-a

Ajusta a carga de trabalho e aplica a recomendação sem uma solicitação.

- B storage_size

Especifica o espaço máximo em megabytes que pode ser consumido pelo índice e particionamento recomendados. 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. Por padrão, dta assume o menor dos seguintes tamanhos de armazenamento:

• 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.

• Os espaços livres em todas as unidades de disco anexas mais o tamanho dos dados brutos.

O tamanho de armazenamento padrão não inclui índices não clusterizados e exibições indexadas.

-C máximo_de_colunas_no_índice

Especifica o número máximo de colunas nos índices proposto por dta . O valor máximo é de 1024. Por padrão, esse argumento é definido como 16.

-c max_key_columns_in_index

Especifica o número máximo de colunas principais nos índices proposto por dta . O valor padrão é 16, o valor máximo permitido. Odta também considera a criação de índices com colunas incluídas. Índices recomendados com colunas incluídas podem exceder o número de colunas especificadas nesse argumento.

-ce connection_encrypt_option

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores

Especifica que a conexão é criptografada entre o servidor e o cliente. Valores possíveis: yes, no e strict. A opção padrão é yes. Para obter mais informações, consulte TDS 8.0.

-Tc

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores

Especifica se o certificado do servidor deve ser confiável. Esse parâmetro é opcional, semelhante ao HostnameInCertificate usado em outras ferramentas e cadeias de conexão.

Para obter mais informações, consulte TDS 8.0.

-hc hostname_in_certificate

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores

Especifica um CN ou SAN diferente esperado no certificado do servidor a ser usado durante a validação do certificado do servidor. Para obter mais informações, consulte TDS 8.0.

- D database_name

Especifica o nome de cada banco de dados que será ajustado. O primeiro banco de dados é o banco de dados padrão. É possível especificar bancos de dados múltiplos separando os nomes do banco de dados com vírgulas, por exemplo:

dta -D database_name1, database_name2...

Como alternativa, você pode especificar vários bancos de dados usando o -D argumento para cada nome de banco de dados, por exemplo:

dta -D database_name1 -D database_name2... n

O -D argumento é obrigatório. Se o -d argumento não for especificado, o dta se conectará inicialmente ao banco de dados especificado com a primeira USE database_name cláusula na carga de trabalho. Se não houver cláusula explícita USE database_name na carga de trabalho, você deverá usar o -d argumento.

Por exemplo, se você tiver uma carga de trabalho que não contém nenhuma cláusula explícita USE database_name e usar o seguinte comando dta , uma recomendação não será gerada:

dta -D db_name1, db_name2...

Mas se você usar a mesma carga de trabalho e usar o seguinte comando dta que usa o -d argumento, uma recomendação será gerada:

dta -D db_name1, db_name2 -d db_name1

-d database_name

Especifica o primeiro banco de dados ao qual dta se conecta ao ajustar uma carga de trabalho. Apenas um banco de dados pode ser especificado para esse argumento. Por exemplo:

dta -d AdventureWorks2022 ...

Se forem especificados vários nomes de banco de dados, dta retornará um erro. O -d argumento é opcional.

Se você estiver usando um arquivo de entrada XML, poderá especificar o primeiro banco de dados ao qual o dta se conecta usando o elemento DatabaseToConnect localizado no elemento TuningOptions . Para obter mais informações, consulte Database Engine Tuning Advisor.

Se você estiver ajustando apenas um banco de dados, o -d argumento fornecerá funcionalidade semelhante ao -d argumento no utilitário sqlcmd , mas ele não executará a USEinstrução database_name . Para saber mais, confira sqlcmd Utility.

-E

Usa uma conexão confiável em vez de pedir uma senha. -E O argumento ou o -U argumento, que especifica uma ID de logon, deve ser usado.

-e tuning_log_name

Especifica o nome da tabela ou do arquivo em que o dta registra eventos que não foi possível ajustar. A tabela é criada no servidor onde o ajuste é executado.

Se uma tabela for usada, especifique seu nome no formato: [database_name].[owner_name].table_name. A seguinte tabela mostra os valores padrão para cada parâmetro:

Se um arquivo for usado, especifique .xml como sua extensão. Por exemplo, TuningLog.xml.

-F

Permite que dta substitua um arquivo de saída existente. Se um arquivo de saída com o mesmo nome já existir e -F não for especificado, o dta retornará um erro. Você pode usar -F com -of, -orou -ox.

-fa estruturas_de_design_físico_para_adicionar

Especifica que tipos de estruturas de design físico dta deve incluir na recomendação. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento. Quando nenhum valor é especificado, o dta usa o padrão -fa IDX.

-Fi

Especifica que os índices filtrados serão considerados em novas recomendações. Para obter mais informações, consulte Criar índices filtrados.

-Fc

Especifica que os índices columnstore serão considerados em novas recomendações. O DTA considera índices columnstore clusterizados e não clusterizados. Para obter mais informações, consulte as recomendações de índice Columnstore no DTA (Orientador de Otimização do Mecanismo de Banco de Dados).

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores.

-fk manter_opcao_existente

Especifica quais estruturas de design físico dta deve reter ao gerar sua recomendação. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.

- 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. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.

ALIGNED significa que, na recomendação gerada pelo dta , cada índice proposto é particionado exatamente da mesma forma que a tabela subjacente para a qual o índice é definido. Índices não clusterizados em uma exibição indexada são alinhados com a exibição indexada. Só um valor pode ser especificado para esse argumento. O padrão é -fp NONE.

- fx drop_only_mode

Especifica que dta só considera a remoção das estruturas de design físico existentes. Nenhuma estrutura de design físico nova é considerada. Quando esta opção é especificada, o dta avalia a utilidade de estruturas de design físico existentes e recomenda descartar as estruturas raramente usadas. Este argumento não aceita nenhum valor. Ele não pode ser usado com os -faargumentos , -fpou -fk ALL

-ID session_ID

Especifica um identificador numérico para a sessão de ajuste. Se não estiver especificado, dta gerará um número de identificação. Você pode usar esse identificador para exibir informações para sessões de ajuste existentes. Se você não especificar um valor para -ID, um nome de sessão deverá ser especificado com -s.

-IP

Especifica que o cache de plano é usado como a carga de trabalho. Os primeiros 1.000 eventos de cache de plano para bancos de dados selecionados explicitamente são analisados. Esse valor pode ser alterado usando a opção -n .

-QI

Especifica que o Repositório de Consultas é usado como a carga de trabalho. Os mil principais eventos do Repositório de Consultas para bancos de dados explicitamente selecionados são analisados. Esse valor pode ser alterado usando a opção -n . Para obter mais informações, consulte Como o Repositório de Consultas coleta dados e ajusta o banco de dados usando a carga de trabalho do Repositório de Consultas com o Orientador de Otimização do Mecanismo de Banco de Dados.

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores.

- se workload_file

Especifica o caminho e o nome do arquivo de carga de trabalho a ser usado como entrada para ajuste. O arquivo deve estar em um destes formatos: .trc (arquivo de rastreamento do SQL Server Profiler) .sql (Transact-SQL arquivo) ou .log (arquivo de rastreamento do SQL Server). Um arquivo de carga de trabalho ou uma tabela de carga de trabalho deve ser especificada.

- workload_trace_table_name

Especifica o nome de uma tabela que contém o rastreamento de carga de trabalho para ajuste. O nome é especificado no formato: [database_name]. [owner_name]. table_name.

A tabela a seguir mostra os valores padrão de cada um:

-ix input_XML_file_name

Especifica o nome do arquivo XML que contém informações de entrada de dta . Este documento XML deve estar em conformidade com o DTASchema.xsd esquema. Argumentos em conflito especificados no prompt de comando para opções de ajuste anulam o valor correspondente no arquivo XML. 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. Por exemplo, se uma configuração for inserida no elemento Configuration do arquivo de entrada XML e o elemento EvaluateConfiguration também for especificado como uma das opções de ajuste, as opções de ajuste especificadas no arquivo de entrada XML substituirão as opções de ajuste inseridas no prompt de comando.

-k maxtotalindexes

Número máximo de índices na recomendação.

-K maxtotalindexes

Número máximo de índices por tabela.

-m minimum_improvement

Especifica a porcentagem mínima de melhoria que a configuração recomendada deve satisfazer.

-N opção_online

Especifica se são criadas estruturas de design físico online. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento.

Se os índices forem criados online, ONLINE = ON será acrescentado à sua definição de objeto.

-n numero_de_eventos

Especifica o número de eventos na carga de trabalho que dta deve ajustar. 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. Esse argumento é útil para comparar duas configurações de estruturas de design físico. Para comparar duas configurações, especifique o mesmo número de eventos a serem ajustados para ambas as configurações e especifique um tempo de ajuste ilimitado para ambos também da seguinte maneira:

dta -n number_of_events -A 0

Nesse caso, é importante especificar um tempo de ajuste ilimitado (-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.

-l time_window_in_hours

Especifica a janela de tempo (em horas) em que uma consulta deve ter sido executada para que ela seja considerada para ajuste ao usar -iq a opção (Carga de trabalho do Repositório de Consultas).

dta -iq -l 48

Nesse caso, o DTA usa o Repositório de Consultas como a origem da carga de trabalho e considera apenas as consultas executadas nas últimas 48 horas.

Aplica-se a: SQL Server 2016 (13.x) e posterior.

-de output_script_file_name

Especifica que dta grava a recomendação como um script Transact-SQL no nome de arquivo e destino especificados.

Você pode usar -F com essa opção. Verifique se o nome do arquivo é exclusivo, especialmente se você também estiver usando -or e -ox.

-ou output_xml_report_file_name

Especifica que dta grava a recomendação em um relatório de saída em XML. Se um nome de arquivo for fornecido, as recomendações serão gravadas nesse destino. Caso contrário, o dta usa o nome de sessão para gerar o nome de arquivo e grava-o no diretório atual.

Você pode usar -F com essa opção. Verifique se o nome do arquivo é exclusivo, especialmente se você também estiver usando -of e -ox.

- ox output_XML_file_name

Especifica que dta grava a recomendação como um arquivo XML no nome de arquivo e destino fornecidos. Verifique se o Orientador de Otimização do Mecanismo de Banco de Dados tem permissões de gravação no diretório de destino.

Você pode usar -F com essa opção. Verifique se o nome do arquivo é exclusivo, especialmente se você também estiver usando -of e -or.

Senha -P

Especifica a senha para a ID de logon. Se essa opção não for usada, o dta solicitará uma senha.

-q

Define o modo silencioso. Nenhuma informação é gravada no console, inclusive informações de progresso e de cabeçalho.

-rl lista_de_relatorios_de_analise

Especifica a lista de relatórios de análise a serem gerados. A seguinte tabela lista os valores que podem ser especificados para esse argumento:

Especifica relatórios múltiplos separando os valores com vírgulas, por exemplo:

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

-S server_name [ \instance ]

Especifica o nome do computador e a instância do SQL Server para conexão. Se nenhum server_name for especificado, dta se conectará à instância padrão do SQL Server no computador local. Essa opção é requerida na conexão à uma instância nomeada ou na execução de dta de um computador remoto na rede.

-s session_name

Especifica o nome da sessão de ajuste. Isso será necessário se -ID não for especificado.

-Tf table_list_file

Especifica o nome de um arquivo que contém uma lista de tabelas a ser ajustada. Cada tabela listada dentro do arquivo deve começar em uma linha nova. Os nomes de tabela devem ser qualificados com nomenclatura de três partes, por exemplo, AdventureWorks2022.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. O Consultor de Otimização do Mecanismo de Banco de Dados considera o número projetado de linhas ao ajustar ou avaliar as instruções na carga de trabalho que referenciam essas tabelas. Pode haver um ou mais espaços entre a contagem de number_of_rows e a table_name.

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

Esse argumento é uma alternativa para inserir uma lista de tabelas no prompt de comando (-Tl). Não use um arquivo de lista de tabelas (-Tf) se você estiver usando -Tl. Se ambos os argumentos forem usados, o dta falhará e retornará um erro.

Se os argumentos e -Tf os -Tl argumentos forem omitidos, todas as tabelas de usuário nos bancos de dados especificados serão consideradas para ajuste.

-TL table_list

Especifica no prompt de comando uma lista de tabelas a serem ajustadas. Coloque vírgulas entre os nomes de tabela para separá-los. Se apenas um banco de dados for especificado com o -D argumento, os nomes de tabela não precisarão ser qualificados com um nome de banco de dados. Caso contrário, o nome totalmente qualificado no formato: database_name.schema_name.table_name será obrigatório para cada tabela.

Esse argumento é uma alternativa ao uso de um arquivo de lista de tabelas (-Tf). Se ambos -Tl forem -Tf usados, o dta falhará e retornará um erro.

- U login_id

Especifica a ID de logon usada para conectar-se ao SQL Server.

-u

Inicia a GUI do Orientador de Otimização do Mecanismo de Banco de Dados. Todos os parâmetros são tratados como as configurações iniciais para a interface com o usuário.

-x

Inicia a sessão de ajuste e sai.

Comentários

Pressione Ctrl+C uma vez para interromper a sessão de ajuste e gerar recomendações, com base na análise que dta concluiu até este ponto. Você será solicitado a decidir se deseja gerar recomendações ou não. Pressione Ctrl+C novamente para interromper a sessão de ajuste sem gerar recomendações.

Exemplos

Um. Ajuste uma carga de trabalho que inclua índices e exibições indexadas na recomendação

Este exemplo usa uma conexão segura (-E) para se conectar ao tpcd1G banco de dados no MyServer para analisar uma carga de trabalho e criar recomendações. Ele grava a saída em um arquivo de script chamado script.sql. Se script.sql já existir, o dta substituirá o arquivo porque o -F argumento foi especificado. A sessão de ajuste é executada por um tempo ilimitado para garantir uma análise completa da carga de trabalho (-A 0). A recomendação deve fornecer uma melhoria mínima de 5% (-m 5). dta deve incluir índices e exibições indexadas em sua recomendação final (-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. Limita o uso de disco

Este exemplo limita o tamanho total do banco de dados, que inclui os dados brutos e os índices extras, a 3 gigabytes (GB) (-B 3000) e direciona a saída para d:\result_dir\script1.sql. Ela é executado por, no máximo, 1 hora (-A 60).

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

C. Limita o número de consultas de ajuste

Este 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. Para garantir que todas as 10 consultas sejam ajustadas, especifique um tempo de ajuste ilimitado com -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.

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

D. Ajusta tabelas específicas listadas em um arquivo

Este exemplo demonstra o uso de table_list_file (o -Tf argumento). O conteúdo do arquivo table_list.txt é o seguinte:

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

O conteúdo de table_list.txt especifica que:

• Somente as tabelas Customere Store tabelas Productno banco de dados devem ser ajustadas.

• O número de linhas e tabelas CustomerProduct é considerado 100.000 e 2.000.000, respectivamente.

• Supõe-se que o número de linhas na Store tabela seja o número atual de linhas.

  Pode haver um ou mais espaços entre o número de linhas e o nome da tabela anterior no table_list_file.

  O tempo de ajuste é de 2 horas (-A 120) e a saída é gravada em um arquivo XML (-ox XMLTune.xml).

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

E. Conecte-se a um arquivo de carga de trabalho, substitua o arquivo de saída usando opções de ajuste

Este exemplo mostra como se conectar sem criptografia, incluir um arquivo de carga de trabalho, substituir o arquivo de saída, ajustar por um período de 60 minutos, com uma melhoria de 5% e apenas para índices. Substitua <server> e <database> com valores válidos.

dta -S <server> -E -ce no -D <database> -if workload_file.sql -F -of output_script.sql -A 60 -m 5 -fa IDX

Este exemplo é o mesmo que o comando anterior, mas com criptografia de conexão. Substitua <server> e <database> com valores válidos.

dta -S <server> -E -ce yes -tc -D <database> -if workload_file.sql -F -of output_script.sql -A 60 -m 5 -fa IDX

Conteúdo relacionado

• Utilitários de linha de comando SQL (Mecanismo de Banco de Dados)
• Assistente de Ajuste do Mecanismo de Banco de Dados