Option preprocess (outil d'administration Distributed Replay)

L’outil d’administration De Microsoft SQL Server Distributed Replay est DReplay.exeun outil en ligne de commande que vous pouvez utiliser pour communiquer avec le contrôleur de relecture distribué. 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 de syntaxe utilisées avec la syntaxe de l’outil d’administration, consultez Conventions de syntaxe Transact-SQL (Transact-SQL).

Syntaxe

      dreplay preprocess [-mcontroller] -iinput_trace_file
    -dcontroller_working_dir [-cconfig_file] [-fstatus_interval]

Paramètres

-m controller 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é.

-i input_trace_file Spécifie le chemin d’accès complet du fichier de trace d’entrée sur le contrôleur, par D:\Mytrace.trcexemple . 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.

-d controller_working_dir Spécifie le répertoire sur le contrôleur dans lequel le fichier intermédiaire sera stocké. 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.

-c config_file Est le chemin d’accès complet du fichier de configuration de préprocesseur ; utilisé pour spécifier l’emplacement du fichier de configuration de prétraitement lorsqu’il est stocké 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é.

-f status_interval Spécifie la fréquence (en secondes) à laquelle afficher les 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 la relecture distribuée de données detrace d’entrée SQL Server Distributed Replayconfigure Distributed Replay