Option preprocess (outil d'administration Distributed Replay)

S’applique à : SQL Server 2016 (13.x), SQL Server 2017 (14.x) et SQL Server 2019 (15.x)

L’outil d’administration Microsoft SQL Server Distributed Replay, DReplay.exe, est un outil en ligne de commande qui permet de communiquer avec Distributed Replay Controller. Cette rubrique décrit l’option de ligne de commande preprocess et la syntaxe correspondante.

L’option preprocess initialise l’étape de prétraitement. Lors de cette étape, le contrôleur prépare les données de trace d'entrée pour la relecture sur le serveur cible.

Pour plus d’informations sur les conventions syntaxiques utilisées par l’outil d’administration, consultez Conventions de la syntaxe Transact-SQL.

Syntaxe

dreplay preprocess [-m controller] -i input_trace_file  
    -d controller_working_dir [-c config_file] [-f status_interval]  

Paramètres

-mcontroller
Spécifie le nom de l'ordinateur du contrôleur. Vous pouvez utiliser «localhost» ou «.» pour désigner l'ordinateur local.

Si le paramètre -m n’est pas spécifié, l’ordinateur local est utilisé.

-iinput_trace_file
Spécifie le chemin complet du fichier de trace d’entrée sur le contrôleur, tel que D:\Mytrace.trc. Le paramètre -i est obligatoire.

Si des fichiers de substitution se trouvent dans le même répertoire, ils seront chargés et utilisés automatiquement. Les fichiers doivent suivre la convention d’affectation des noms de substitution de fichier, par exemple : Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, ... Mytrace_n.trc.

-dcontroller_working_dir
Spécifie le répertoire du contrôleur où sera stocké le fichier intermédiaire. Le paramètre -d est obligatoire.

Les conditions suivantes s'appliquent :

• Le répertoire doit résider sur le contrôleur.

• Vous devez spécifier le chemin complet, en commençant par une lettre de lecteur (par exemple, c:\WorkingDir).

• Le chemin d'accès ne doit pas se terminer par une barre oblique inverse «\».

• Les chemins d’accès UNC ne sont pas pris en charge.

-cconfig_file
C'est le chemin d'accès complet au fichier de configuration de prétraitement ; il est utilisé pour spécifier l'emplacement du fichier de configuration de prétraitement en cas de stockage dans un autre emplacement. Ce paramètre peut être un chemin d'accès UNC, ou peut résider localement sur l'ordinateur où vous exécutez l'outil d'administration.

Le paramètre -c n’est pas obligatoire si aucun filtrage n’est exigé, ou si vous ne voulez pas modifier la durée d’inactivité maximale.

Sans le paramètre -c , le fichier de configuration de prétraitement par défaut DReplay.exe.preprocess.configest utilisé.

-fstatus_interval
Spécifie la fréquence (en secondes) d'affichage des messages d'état.

Si -f n’est pas spécifié, l’intervalle par défaut est de 30 secondes.

Exemples

Dans cet exemple, l'étape de prétraitement est initialisée avec tous les paramètres par défaut. La valeur localhost indique que le service contrôleur s'exécute sur le même ordinateur que l'outil d'administration. Le paramètre input_trace_file spécifie l’emplacement des données de trace d’entrée ( c:\mytrace.trc). Étant donné qu’aucun filtre de fichier de trace n’est impliqué, le paramètre -c doit être spécifié.

dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir  

Dans cet exemple, l'étape de prétraitement est initialisée et un fichier de configuration de prétraitement modifié est spécifié. Contrairement à l’exemple précédent, le paramètre -c est utilisé pour pointer sur le fichier de configuration modifié, si vous l’avez stocké dans un emplacement différent. Par exemple :

dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config  

Dans le fichier de configuration de prétraitement modifié, une condition de filtre est ajoutée qui exclut les sessions système pendant la relecture distribuée. Le filtre est ajouté en modifiant l'élément <PreprocessModifiers> dans le fichier de configuration de prétraitement, DReplay.exe.preprocess.config.

L'exemple suivant montre le fichier de configuration modifié :

<?xml version='1.0'?> 
<Options> 
    <PreprocessModifiers> 
        <IncSystemSession>No</IncSystemSession> 
        <MaxIdleTime>-1</MaxIdleTime> 
    </PreprocessModifiers> 
</Options> 

Autorisations

Vous devez exécuter l'outil d'administration en tant qu'utilisateur interactif, comme un utilisateur local ou un compte d'utilisateur de domaine. Pour utiliser un compte d'utilisateur local, l'outil d'administration et le contrôleur doivent s'exécuter sur le même ordinateur.

Pour plus d’informations, voir Distributed Replay Security.

Voir aussi

• Préparer les données de trace d’entrée
• SQL Server Distributed Replay
• Configurer Distributed Replay