dta (utilitaire)dta Utility

L'utilitaire dta constitue la version d'invite de commandes de l'Assistant Paramétrage du moteur de base de données.The dta utility is the command prompt version of Database Engine Tuning Advisor. 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.The dta utility is designed to allow you to use Database Engine Tuning Advisor functionality in applications and 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.Like Database Engine Tuning Advisor, the dta utility analyzes a workload and recommends physical design structures to improve server performance for that workload. La charge de travail peut être un cache du plan, un fichier de trace ou une table du SQL Server ProfilerSQL Server Profiler , ou un 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. Les PDS incluent des index, des vues indexées et un partitionnement.Physical design structures include indexes, indexed views, and partitioning. Après l'analyse d'une charge de travail, l'utilitaire dta produit une recommandation pour la conception physique des bases de données et peut générer le script nécessaire pour la mise en œuvre de la recommandation.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. Des charges de travail peuvent être spécifiées à partir de l’invite de commandes avec l’argument -if ou -it .Workloads can be specified from the command prompt with the -if or the -it argument. Vous pouvez aussi spécifier un fichier d’entrée XML à partir de l’invite de commandes avec l’argument -ix .You can also specify an XML input file from the command prompt with the -ix argument. Dans ce cas, la charge de travail est spécifiée dans le fichier d'entrée XML.In that case, the workload is specified in the XML input file.

SyntaxeSyntax


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

ArgumentsArguments

-?-?
Affiche les informations d'utilisation.Displays usage information.

-A time_for_tuning_in_minutes-A time_for_tuning_in_minutes
Spécifie la limite de durée de réglage en minutes.Specifies the tuning time limit in 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.dta uses the specified amount of time to tune the workload and generate a script with the recommended physical design changes. Par défaut, dta utilise une durée de réglage de 8 heures.By default dta assumes a tuning time of 8 hours. Si la valeur 0 est spécifiée, la durée de réglage est illimitée.Specifying 0allows unlimited tuning time. dta pourra éventuellement achever le réglage de toute la charge de travail avant l'expiration de la limite de durée.dta might finish tuning the entire workload before the time limit expires. 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).However, to make sure that the entire workload is tuned, we recommend that you specify unlimited tuning time (-A 0).

-a-a
Règle la charge de travail et applique la recommandation sans vous demander de confirmation.Tunes workload and applies the recommendation without prompting you.

-B storage_size-B storage_size
Spécifie l'espace maximal (en mégaoctets) pouvant être consommé par l'index et le partitionnement recommandés.Specifies the maximum space in megabytes that can be consumed by the recommended index and partitioning. 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.When multiple databases are tuned, recommendations for all databases are considered for the space calculation. Par défaut, dta utilise la plus petite des tailles de stockage suivantes :By default, dta assumes the smaller of the following storage sizes:

  • 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.Three times the current raw data size, which includes the total size of heaps and clustered indexes on tables in the database.

  • L'espace libre disponible sur tous les lecteurs de disques connectés, plus la taille des données brutes.The free space on all attached disk drives plus the raw data size.

    La taille de stockage par défaut ne comprend pas les index non-cluster et les vues indexées.The default storage size does not include nonclustered indexes and indexed views.

    -C max_columns_in_index-C max_columns_in_index
    Spécifie le nombre maximal de colonnes dans les index proposés par dta .Specifies the maximum number of columns in indexes that dta proposes. La valeur maximale est 1024.The maximum value is 1024. Par défaut, cet argument a la valeur 16.By default, this argument is set to 16.

    -c max_key_columns_in_index-c max_key_columns_in_index
    Spécifie le nombre maximal de colonnes clés dans les index proposés par dta .Specifies the maximum number of key columns in indexes that dta proposes. La valeur par défaut est 16 (valeur maximale autorisée).The default value is 16, the maximum value allowed. dta peut également créer des index avec des colonnes incluses.dta also considers creating indexes with included columns. Les index recommandés avec des colonnes incluses peuvent dépasser le nombre de colonnes spécifiées dans cet argument.Indexes recommended with included columns may exceed the number of columns specified in this argument.

    -D database_name-D database_name
    Spécifie le nom de chaque base de données à paramétrer.Specifies the name of each database that is to be tuned. La première base de données est la base de données par défaut.The first database is the default database. Vous pouvez spécifier plusieurs bases de données en séparant les noms de bases de données avec des virgules, par exemple :You can specify multiple databases by separating the database names with commas, for example:

dta –D database_name1, database_name2...  

Vous pouvez également spécifier plusieurs bases de données en utilisant l'argument -D pour chaque nom de base de données, par exemple :Alternatively, you can specify multiple databases by using the –D argument for each database name, for example:

dta –D database_name1 -D database_name2... n  

L’argument -D est obligatoire.The -D argument is mandatory. Si l’argument -d n’a pas été spécifié, dta se connecte initialement à la base de données qui a été spécifiée avec la première clause USE database_name dans la charge de travail.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. Si la charge de travail ne comporte pas de clause USE database_name explicite, vous devez utiliser l’argument -d .If there is not explicit USE database_name clause in the workload, you must use the -d argument.

Par exemple, si vous avez une charge de travail qui ne contient pas de clause USE database_name explicite et si vous utilisez la commande dta suivante, aucune recommandation n'est générée :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...  

Mais si vous utilisez la même charge de travail et employez la commande dta suivante qui utilise l’argument -d , une recommandation est générée :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
Spécifie la première base de données à laquelle dta se connecte lors du paramétrage d’une charge de travail.Specifies the first database to which dta connects when tuning a workload. Une seule base de données peut être spécifiée pour cet argument.Only one database can be specified for this argument. Exemple :For example:

dta -d AdventureWorks2012 ...  

Si plusieurs noms de bases de données sont spécifiés, dta retourne une erreur.If multiple database names are specified, then dta returns an error. L’argument -d est facultatif.The -d argument is optional.

Si vous utilisez un fichier d'entrée XML, vous pouvez spécifier la première base de données à laquelle dta se connecte en utilisant l'élément DatabaseToConnect qui se trouve sous l'élément 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. Pour plus d'informations, consultez Database Engine Tuning Advisor.For more information, see Database Engine Tuning Advisor.

Si vous ne réglez qu’une seule base de données, l’argument -d fournit une fonctionnalité similaire à l’argument -d de l’utilitaire sqlcmd , mais il n’exécute pas l’instruction 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. Pour plus d'informations, consultez sqlcmd Utility.For more information, see sqlcmd Utility.

-E-E
Utilise une connexion approuvée au lieu de demander un mot de passe.Uses a trusted connection instead of requesting a password. L’argument -E ou l’argument -U , qui spécifie un ID de connexion, doit être utilisé.Either the -E argument or the -U argument, which specifies a login ID, must be used.

-e tuning_log_name-e tuning_log_name
Spécifie le nom de la table ou du fichier où dta enregistre les événements qu’il n’a pas pu régler.Specifies the name of the table or file where dta records events that it could not tune. La table est créée sur le serveur où le réglage est effectué.The table is created on the server where the tuning is performed.

Si une table est employée, spécifiez son nom selon le format : [database_name].[owner_name].table_name.If a table is used, specify its name in the format: [database_name].[owner_name].table_name. Le tableau suivant indique les valeurs par défaut de chaque paramètre :The following table shows the default values for each parameter:

ParamètreParameter Valeur par défautDefault value DétailsDetails
database_namedatabase_name database_name spécifié avec l’option –Ddatabase_name specified with the –D option
owner_nameowner_name dbodbo owner_name doit avoir la valeur dbo.owner_name must be dbo. Si une autre valeur est spécifiée, l'exécution de dta échoue et il retourne une erreur.If any other value is specified, then dta execution fails and it returns an error.
table_nametable_name AucuneNone

Si un fichier est utilisé, spécifiez .xml comme extension.If a file is used, specify .xml as its extension. Par exemple, TuningLog.xml.For example, TuningLog.xml.

Note

L’utilitaire dta ne supprime pas le contenu des tables du journal de paramétrage définies par l’utilisateur si la session est supprimée.The dta utility does not delete the contents of user-specified tuning log tables if the session is deleted. Il est recommandé de spécifier une table pour le journal de paramétrage quand vous réglez des charges de travail très importantes.When tuning very large workloads, we recommend that a table be specified for the tuning log. Le paramétrage de charges de travail importantes pouvant engendrer des journaux de paramétrage volumineux, il est plus rapide d'effacer les sessions lorsqu'une table est utilisée.Since tuning large workloads can result in large tuning logs, the sessions can be deleted much faster when a table is used.

-F-F
Permet à dta de remplacer un fichier de sortie existant.Permits dta to overwrite an existing output file. Si un fichier de sortie de même nom existe déjà et si -F n’est pas spécifié, dtaretourne une erreur.If an output file with the same name already exists and -F is not specified, dtareturns an error. Vous pouvez utiliser -F avec -of, -orou -ox.You can use -F with -of, -or, or -ox.

-fa physical_design_structures_to_add-fa physical_design_structures_to_add
Spécifie les types de PDS (Physical Design Structures) que dta doit inclure dans la recommandation.Specifies what types of physical design structures dta should include in the recommendation. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument.The following table lists and describes the values that can be specified for this argument. Si aucune valeur n’est spécifiée, dta utilise la valeur par défaut faIDX.When no value is specified, dta uses the default -faIDX.

ValeurValue DescriptionDescription
IDX_IVIDX_IV Index et vues indexées.Indexes and indexed views.
IDXIDX Index uniquement.Indexes only.
IVIV Vues indexées uniquement.Indexed views only.
NCL_IDXNCL_IDX Index non-cluster uniquement.Nonclustered indexes only.

-fi-fi
Spécifie que les index filtrés soient considérés pour de nouvelles recommandations.Specifies that filtered indexes be considered for new recommendations. Pour plus d'informations, consultez Create Filtered Indexes.For more information, see Create Filtered Indexes.

-fc-fc
Spécifie que les index columnstore soient considérés pour de nouvelles recommandations.Specifies that columnstore indexes be considered for new recommendations. DTA prend en compte les index cluster et non cluster columnstore.DTA will consider both clustered and non-clustered columnstore indexes. Pour plus d'informations, consultezFor more information, see
Recommandations d’index ColumnStore dans base de données Engine Tuning Advisor (DTA).Columnstore index recommendations in Database Engine Tuning Advisor (DTA). ||
|-|
|S'applique à: SQL Server 2016SQL Server 2016 jusqu'à 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
Spécifie les structures PDS (Physical Design Structures) que dta doit conserver lors de la génération de sa recommandation.Specifies what existing physical design structures dta must retain when generating its recommendation. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument :The following table lists and describes the values that can be specified for this argument:

ValeurValue DescriptionDescription
AucuneNONE Aucune structure existanteNo existing structures
ALLALL Toutes les structures existantesAll existing structures
ALIGNEDALIGNED Toutes les structures alignées sur les partitions.All partition-aligned structures.
CL_IDXCL_IDX Tous les index cluster sur les tablesAll clustered indexes on tables
IDXIDX Tous les index cluster et non-cluster sur les tablesAll clustered and nonclustered indexes on tables

-fp partitioning_strategy-fp partitioning_strategy
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.Specifies whether new physical design structures (indexes and indexed views) that dta proposes should be partitioned, and how they should be partitioned. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument :The following table lists and describes the values that can be specified for this argument:

ValeurValue DescriptionDescription
AucuneNONE Aucun partitionnementNo partitioning
FULLFULL Partitionnement complet (choisissez cette option pour améliorer les performances)Full partitioning (choose to enhance performance)
ALIGNEDALIGNED Partitionnement aligné seulement (choisissez cette valeur pour simplifier la gestion)Aligned partitioning only (choose to enhance manageability)

ALIGNED signifie que dans la recommandation générée par dta , chaque index proposé est partitionné exactement de la même manière que la table sous-jacente pour laquelle l'index est défini.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. Les index non-cluster sur une vue indexée sont alignés avec la vue indexée.Nonclustered indexes on an indexed view are aligned with the indexed view. Une seule valeur peut être spécifiée pour cet argument.Only one value can be specified for this argument. La valeur par défaut est -fpNONE.The default is -fpNONE.

-fx drop_only_mode-fx drop_only_mode
Spécifie que dta considère uniquement la suppression des PDS (Physical Design Structures) existantes.Specifies that dta only considers dropping existing physical design structures. Aucune nouvelle PDS n'est considérée.No new physical design structures are considered. 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.When this option is specified, dta evaluates the usefulness of existing physical design structures and recommends dropping seldom used structures. Cet argument ne prend aucune valeur.This argument takes no values. Il ne peut pas être utilisé avec les arguments -fa, -fpou -fk ALL .It cannot be used with the -fa, -fp, or -fk ALL arguments

-ID session_ID-ID session_ID
Spécifie un identificateur numérique pour la session de réglage.Specifies a numerical identifier for the tuning session. Si ce paramètre n'est pas spécifié, dta génère un numéro d'identification.If not specified, then dta generates an ID number. Vous pouvez utiliser cet identificateur pour afficher des informations pour des sessions de réglage existantes.You can use this identifier to view information for existing tuning sessions. Si vous ne spécifiez pas de valeur pour -ID, un nom de session doit être spécifié avec -s.If you do not specify a value for -ID, then a session name must be specified with -s.

-ip-ip
Spécifie que le cache du plan est utilisé comme charge de travail.Specifies that the plan cache be used as the workload. Les 1 000 premiers événements du cache du plan pour les bases de données explicitement sélectionnées sont analysés.The top 1,000 plan cache events for explicitly selected databases are analyzed. Cette valeur peut être modifiée à l'aide de l'option -n .This value can be changed using the –n option.

-sweetiq-iq
Spécifie que le magasin de requêtes est utilisé comme la charge de travail.Specifies that the Query Store be used as the workload. Les 1 000 premiers événements du magasin de requêtes pour les bases de données explicitement sélectionnées sont analysés.The top 1,000 events from the Query Store for explicitly selected databases are analyzed. Cette valeur peut être modifiée à l'aide de l'option -n .This value can be changed using the –n option. Consultez magasin de requêtes et de paramétrage de base de données à l’aide de la charge de travail à partir du magasin de requêtes pour plus d’informations.See Query Store and Tuning Database Using Workload from Query Store for more information. ||
|-|
|S'applique à: SQL Server 2016SQL Server 2016 jusqu'à SQL Server 2017SQL Server 2017.Applies to: SQL Server 2016SQL Server 2016 through SQL Server 2017SQL Server 2017.|

-if workload_file-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.Specifies the path and name of the workload file to use as input for tuning. Le fichier doit être dans l'un de ces formats : .trc (fichier trace du Générateur de profils SQL Server), .sql (fichier SQL) ou .log (fichier de trace de 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). Un fichier de charge de travail ou une table de charge travail doit être spécifié.Either one workload file or one workload table must be specified.

-it workload_trace_table_name-it workload_trace_table_name
Spécifie le nom de la table contenant la trace de charge de travail pour le réglage.Specifies the name of a table containing the workload trace for tuning. Le nom est spécifié selon le format : [database_name].[owner_name].table_name.The name is specified in the format: [database_name].[owner_name].table_name.

Le tableau suivant indique les valeurs par défaut de chaque paramètre :The following table shows the default values for each:

ParamètreParameter Valeur par défautDefault value
database_namedatabase_name database_name spécifié avec l’option –D .database_name specified with –D option.
owner_nameowner_name dbo.dbo.
table_nametable_name Aucun.None.
Note

owner_name doit avoir la valeur dbo.owner_name must be dbo. Si toute autre valeur est spécifiée, l'exécution de dta échoue et une erreur est retournée.If any other value is specified, execution of dta fails and an error is returned. Notez également qu'une table de charge de travail ou un fichier de charge de travail doit être spécifié.Also note that either one workload table or one workload file must be specified.

-ix input_XML_file_name-ix input_XML_file_name
Spécifie le nom du fichier XML contenant les informations d’entrée dta .Specifies the name of the XML file containing dta input information. Ce doit être un document XML valide, conforme à DTASchema.xsd.This must be a valid XML document conforming to DTASchema.xsd. 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.Conflicting arguments specified from the command prompt for tuning options override the corresponding value in this XML file. Une seule exception : configuration spécifiée par l'utilisateur entrée dans le mode évaluation dans le fichier d'entrée XML.The only exception is if a user-specified configuration is entered in the evaluate mode in the XML input file. Par exemple, si une configuration est entrée dans l'élément Configuration du fichier d'entrée XML et si un élément EvaluateConfiguration est également spécifié comme l'une des options de réglage, les options de réglage spécifiées dans le fichier d'entrée XML sont prioritaires par rapport à toute option de réglage entrée à partir de l'invite de commandes.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
Spécifie le pourcentage minimal d'amélioration que la configuration recommandée doit satisfaire.Specifies the minimum percentage of improvement that the recommended configuration must satisfy.

-N online_option-N online_option
Spécifie si des PDS (Physical Design Structures) sont créées en ligne.Specifies whether physical design structures are created online. Le tableau suivant répertorie et décrit les valeurs pouvant être spécifiées pour cet argument :The following table lists and describes the values you can specify for this argument:

ValeurValue DescriptionDescription
OFFOFF Aucune PDS ne peut être créée en ligne.No recommended physical design structures can be created online.
ONON Toutes les PDS recommandées peuvent être créées en ligne.All recommended physical design structures can be created online.
MIXEDMIXED L'Assistant Paramétrage du moteur de base de données tente de recommander des PDS pouvant être créées en ligne lorsque cela est possible.Database Engine Tuning Advisor attempts to recommend physical design structures that can be created online when possible.

Si des index sont créés en ligne, ONLINE = ON est ajouté à sa définition d'objet.If indexes are created online, ONLINE = ON is appended to its object definition.

-n number_of_events-n number_of_events
Spécifie le nombre d’événements dans la charge de travail que dta doit régler.Specifies the number of events in the workload that dta should tune. 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.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. Cet argument est utile pour comparer deux configurations de PDS.This argument is useful to compare two configurations of physical design structures. 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 de la manière suivante :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  

Dans ce cas, il est important de spécifier une durée de réglage illimitée (-A 0).In this case, it is important to specify an unlimited tuning time (-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.Otherwise, Database Engine Tuning Advisor assumes an 8 hour tuning time by default.

-I time_window_in_hours -I time_window_in_hours
Spécifie la fenêtre de temps (en heures) lorsqu’une requête doit avoir exécutée pour être considéré comme en DTA pour le paramétrage lors de l’utilisation -sweetiq option (charge de travail à partir du magasin de requêtes).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  

Dans ce cas, DTA sera utiliser le magasin de requêtes comme source de charge de travail et prendre en compte uniquement des requêtes qui ont exécuté avec les dernières 48 heures.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.
||
|-|
|S'applique à: SQL Server 2016SQL Server 2016 jusqu'à 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
Spécifie que dta écrit la recommandation sous forme de script Transact-SQLTransact-SQL sous le nom de fichier et à la destination spécifiés.Specifies that dta writes the recommendation as a Transact-SQLTransact-SQL script to the file name and destination specified.

Vous pouvez utiliser -F avec cette option.You can use -F with this option. Vérifiez que le nom de fichier est unique, surtout si vous utilisez aussi -or et -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
Spécifie que dta écrit la recommandation dans un rapport de sortie XML.Specifies that dta writes the recommendation to an output report in XML. Si un nom de fichier est fourni, les recommandations sont écrites dans cette destination.If a file name is supplied, then the recommendations are written to that 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.Otherwise, dta uses the session name to generate the file name and writes it to the current directory.

Vous pouvez utiliser -F avec cette option.You can use -F with this option. Vérifiez que le nom de fichier est unique, surtout si vous utilisez aussi -of et -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
Spécifie que dta écrit la recommandation sous forme de fichier XML sous le nom de fichier et à la destination fournis.Specifies that dta writes the recommendation as an XML file to the file name and destination supplied. 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.Ensure that Database Engine Tuning Advisor has permissions to write to the destination directory.

Vous pouvez utiliser -F avec cette option.You can use -F with this option. Vérifiez que le nom de fichier est unique, surtout si vous utilisez aussi -of et -or.Make sure that the file name is unique, especially if you are also using -of and -or.

-P password-P password
Spécifie le mot de passe de l’ID de connexion.Specifies the password for the login ID. Si cette option est omise, dta demande d'entrer un mot de passe.If this option is not used, dta prompts for a password.

-q-q
Active le mode silencieux.Sets quiet mode. Aucune information n'est écrite sur la console, notamment les informations de progression et d'en-tête.No information is written to the console, including progress and header information.

-rl analysis_report_list-rl analysis_report_list
Spécifie la liste des rapports d'analyse à générer.Specifies the list of analysis reports to generate. Le tableau suivant répertorie les valeurs pouvant être spécifiées pour cet argument :The following table lists the values that can be specified for this argument:

ValeurValue RapportReport
ALLALL Tous les rapports d'analyseAll analysis reports
STMT_COSTSTMT_COST Rapport de coût d'instructionStatement cost report
EVT_FREQEVT_FREQ Rapport de fréquence d'événementEvent frequency report
STMT_DETSTMT_DET Rapport détaillé d'instructionStatement detail report
CUR_STMT_IDXCUR_STMT_IDX Rapport de relation instruction-index (configuration actuelle)Statement-index relations report (current configuration)
REC_STMT_IDXREC_STMT_IDX Rapport de relation instruction-index (configuration recommandée)Statement-index relations report (recommended configuration)
STMT_COSTRANGESTMT_COSTRANGE Rapport de fourchette de coûts d'instructionStatement cost range report
CUR_IDX_USAGECUR_IDX_USAGE Rapport d'utilisation de l'index (configuration actuelle)Index usage report (current configuration)
REC_IDX_USAGEREC_IDX_USAGE Rapport d'utilisation de l'index (configuration recommandée)Index usage report (recommended configuration)
CUR_IDX_DETCUR_IDX_DET Rapport détaillé d'index (configuration actuelle)Index detail report (current configuration)
REC_IDX_DETREC_IDX_DET Rapport détaillé d'index (configuration recommandée)Index detail report (recommended configuration)
VIW_TABVIW_TAB Rapport de relation vue-tableView-table relations report
WKLD_ANLWKLD_ANL Rapport d'analyse de la charge de travailWorkload analysis report
DB_ACCESSDB_ACCESS Rapport d'accès à la base de donnéesDatabase access report
TAB_ACCESSTAB_ACCESS Rapport d'accès à la tableTable access report
COL_ACCESSCOL_ACCESS Rapports d'accès à la colonneColumn access report

Spécifiez plusieurs rapports en séparant les valeurs avec des virgules, par exemple :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]
Spécifie le nom de l'ordinateur et de l'instance de SQL ServerSQL Server auxquels la connexion doit être établie.Specifies the name of the computer and instance of SQL ServerSQL Server to connect to. Si la valeur de server_name n’est pas spécifiée, dta se connecte à l’instance par défaut de SQL ServerSQL Server sur l’ordinateur local.If no server_name is specified, dta connects to the default instance of SQL ServerSQL Server on the local computer. 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.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
Spécifie le nom de la session de réglage.Specifies the name of the tuning session. Ce paramètre est obligatoire si -ID n’est pas spécifié.This is required if -ID is not specified.

-Tf table_list_file-Tf table_list_file
Spécifie le nom du fichier contenant la liste des tables à paramétrer.Specifies the name of a file containing a list of tables to be tuned. Chaque table listée à l'intérieur du fichier doit commencer sur une nouvelle ligne.Each table listed within the file should begin on a new line. Les noms de table doivent être complets avec une dénomination en trois parties, par exemple, AdventureWorks2012.HumanResources.Department.Table names should be qualified with three-part naming, for example, AdventureWorks2012.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.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. 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.Database Engine Tuning Advisor takes into consideration the projected number of rows while tuning or evaluating statements in the workload that reference these tables. Notez qu’un ou plusieurs espaces peuvent figurer entre le nombre number_of_rows et le nom table_name.Note that there can be one or more spaces between the number_of_rows count and the table_name.

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

Cet argument peut remplacer l’entrée d’une liste de tables à l’invite de commandes (-TI).This argument is an alternative to entering a table list at the command prompt (-Tl). N’utilisez pas un fichier de liste de tables (-Tf) si vous employez -TI.Do not use a table list file (-Tf) if you are using -Tl. Si les deux arguments sont employés, dta échoue et retourne une erreur.If both arguments are used, dta fails and returns an error.

Si les arguments -Tf et -Tl sont omis, toutes les tables utilisateur dans les bases de données spécifiées sont prises en compte pour le réglage.If the -Tf and -Tl arguments are omitted, all user tables in the specified databases are considered for tuning.

-TI table_list-Tl table_list
Spécifie à l'invite de commandes une liste de tables à régler.Specifies at the command prompt a list of tables to be tuned. Placez des virgules entre les noms de table pour les séparer.Place commas between table names to separate them. 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.If only one database is specified with the -D argument, then table names do not need to be qualified with a database name. Sinon, le nom complet au format : database_name.schema_name.table_name est obligatoire pour chaque table.Otherwise, the fully qualified name in the format: database_name.schema_name.table_name is required for each table.

Cet argument constitue une alternative à l’utilisation d’un fichier de liste de tables (-Tf).This argument is an alternative to using a table list file (-Tf). Si les deux arguments -Tl et -Tf sont employés, dta échoue et retourne une erreur.If both -Tl and -Tf are used, dta fails and returns an error.

-U login_id-U login_id
Spécifie l'ID de connexion utilisé pour une connexion à SQL ServerSQL Server.Specifies the login ID used to connect to SQL ServerSQL Server.

-u-u
Lance l'interface utilisateur graphique de l'Assistant Paramétrage du moteur de base de données.Launches the Database Engine Tuning Advisor GUI. Tous les paramètres sont traités comme les paramètres initiaux de l'interface utilisateur.All parameters are treated as the initial settings for the user interface.

-x-x
Démarre une session de réglage et quitte.Starts tuning session and exits.

NotesRemarks

Appuyez sur Ctrl+C pour arrêter la session de réglage et générer des recommandations basées sur l’analyse que dta a effectuée jusqu’à ce point.Press CTRL+C once to stop the tuning session and generate recommendations based on the analysis dta has completed up to this point. Un message vous demande de déterminer si vous souhaitez générer ou non des recommandations.You will be prompted to decide whether you want to generate recommendations or not. Appuyez de nouveau sur CTRL+C pour arrêter la session de réglage sans générer de recommandations.Press CTRL+C again to stop the tuning session without generating recommendations.

ExemplesExamples

A. Paramétrer une charge de travail qui inclut des index et vues indexées dans sa recommandationA. Tune a workload that includes indexes and indexed views in its recommendation

Cet exemple utilise une connexion sécurisée (-E) pour se connecter à la base de données tpcd1G sur MyServer afin d’analyser une charge de travail et créer des recommandations.This example uses a secure connection (-E) to connect to the tpcd1G database on MyServer to analyze a workload and create recommendations. Il écrit la sortie dans un fichier de script nommé script.sql.It writes the output to a script file named script.sql. Si script.sql existe déjà, dta remplace le fichier, car l'argument -F a été spécifié.If script.sql already exists, then dta will overwrite the file because the -F argument has been specified. 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).The tuning session runs for an unlimited length of time to ensure a complete analysis of the workload (-A 0). La recommandation doit fournir une amélioration minimale de 5 % (-m 5).The recommendation must provide a minimum improvement of 5% (-m 5). dta doit inclure des index et des vues indexées dans sa recommandation finale (-fa IDX_IV).dta should include indexes and indexed views in its final recommendation (-fa IDX_IV).

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

B. Limitez l’utilisation du disqueB. Limit disk use

Cet exemple limite la taille de base de données totale, qui inclut les données brutes et les index supplémentaires, à 3 gigaoctets (Go) (-B 3000) et dirige la sortie vers d:\result_dir\script1.sql.This example limits the total database size, which includes the raw data and the additional indexes, to 3 gigabytes (GB) (-B 3000) and directs the output to d:\result_dir\script1.sql. Il ne s'exécute pas plus d'une heure (-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. Limiter le nombre de requêtes paramétrablesC. Limit the number of tuned queries

Cet exemple limite le nombre de requêtes lues du fichier orders_wkld.sql à un maximum de 10 (-n 10) et s'exécute pendant 15 minutes (-A 15), selon l'événement se produisant en premier.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. 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.To make sure that all 10 queries are tuned, specify an unlimited tuning time with -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.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. Réglage de tables spécifiques répertoriées dans un fichierD. Tune specific tables listed in a file

Cet exemple illustre l’utilisation de table_list_file (l’argument -Tf ).This example demonstrates the use of table_list_file (the -Tf argument). Le contenu du fichier table_list.txt est le suivant :The contents of the file table_list.txt are as follows:

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

Le contenu de table_list.txt spécifie que :The contents of table_list.txt specifies that:

  • Seules les tables Customer, Storeet Product dans la base de données doivent être réglées.Only the Customer, Store, and Product tables in the database should be tuned.

  • Le nombre de lignes dans les tables Customer et Product sont par défaut de 100 000 et de 2 000 000, respectivement.The number of rows in the Customer and Product tables are assumed to be 100,000 and 2,000,000, respectively.

  • Le nombre de lignes dans Store doit être évalué au nombre actuel de lignes dans la table.The number of rows in Store are assumed to be the current number of rows in the table.

    Notez qu’un ou plusieurs espaces peuvent figurer entre le nombre de lignes et le nom de la table précédente dans table_list_file.Note that there can be one or more spaces between the number of rows count and the preceding table name in the table_list_file.

    La durée de réglage est de 2 heures (-A 120) et la sortie est écrite dans un fichier 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  

Voir aussiSee Also

Référence de l’utilitaire d’invite de commandes (moteur de base de données) Command Prompt Utility Reference (Database Engine)
Assistant Paramétrage du moteur de base de donnéesDatabase Engine Tuning Advisor