Option replay (outil d'administration Distributed Replay)

L'outil d'administration Microsoft SQL Server Distributed Replay, DReplay.exe, est un outil en ligne de commande que vous pouvez utiliser pour communiquer avec Distributed Replay Controller. Cette rubrique décrit l'option de ligne de commande replay et la syntaxe correspondante.

L'option replay initialise l'étape de relecture d'événement, dans laquelle le contrôleur distribue des données de relecture aux clients spécifiés, lance la relecture distribuée et synchronise les clients. Chaque client participant à la relecture peut éventuellement enregistrer l'activité de relecture et enregistrer un fichier de trace de résultats localement.

Icône Lien de rubrique Pour plus d'informations sur les conventions de syntaxe utilisées par l'outil d'administration, consultez Conventions de la syntaxe Transact-SQL (Transact-SQL).

Syntaxe

dreplay replay [-m controller] -d controller_working_dir [-o]
    [-s target_server] -w clients [-c config_file]
    [-f status_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é.

  • -d controller_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 d'accès 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.

  • -o
    Capture l'activité de relecture des clients et la sauvegarde dans un fichier de trace de résultats dans le chemin d'accès spécifié par l'élément <ResultDirectory>, dans le fichier de configuration client DReplayClient.xml.

    Lorsque le paramètre –o n'est pas spécifié, le fichier de trace de résultats n'est pas généré. La sortie de console retourne les informations de résumé à la fin de la relecture, mais aucune autre statistique de relecture n'est disponible.

  • -s target_server
    Spécifie l'instance cible de SQL Server avec laquelle la charge de travail distribuée doit être relue. Vous devez spécifier ce paramètre au format server_name[\instance name].

    Vous ne pouvez pas utiliser « localhost » ou « . » comme serveur cible.

    Le paramètre -s n'est pas obligatoire si l'élément <Server> est spécifié dans la section <ReplayOptions> du fichier de configuration de relecture DReplay.exe.replay.config.

    Si le paramètre -s est utilisé, l'élément <Server> dans la section <ReplayOptions> du fichier de configuration de relecture est ignoré.

  • -w clients
    Ce paramètre obligatoire est une liste de valeurs séparées par des virgules (sans espaces) qui spécifie les noms d'ordinateur des clients qui doivent participer à la relecture distribuée. Les adresses IP ne sont pas autorisées. Sachez que les clients doivent être déjà enregistrés avec le contrôleur.

    [!REMARQUE]

    Chaque client s'inscrit avec le contrôleur spécifié dans le fichier de configuration client lors du démarrage du service client.

  • -c config_file
    C'est le chemin d'accès complet du fichier de configuration de relecture ; il est utilisé pour spécifier l'emplacement du fichier lorsqu'il est stocké à un autre emplacement.

    Le paramètre -c n'est pas obligatoire si vous voulez utiliser les valeurs par défaut du fichier de configuration de relecture, DReplay.exe.replay.config.

  • -f status_interval
    Spécifie la fréquence (en secondes) à laquelle afficher l'état.

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

Exemples

Dans cet exemple, la relecture distribuée tire beaucoup de son comportement d'un fichier de configuration de relecture modifié, DReplay.exe.replay.config.

  • Le paramètre -m spécifie qu'un ordinateur nommé controller1 agit en tant que contrôleur. Le nom d'ordinateur doit être spécifié quand le service contrôleur s'exécute sur un autre ordinateur.

  • Le paramètre -d spécifie l'emplacement du fichier intermédiaire sur le contrôleur, c:\WorkingDir.

  • Le paramètre -o spécifie que chaque client spécifié capture l'activité de relecture et l'enregistre dans un fichier de trace de résultats. Remarque : l'élément <ResultTrace> dans le fichier de configuration peut être utilisé pour spécifier si le nombre de lignes et le jeu de résultats doivent être enregistrés.

  • Le paramètre -w spécifie que les ordinateurs client1 à client4 participent en tant que clients à la relecture distribuée.

  • Le paramètre -c est utilisé pour pointer sur le fichier de configuration modifié, DReplay.exe.replay.config.

  • Le paramètre -s n'est pas obligatoire, car l'élément <Server> est spécifié dans l'élément <ReplayOptions> du fichier de configuration de relecture DReplay.exe.replay.config.

L'étape de relecture d'événement est initialisée avec la syntaxe suivante, lorsque l'outil d'administration est exécuté à partir d'un autre ordinateur que le contrôleur :

dreplay replay -m controller1 -d c:\WorkingDir -o -w client1,client2,client3,client4 -c c:\DReplay.exe.replay.config

Pour spécifier un mode de mise en séquence synchrone, l'élément <SequencingMode> du fichier DReplay.exe.replay.config est défini comme égal à la valeur synchronization. La section <ResultTrace> du fichier de configuration de relecture est modifiée pour spécifier que le nombre de lignes doit être enregistré. Ces modifications sont illustrées dans l'exemple XML suivant :

<?xml version='1.0'?>
<Options>
    <ReplayOptions>
        <Server>server_name\replay_target_instance</Server>
        <SequencingMode>synchronization</SequencingMode>
        <ConnectTimeScale></ConnectTimeScale>
        <ThinkTimeScale></ThinkTimeScale>
        <HealthmonInterval>60</HealthmonInterval>
        <QueryTimeout>3600</QueryTimeout>
        <ThreadsPerClient></ThreadsPerClient>
    </ReplayOptions>
    <OutputOptions>
        <ResultTrace>
            <RecordRowCount>Yes</RecordRowCount>
            <RecordResultSet>No</RecordResultSet>
        </ResultTrace>
    </OutputOptions>
</Options>

Pour spécifier un mode de séquencement en simultané (stress), l'élément <SequencingMode> du fichier DReplay.exe.replay.config est défini comme égal à la valeur stress. Les éléments <ThinkTimeScale> et <ConnectTimeScale> ont la valeur 50 (pour spécifier 50 pour cent). Pour plus d'informations sur le délai de connexion et le temps de réflexion, consultez Configurer Distributed Replay. Ces modifications sont illustrées dans l'exemple XML suivant :

<?xml version='1.0'?>
<Options>
    <ReplayOptions>
        <Server>server_name\replay_target_instance_name</Server>
        <SequencingMode>stress</SequencingMode>
        <ConnectTimeScale>50</ConnectTimeScale>
        <ThinkTimeScale>50</ThinkTimeScale>
        <HealthmonInterval>60</HealthmonInterval>
        <QueryTimeout>3600</QueryTimeout>
        <ThreadsPerClient></ThreadsPerClient>
    </ReplayOptions>
    <OutputOptions>
        <ResultTrace>
            <RecordRowCount>Yes</RecordRowCount>
            <RecordResultSet>No</RecordResultSet>
        </ResultTrace>
    </OutputOptions>
</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, consultez Sécurité Distributed Replay.

Voir aussi

Tâches

Relire les données de trace

Concepts

Examiner les résultats de la relecture

SQL Server Distributed Replay

Configurer Distributed Replay

Autres ressources

Forum de SQL Server Distributed Replay

Utilisation de Distributed Replay pour le test de charge de SQL Server – Deuxième partie

Utilisation de Distributed Replay pour le test de charge de SQL Server – Première partie