utilitário dta

Aplica-se a:SQL Server

O 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 que você use a funcionalidade do Orientador de Otimização do Mecanismo de Banco de Dados em aplicativos e scripts.

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 projeto físico para melhorar o desempenho do servidor para essa carga de trabalho. A carga de trabalho pode ser um cache de plano, um arquivo ou tabela de rastreamento do SQL Server Profiler ou um script Transact-SQL. As estruturas de design físico incluem índices, exibições indexadas e particionamento.

Depois de a utilidade dta analisar uma carga de trabalho, produz uma recomendação para o design físico das bases 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 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.

-Uma time_for_tuning_in_minutes

Especifica o limite de tempo de ajuste em minutos. DTA usa a quantidade de tempo especificada para ajustar a carga de trabalho e gerar um script com as alterações 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. dta pode terminar de ajustar toda a carga de trabalho antes que o limite de tempo expire. No entanto, para garantir que toda a carga de trabalho esteja ajustada, recomendamos que você especifique o tempo de ajuste ilimitado (-A 0).

-a

Ajusta a carga de trabalho e aplica a recomendação sem avisá-lo.

-B storage_size

Especifica o espaço máximo em megabytes que pode ser consumido pelo índice e particionamento recomendados. Quando vários bancos de dados são ajustados, as recomendações para todos os bancos de dados são consideradas para o cálculo de espaço. Por padrão, dta assume o menor dos seguintes tamanhos de armazenamento:

• Três vezes o tamanho atual dos dados brutos, que inclui o tamanho total de pilhas e índices agrupados em tabelas no banco de dados.

• O espaço livre em todas as unidades de disco conectadas 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_colunas_no_índice

Especifica o número máximo de colunas em índices que o dta propõe. O valor máximo é 1024. Por padrão, esse argumento é definido como 16.

- C max_key_columns_in_index

Especifica o número máximo de colunas de chave em índices que o dta propõe. O valor padrão é 16, o valor máximo permitido. DTA também considera a criação de índices com colunas incluídas. Os índices recomendados com colunas incluídas podem exceder o número de colunas especificado neste argumento.

-ce connection_encrypt_option

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

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

-tc

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

Especifica se deve confiar no certificado do servidor. Este parâmetro é opcional, semelhante ao HostnameInCertificate usado noutras ferramentas e cadeias de ligação.

Para mais informações, consulte TDS 8.0.

-hc hostname_in_certificate

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

Especifica uma CN ou SAN diferente e esperada no certificado do servidor a usar durante a validação do certificado do servidor. Para mais informações, consulte TDS 8.0.

- D database_name

Especifica o nome de cada banco de dados a ser ajustado. O primeiro banco de dados é o banco de dados padrão. Você pode especificar vários bancos de dados separando os nomes dos bancos de dados por vírgulas, por exemplo:

dta -D database_name1, database_name2...

Como alternativa, você pode especificar vários bancos de dados usando o argumento para cada nome de -D 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 liga-se inicialmente à base de dados especificada com a primeira USE database_name cláusula da carga de trabalho. Se não houver uma 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 contenha 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 o 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 vários nomes de banco de dados forem especificados, 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 dta se conecta usando o elemento DatabaseToConnect localizado sob o elemento TuningOptions . Para obter mais informações, consulte Orientador de Otimização do Mecanismo de Banco de Dados.

Se estiveres a ajustar apenas uma base de dados, o -d argumento fornece funcionalidades semelhantes ao -d argumento na utilidade sqlcmd, mas não executa a USE instrução database_name. Para obter mais informações, consulte Utilitário sqlcmd.

-E

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

-e tuning_log_name

Especifica o nome da tabela ou arquivo onde dta registra eventos que não pôde 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 tabela a seguir 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 o 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, dta retornará um erro. Você pode usar -F com -of, -orou -ox.

-fa estruturas_design_físico_a_adicionar

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

-fi

Especifica que os índices filtrados sejam considerados para novas recomendações. Para obter mais informações, consulte Criar índices filtrados.

-FC

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

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

-FK keep_existing_option

Especifica quais estruturas de projeto físico existentes 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 físicas de design (índices e exibições indexadas) que o dta propõe devem ser particionadas e como elas devem ser particionadas. A tabela a seguir lista e descreve os valores que podem ser especificados para esse argumento:

ALIGNED significa que, na recomendação gerada pela dta , cada índice proposto é particionado exatamente da mesma forma que a tabela subjacente para a qual o índice é definido. Os índices não clusterizados em um modo de exibição indexado são alinhados com o modo de exibição indexado. Apenas um valor pode ser especificado para este argumento. A predefinição é -fp NONE.

-FX drop_only_mode

Especifica que o dta considera apenas a eliminação de estruturas de projeto físico existentes. Não são consideradas novas estruturas de projeto físico. Quando esta opção é especificada, o dta avalia a utilidade das estruturas de projeto físico existentes e recomenda a eliminação de estruturas raramente usadas. Este argumento não aceita valores. Ele não pode ser usado com os -faargumentos , -fp, ou -fk ALL

- ID session_ID

Especifica um identificador numérico para a sessão de ajuste. Se não for especificado, o dta gerará um número de ID. 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 do plano é usado como a carga de trabalho. Os 1.000 principais eventos de cache de plano para bancos de dados explicitamente selecionados são analisados. Este valor pode ser alterado usando a -n opção.

-QI

Especifica que o Repositório de Consultas é usado como carga de trabalho. Os 1.000 principais eventos do Repositório de Consultas para bancos de dados explicitamente selecionados são analisados. Este valor pode ser alterado usando a -n opção. Para obter mais informações, consulte Como o Repositório de Consultas coleta dados e Ajustando 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 (arquivoTransact-SQL) ou .log (arquivo de rastreamento do SQL Server). Um arquivo de carga de trabalho ou uma tabela de carga de trabalho deve ser especificado.

- workload_trace_table_name

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

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

-ix input_XML_file_name

Especifica o nome do arquivo XML que contém informações de entrada dta . Este documento XML deve conformar-se ao DTASchema.xsd esquema. Argumentos conflitantes especificados no prompt de comando para opções de ajuste substituem o valor correspondente neste arquivo XML. A única exceção é se uma configuração especificada pelo usuário for inserida no 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 quaisquer opções de ajuste inseridas no prompt de comando.

-k maxtotalindexes

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

-K índices totais máximos

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

- minimum_improvement

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

-N opção_online

Especifica se as estruturas físicas de design são criadas online. A tabela a seguir lista e descreve os valores que você pode especificar para esse argumento:

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

-n número_de_eventos

Especifica o número de eventos na carga de trabalho que o 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, o dta ajustará os eventos em ordem decrescente de duração. Este argumento é útil para comparar duas configurações de estruturas de projeto físico. Para comparar duas configurações, especifique o mesmo número de eventos a afinar para ambas as configurações e depois especifique um tempo de afinação ilimitado para ambas, também da seguinte forma:

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 um tempo de ajuste de 8 horas por padrão.

-l time_window_in_hours

Especifica a janela temporal (em horas) em que uma consulta deve ter sido executada para ser considerada para otimização ao usar -iq opção (Workload from Query Store).

dta -iq -l 48

Nesse caso, o DTA usa o Repositório de Consultas como a fonte 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 do arquivo e no destino especificados.

Você pode usar -F com esta opção. Certifique-se de que o nome do ficheiro é exclusivo, especialmente se também estiver a utilizar -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, dta usa o nome da sessão para gerar o nome do arquivo e grava-lo no diretório atual.

Você pode usar -F com esta opção. Certifique-se de que o nome do ficheiro é exclusivo, especialmente se também estiver a utilizar -of e -ox.

-output_XML_file_name de boi

Especifica que dta grava a recomendação como um arquivo XML no nome do arquivo e no destino fornecidos. Certifique-se de que o Orientador de Otimização do Motor de Base de Dados tem as permissões para gravar no diretório de destino.

Você pode usar -F com esta opção. Certifique-se de que o nome do ficheiro é exclusivo, especialmente se também estiver a utilizar -of e -or.

-Senha P

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

-q

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

-RL analysis_report_list

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

Especifique vários relatórios separando os valores por vírgulas, por exemplo:

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

-S server_name [ \instância ]

Especifica o nome do computador e da instância do SQL Server aos quais se conectar. Se nenhum server_name for especificado, dta se conectará à instância padrão do SQL Server no computador local. Essa opção é necessária ao se conectar a uma instância nomeada ou ao executar dta a partir de um computador remoto na rede.

-s session_name

Especifica o nome da sessão de ajuste. Isso é 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 serem ajustadas. Cada tabela listada no arquivo deve começar em uma nova linha. Os nomes das tabelas devem ser qualificados com nomenclatura em três partes, por exemplo, AdventureWorks2022.HumanResources.Department. Opcionalmente, para invocar o recurso de dimensionamento de tabela, o nome de uma tabela existente pode ser seguido por um número indicando o número projetado de linhas na tabela. O Orientador de Otimização do Mecanismo de Banco de Dados leva em consideração o número projetado de linhas ao ajustar ou avaliar instruções na carga de trabalho que fazem referência a essas tabelas. Pode haver um ou mais espaços entre a contagem de number_of_rows e o 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 utilize um ficheiro de lista de tabelas (-Tf) se estiver a utilizar -Tlo . Se ambos os argumentos forem usados, dta falhará e retornará um erro.

Se os -Tf argumentos e -Tl 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 das tabelas para separá-las. Se apenas um banco de dados for especificado com o argumento, os nomes das tabelas não precisarão ser qualificados com um nome de -D banco de dados. Caso contrário, o nome totalmente qualificado no formato: database_name.schema_name.table_name é necessário para cada tabela.

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

- Tu login_id

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

-u

Inicia a interface gráfica do Orientador de Otimização do Motor de Base de Dados. Todos os parâmetros são tratados como as configurações iniciais para a interface do usuário.

-x

Inicia a sessão de ajuste e sai.

Observações

Pressione Ctrl+C uma vez para parar a sessão de afinação e gerar recomendações, com base na análise que o dta realizou até agora. 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. Ajustar uma carga de trabalho que inclua índices e exibições indexadas em sua recomendação

Este exemplo usa uma conexão segura (-E) para se conectar ao tpcd1G banco de dados em 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, então o dta sobrescreve o ficheiro porque o -F argumento foi especificado. A sessão de ajuste é executada por um período ilimitado de tempo para garantir uma análise completa da carga de trabalho (-A 0). A recomendação deve prever uma melhoria mínima de 5% (-m 5). A DTA deve incluir índices e visualizaçõ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. Limitar o uso do 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. Funciona por não mais de 1 hora (-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 ajustadas

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 estejam ajustadas, especifique um tempo de ajuste ilimitado com -A 0. Se o tempo for importante, especifique um limite de tempo apropriado especificando o número de minutos disponíveis para ajuste com o -A argumento, conforme mostrado neste exemplo.

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

D. Ajustar tabelas específicas listadas em um arquivo

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

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

O conteúdo do table_list.txt especifica que:

• Somente o Customer, Storee Product as tabelas no banco de dados devem ser ajustados.

• Presume-se que o número de linhas nas Customer tabelas e Product seja 100.000 e 2.000.000, respectivamente.

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

  Pode haver um ou mais espaços entre o número de linhas contadas 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. Liga-te a um ficheiro de carga de trabalho, sobrescreve o ficheiro de saída, com opções de ajuste

Este exemplo mostra como se ligar sem encriptação, incluir com um ficheiro de workload, sobrescrever o ficheiro de saída, ajustar durante 60 minutos, com 5% de melhoria, e apenas indexar. Substitua <server> e <database> por 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 é igual ao comando anterior, mas com encriptação de ligação. Substitua <server> e <database> por 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)
• Orientador de Otimização do Mecanismo de Banco de Dados