dta (utilitaire)

S'applique à :SQL Server

L'utilitaire dta constitue la version d'invite de commandes de l'Assistant Paramétrage du moteur de base de données. L'utilitaire dta est conçu pour permettre l'utilisation de l'Assistant Paramétrage du moteur de base de données dans des applications et des scripts.

À l'instar de l'Assistant Paramétrage du moteur de base de données, l'utilitaire dta analyse une charge de travail et recommande des PDS (Physical Design Structures) pour améliorer les performances du serveur pour cette charge de travail. La charge de travail peut être un cache du plan, un fichier de trace ou une table du SQL Server Profiler , ou un script Transact-SQL. Les PDS incluent des index, des vues indexées et un partitionnement.

Une fois que l’utilitaire dta analyse une charge de travail, il produit une recommandation pour la conception physique des bases de données et peut générer le script nécessaire pour implémenter la recommandation. Les charges de travail peuvent être spécifiées à partir de l’invite de commandes avec l’argument -if ou l’argument -it . Vous pouvez également spécifier un fichier d’entrée XML à partir de l’invite de commandes avec l’argument -ix . Dans ce cas, la charge de travail est spécifiée dans le fichier d'entrée XML.

Syntaxe

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

Les arguments

-?

Affiche des informations sur l’utilisation.

-A temps_de_syntonisation_en_minutes

Spécifie la limite de durée de réglage en minutes. dta utilise la limite de temps spécifiée pour régler la charge de travail et générer un script avec les modifications de conception physique recommandées. Par défaut, dta utilise une durée de réglage de 8 heures. La spécification de 0 permet une durée de réglage illimitée. dta pourra éventuellement achever le réglage de toute la charge de travail avant l'expiration de la limite de durée. Cependant, pour vous assurer que toute la charge de travail est réglée, nous vous recommandons de spécifier une durée de réglage illimitée (-A 0).

-a

Règle la charge de travail et applique la recommandation sans vous demander de confirmation.

-B taille_de_stockage

Spécifie l'espace maximal (en mégaoctets) pouvant être consommé par l'index et le partitionnement recommandés. Lorsque plusieurs bases de données sont paramétrées, les recommandations pour toutes les bases de données sont prises en compte pour le calcul de l'espace. Par défaut, dta utilise la plus petite des tailles de stockage suivantes :

• Le triple de la taille actuelle des données brutes, qui inclut la taille totale des segments et les index cluster des tables de la base de données.

• L'espace libre disponible sur tous les lecteurs de disques connectés, plus la taille des données brutes.

La taille de stockage par défaut n’inclut pas les index non cluster et les vues indexées.

-C max_columns_in_index

Spécifie le nombre maximal de colonnes dans les index proposés par dta . La valeur maximale est 1024. Par défaut, cet argument a la valeur 16.

-c colonnes_maximales_clés_dans_index

Spécifie le nombre maximal de colonnes clés dans les index proposés par dta . La valeur par défaut est 16 (valeur maximale autorisée). dta peut également créer des index avec des colonnes incluses. Les index recommandés avec les colonnes incluses peuvent dépasser le nombre de colonnes spécifiées dans cet argument.

-ce connection_encrypt_option

S’applique à : SQL Server 2025 (17.x) et versions ultérieures

Spécifie que la connexion est chiffrée entre le serveur et le client. Les valeurs possibles sont yes, noetstrict. L’option par défaut est yes. Pour plus d’informations, consultez TDS 8.0.

-Tc

S’applique à : SQL Server 2025 (17.x) et versions ultérieures

Spécifie s’il faut approuver le certificat de serveur. Ce paramètre est facultatif, similaire à HostnameInCertificate celui utilisé dans d’autres outils et chaînes de connexion.

Pour plus d’informations, consultez TDS 8.0.

-hc hostname_in_certificate

S’applique à : SQL Server 2025 (17.x) et versions ultérieures

Spécifie un CN ou SAN différent, attendu dans le certificat de serveur, à utiliser lors de la validation du certificat de serveur. Pour plus d’informations, consultez TDS 8.0.

-D database_name

Spécifie le nom de chaque base de données à paramétrer. La première base de données est la base de données par défaut. Vous pouvez spécifier plusieurs bases de données en séparant les noms de bases de données avec des virgules, par exemple :

dta -D database_name1, database_name2...

Vous pouvez également spécifier plusieurs bases de données à l’aide de l’argument -D de chaque nom de base de données, par exemple :

dta -D database_name1 -D database_name2... n

L’argument -D est obligatoire. Si l’argument -d n’est pas spécifié, dta se connecte initialement à la base de données spécifiée avec la première USE database_name clause de la charge de travail. S’il n’existe pas de clause explicite USE database_name dans la charge de travail, vous devez utiliser l’argument -d .

Par exemple, si vous avez une charge de travail qui ne contient aucune clause explicite USE database_name et que vous utilisez la commande dta suivante, une recommandation n’est pas générée :

dta -D db_name1, db_name2...

Toutefois, si vous utilisez la même charge de travail et que vous utilisez la commande dta suivante qui utilise l’argument -d , une recommandation est générée :

dta -D db_name1, db_name2 -d db_name1

-d database_name

Spécifie la première base de données à laquelle dta se connecte lors du paramétrage d’une charge de travail. Une seule base de données peut être spécifiée pour cet argument. Par exemple :

dta -d AdventureWorks2022 ...

Si plusieurs noms de bases de données sont spécifiés, dta retourne une erreur. L’argument -d est facultatif.

Si vous utilisez un fichier d’entrée XML, vous pouvez spécifier la première base de données à laquelle dta se connecte à l’aide de l’élément DatabaseToConnect situé sous l’élément TuningOptions . Pour plus d'informations, consultez Database Engine Tuning Advisor.

Si vous ne paramétrez qu’une seule base de données, l’argument -d fournit des fonctionnalités similaires à l’argument de l’utilitaire -dsqlcmd , mais il n’exécute pas l’instruction USEdatabase_name . Pour plus d'informations, consultez sqlcmd Utility.

-E

Utilise une connexion approuvée au lieu de demander un mot de passe. L’argument ou l’argument -E-U , qui spécifie un ID de connexion, doit être utilisé.

-e tuning_log_name

Spécifie le nom de la table ou du fichier dans lequel dta enregistre les événements qu’il n’a pas pu régler. La table est créée sur le serveur où le réglage est effectué.

Si une table est employée, spécifiez son nom selon le format : [database_name].[owner_name].table_name. Le tableau suivant indique les valeurs par défaut de chaque paramètre :

Si un fichier est utilisé, spécifiez .xml son extension. Par exemple : TuningLog.xml.

-F

Permet à dta de remplacer un fichier de sortie existant. Si un fichier de sortie portant le même nom existe déjà et -F n’est pas spécifié, dta retourne une erreur. Vous pouvez utiliser -F avec -of, -orou -ox.

-fa structures_de_conception_physique_à_ajouter

Spécifie les types de PDS (Physical Design Structures) que dta doit inclure dans la recommandation. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument. Quand aucune valeur n’est spécifiée, dta utilise la valeur par défaut -fa IDX.

-Fi

Spécifie que les index filtrés soient considérés pour de nouvelles recommandations. Pour plus d’informations, consultez Créer des index filtrés.

-Fc

Spécifie que les index columnstore doivent être pris en compte pour les nouvelles suggestions. DTA prend en compte les index columnstore cluster et non cluster. Pour plus d’informations, consultez les recommandations d’index Columnstore dans l’Assistant Paramétrage du moteur de base de données (DTA).

S’applique à : SQL Server 2016 (13.x) et versions ultérieures.

-fk keep_existing_option

Spécifie les structures PDS (Physical Design Structures) que dta doit conserver lors de la génération de sa recommandation. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument :

-fp stratégie_de_partitionnement

Spécifie si les nouvelles PDS (Physical Design Structures) (index et vues indexées) que dta propose doivent être partitionnées et de quelle manière. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument :

ALIGNED signifie que, dans la recommandation générée par dta , chaque index proposé est partitionné exactement de la même façon que la table sous-jacente pour laquelle l’index est défini. Les index non-cluster sur une vue indexée sont alignés avec la vue indexée. Une seule valeur peut être spécifiée pour cet argument. La valeur par défaut est -fp NONE.

-fx drop_only_mode

Spécifie que dta considère uniquement la suppression des PDS (Physical Design Structures) existantes. Aucune nouvelle structure de conception physique n'est envisagée. Lorsque cette option est spécifiée, dta évalue l'utilité des PDS (Physical Design Structures) existantes et recommande la suppression des structures rarement utilisées. Cet argument ne prend aucune valeur. Il ne peut pas être utilisé avec les arguments ou -fa-fples -fk ALLarguments

-ID session_ID

Spécifie un identificateur numérique pour la session de réglage. Si ce paramètre n'est pas spécifié, dta génère un numéro d'identification. Vous pouvez utiliser cet identificateur pour afficher des informations pour des sessions de réglage existantes. Si vous ne spécifiez pas de valeur pour -ID, un nom de session doit être spécifié avec -s.

-Ip

Spécifie que le cache de plan est utilisé comme charge de travail. Les 1 000 premiers événements du cache du plan pour les bases de données explicitement sélectionnées sont analysés. Cette valeur peut être modifiée à l’aide de l’option -n .

-QI

Spécifie que le Magasin des requêtes est utilisé comme charge de travail. Les 1 000 premiers événements du Magasin des requêtes pour les bases de données explicitement sélectionnées sont analysés. Cette valeur peut être modifiée à l’aide de l’option -n . Pour plus d’informations, consultez la façon dont le Magasin des requêtes collecte des données et paramétrage de la base de données à l’aide de la charge de travail à partir du magasin de requêtes avec l’Assistant Paramétrage du moteur de base de données.

S’applique à : SQL Server 2016 (13.x) et versions ultérieures.

-if workload_file

Spécifie le chemin d'accès et le nom du fichier de charge de travail à utiliser comme entrée pour le réglage. Le fichier doit se trouver dans l’un de ces formats : .trc (fichier de trace SQL Server Profiler), .sql (Transact-SQL fichier) ou .log (fichier de trace SQL Server). Un fichier de charge de travail ou une table de charge de travail doit être spécifié.

-it workload_trace_table_name

Spécifie le nom de la table contenant la trace de charge de travail pour le réglage. Le nom est spécifié au format : [database_name]. [owner_name]. table_name.

Le tableau suivant indique les valeurs par défaut de chaque paramètre :

-ix input_XML_file_name

Spécifie le nom du fichier XML contenant les informations d’entrée dta . Ce document XML doit être conforme au DTASchema.xsd schéma. Les arguments conflictuels spécifiés à partir de l'invite de commandes pour les options de réglage remplacent la valeur correspondante dans ce fichier XML. Une seule exception : configuration spécifiée par l'utilisateur entrée dans le mode évaluation dans le fichier d'entrée XML. Par exemple, si une configuration est entrée dans l’élément Configuration du fichier d’entrée XML et que l’élément EvaluateConfiguration est également spécifié comme l’une des options de paramétrage, les options de réglage spécifiées dans le fichier d’entrée XML remplacent toutes les options de paramétrage entrées à partir de l’invite de commandes.

-k maxtotalindexes

Nombre maximal d'index dans la recommandation.

-K maxtotalindexes

Nombre maximal d'index par table.

-m amélioration_minimale

Spécifie le pourcentage minimal d'amélioration que la configuration recommandée doit satisfaire.

-N option_en_ligne

Spécifie si des PDS (Physical Design Structures) sont créées en ligne. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument :

Si des index sont créés en ligne, ONLINE = ON est ajouté à sa définition d’objet.

-n nombre_d'événements

Spécifie le nombre d’événements dans la charge de travail que dta doit optimiser. Si cet argument est spécifié et si la charge de travail est un fichier de trace qui contient des informations de durée, dta règle les événements en ordre décroissant de durée. Cet argument est utile pour comparer deux configurations de PDS. Pour comparer deux configurations, spécifiez le même nombre d’événements à régler pour les deux configurations, puis spécifiez une durée de réglage illimitée pour les deux également comme suit :

dta -n number_of_events -A 0

Dans ce cas, il est important de spécifier un temps de réglage illimité (-A 0). Sinon, l'Assistant Paramétrage du moteur de base de données utilise par défaut une durée de réglage de 8 heures.

-l fenêtre_temporelle_en_heures

Spécifie la fenêtre de temps (en heures) où une requête doit être exécutée pour être prise en compte pour l'optimisation lors de l'utilisation de l'option -iq (Charge de travail à partir du Magasin des requêtes).

dta -iq -l 48

Dans ce cas, DTA utilise le Magasin des requêtes comme source de charge de travail et considère uniquement les requêtes qui ont été exécutées au cours des 48 dernières heures.

S’applique à : SQL Server 2016 (13.x) et versions ultérieures.

-of output_script_file_name

Spécifie que dta écrit la recommandation sous forme de script Transact-SQL sous le nom de fichier et à la destination spécifiés.

Vous pouvez utiliser -F cette option. Assurez-vous que le nom de fichier est unique, en particulier si vous utilisez -or également et -ox.

-ou output_xml_report_file_name

Spécifie que dta écrit la recommandation dans un rapport de sortie XML. Si un nom de fichier est fourni, les recommandations sont écrites dans cette destination. Sinon, dta utilise le nom de session pour générer le nom de fichier et l'écrit dans le répertoire en cours.

Vous pouvez utiliser -F cette option. Assurez-vous que le nom de fichier est unique, en particulier si vous utilisez -of également et -ox.

-ox output_XML_file_name

Spécifie que dta écrit la recommandation sous forme de fichier XML sous le nom de fichier et à la destination fournis. Vérifiez que l'Assistant Paramétrage du moteur de base de données possède des autorisations d'écriture dans le répertoire de destination.

Vous pouvez utiliser -F cette option. Assurez-vous que le nom de fichier est unique, en particulier si vous utilisez -of également et -or.

-P password

Spécifie le mot de passe de l’ID de connexion . Si cette option n’est pas utilisée, dta demande un mot de passe.

-q

Active le mode silencieux. Aucune information n'est écrite sur la console, notamment les informations de progression et d'en-tête.

-rl liste_rapport_analyse

Spécifie la liste des rapports d'analyse à générer. Le tableau suivant répertorie les valeurs pouvant être spécifiées pour cet argument :

Spécifiez plusieurs rapports en séparant les valeurs avec des virgules, par exemple :

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

-S server_name [ \instance ]

Spécifie le nom de l'ordinateur et de l'instance de SQL Server auxquels la connexion doit être établie. Si la valeur de server_name n’est pas spécifiée, dta se connecte à l’instance par défaut de SQL Server sur l’ordinateur local. Cette option est requise lors de la connexion à une instance nommée ou de l'exécution de dta à partir d'un ordinateur distant sur le réseau.

-s session_name

Spécifie le nom de la session de réglage. Cela est obligatoire s’il -ID n’est pas spécifié.

-Tf table_list_file

Spécifie le nom du fichier contenant la liste des tables à paramétrer. Chaque table listée à l'intérieur du fichier doit commencer sur une nouvelle ligne. Les noms de table doivent être qualifiés avec un nommage en trois parties, par exemple AdventureWorks2022.HumanResources.Department. Éventuellement, pour invoquer la fonctionnalité de dimensionnement d'une table, le nom d'une table existante peut être suivi par un nombre indiquant le nombre de lignes prévues pour cette table. L'Assistant Paramétrage du moteur de base de données tient compte du nombre prévu de lignes lors du réglage ou de l'évaluation des instructions dans la charge de travail faisant référence à ces tables. Il peut y avoir un ou plusieurs espaces entre le nombre de number_of_rows et le table_name.

Il s’agit du format de fichier pour 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]

Cet argument est une alternative à l’entrée d’une liste de tables à l’invite de commandes (-Tl). N’utilisez pas de fichier de liste de tables (-Tf) si vous utilisez -Tl. Si les deux arguments sont employés, dta échoue et retourne une erreur.

Si les arguments et -Tf les -Tl arguments sont omis, toutes les tables utilisateur des bases de données spécifiées sont prises en compte pour le réglage.

-Tl table_list

Spécifie à l'invite de commandes une liste de tables à régler. Placez des virgules entre les noms de table pour les séparer. Si une seule base de données est spécifiée avec l’argument -D , les noms de table n’ont pas besoin d’être qualifiés avec un nom de base de données. Sinon, le nom complet au format : database_name.schema_name.table_name est obligatoire pour chaque table.

Cet argument est une alternative à l’utilisation d’un fichier de liste de tables (-Tf). Si les deux -Tl et -Tf sont utilisés, dta échoue et retourne une erreur.

-U login_id

Spécifie l'ID de connexion utilisé pour une connexion à SQL Server.

-u

Lance l'Assistant Paramétrage du moteur de base de données. Tous les paramètres sont traités comme les paramètres initiaux de l'interface utilisateur.

-x

Démarre une session de réglage et quitte.

Remarques

Appuyez une fois sur Ctrl+C pour arrêter la session de réglage et générer des recommandations, en fonction de l’analyse dta terminée jusqu’à ce stade. Vous êtes invité à décider si vous souhaitez générer des recommandations ou non. Appuyez de nouveau sur Ctrl+C pour arrêter la session de réglage sans générer de recommandations.

Exemples

R. Ajuster une charge de travail qui inclut des index et des vues indexées dans sa suggestion

Cet exemple utilise une connexion sécurisée (-E) pour se connecter à la tpcd1G base de données sur MyServer pour analyser une charge de travail et créer des recommandations. Il écrit la sortie dans un fichier de script nommé script.sql. S’il script.sql existe déjà, dta remplace le fichier, car l’argument -F a été spécifié. La session de réglage se poursuit pendant une durée illimitée pour garantir l'analyse complète de la charge de travail (-A 0). La recommandation doit fournir une amélioration minimale de 5 % (-m 5). dta doit inclure des index et des vues indexées dans sa recommandation finale (-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. Limitation de l'utilisation du disque

Cet exemple limite la taille totale de la base de données, qui inclut les données brutes et les index supplémentaires, à 3 gigaoctets (Go) et-B 3000 dirige la sortie vers d:\result_dir\script1.sql. Il ne dépasse pas une heure (-A 60).

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

Chapitre C. Limitation du nombre de requêtes paramétrables

Cet exemple limite le nombre de requêtes lues à partir du fichier orders_wkld.sql à un maximum de 10 (-n 10) et s’exécute pendant 15 minutes (-A 15), selon le cas en premier. Pour être certain que toutes les 10 requêtes sont réglées, spécifiez une durée de réglage illimitée avec -A 0. Si le temps est important, spécifiez une limite de temps appropriée en spécifiant le nombre de minutes disponibles pour le réglage avec l'argument -A comme l'illustre cet exemple.

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

D. Réglage de tables spécifiques répertoriées dans un fichier

Cet exemple illustre l’utilisation de table_list_file (l’argument -Tf ). Le contenu du fichier table_list.txt est le suivant :

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

Le contenu de table_list.txt spécifie que :

• Seules les tables Customeret Store les Producttables de la base de données doivent être paramétrées.

• Le nombre de lignes dans les tables et Customer de Product 100 000 et 2 000 000, respectivement.

• Le nombre de lignes de Store la table est supposé être le nombre actuel de lignes de la table.

  Il peut y avoir un ou plusieurs espaces entre le nombre de lignes et le nom de la table précédente dans le table_list_file.

  La durée de réglage est de 2 heures (-A 120) et la sortie est écrite dans un fichier XML (-ox XMLTune.xml).

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

E. Se connecter avec un fichier de charge de travail, remplacer le fichier de sortie, avec des options de réglage

Cet exemple montre comment se connecter sans chiffrement, inclure avec un fichier de charge de travail, remplacer le fichier de sortie, régler pendant 60 minutes, avec 5% amélioration et uniquement des index. Remplacez <server> et <database> par des valeurs valides.

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

Cet exemple est identique à la commande précédente, mais avec le chiffrement de connexion. Remplacez <server> et <database> par des valeurs valides.

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

Contenu connexe

• Utilitaires de ligne de commande SQL (moteur de base de données)
• Conseiller d'optimisation du moteur de base de données