Vorverarbeitungsoption (Verwaltungstool "Distributed Replay")

  • Artikel

Gilt für: SQL Server 2016 (13.x), SQL Server 2017 (14.x) und SQL Server 2019 (15.x)

Wichtig

SQL Server Distributed Replay ist nicht mit SQL Server 2022 (16.x) verfügbar.

Das Microsoft SQL Server-Verwaltungstool Distributed Replay, DReplay.exe, ist ein Befehlszeilentool, das Sie für die Kommunikation mit dem Distributed Replay-Controller verwenden können. In diesem Thema werden die Befehlszeilenoption preprocess und die entsprechende Syntax beschrieben.

Die preprocess -Option initiiert die Vorverarbeitungsphase. In dieser Phase bereitet der Controller die Eingabedaten der Ablaufverfolgung für die Wiedergabe anhand des Zielservers vor.

Weitere Informationen zu den Syntaxkonventionen für das Verwaltungstool finden Sie unter Transact-SQL-Syntaxkonventionen.

Syntax


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

Parameter

-m Controller
Gibt den Computernamen des Controllers an. Sie können mit "localhost" oder "." auf den lokalen Computer verweisen.

Wenn der -m -Parameter nicht angegeben ist, wird der lokale Computer verwendet.

-i Eingabedatei_der_Ablaufverfolgung
Gibt den vollständigen Pfad der Eingabedatei der Ablaufverfolgung auf dem Controller an, z. B. D:\Mytrace.trc. Der -i -Parameter ist erforderlich.

Wenn Rolloverdateien im gleichen Verzeichnis vorhanden sind, werden sie geladen und automatisch verwendet. Die Dateien müssen der Dateirollover-Benennungskonvention folgen, z.B.: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, ... Mytrace_n.trc.

Hinweis

Wenn Sie das Verwaltungstool auf einem anderen Computer als dem Controller verwenden, müssen Sie die Eingabedateien der Ablaufverfolgung auf den Controller kopieren, damit ein lokaler Pfad für diesen Parameter verwendet werden kann.

-d controller_working_dir
Gibt das Verzeichnis auf dem Controller an, in dem die Zwischendatei gespeichert wird. Der -d -Parameter ist erforderlich.

Es gelten die folgenden Anforderungen:

  • Das Verzeichnis muss sich auf dem Controller befinden.

  • Sie müssen den vollständigen Pfad angeben, der mit einem Laufwerkbuchstaben beginnen muss (z. B. c:\WorkingDir).

  • Der Pfad darf nicht mit einem umgekehrten Schrägstrich ("\") enden.

  • UNC-Pfade werden nicht unterstützt.

-c config_file
Der vollständige Pfad der Vorverarbeitungskonfigurationsdatei. Mit ihm wird der Speicherort der Vorverarbeitungskonfigurationsdatei angegeben, wenn sie an einem anderen Speicherort gespeichert wird. Dieser Parameter kann ein UNC-Pfad sein oder ein lokales Verzeichnis auf dem Computer angeben, auf dem Sie das Verwaltungstool ausführen.

Der -c -Parameter ist nicht erforderlich, wenn keine Filterung benötigt wird oder wenn Sie die maximale Leerlaufzeit nicht ändern möchten.

Ohne den -c -Parameter wird die Standardkonfigurationsdatei für die Vorverarbeitung verwendet: DReplay.exe.preprocess.config.

-f status_interval
Gibt die Häufigkeit (in Sekunden) für die Anzeige von Statusmeldungen an.

Wenn -f nicht angegeben wird, ist das Standardintervall 30 Sekunden.

Beispiele

In diesem Beispiel wird die Vorverarbeitungsphase mit allen Standardeinstellungen initiiert. Der Wert localhost gibt an, dass der Controllerdienst auf demselben Computer wie das Verwaltungstool ausgeführt wird. Der input_trace_file -Parameter gibt den Speicherort der Eingabedaten der Ablaufverfolgung an: c:\mytrace.trc. Da keine Filterung der Ablaufverfolgungsdatei erfolgt, muss der -c -Parameter angegeben werden.

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

In diesem Beispiel wird die Vorverarbeitungsphase initiiert, und es wird eine geänderte Vorverarbeitungskonfigurationsdatei angegeben. Im Gegensatz zum vorherigen Beispiel wird der -c -Parameter verwendet, um auf die geänderte Konfigurationsdatei zu zeigen, wenn Sie diese an einem anderen Speicherort gespeichert haben. Beispiel:

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

Der geänderten Vorverarbeitungskonfigurationsdatei wird eine Filterbedingung hinzugefügt, die während der verteilten Wiedergabe Systemsitzungen herausfiltert. Der Filter wird durch Ändern des <PreprocessModifiers> -Elements in der Vorverarbeitungskonfigurationsdatei DReplay.exe.preprocess.confighinzugefügt.

Im folgenden Beispiel wird die geänderte Konfigurationsdatei gezeigt:

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

Berechtigungen

Sie müssen das Verwaltungstool als interaktiver Benutzer mit einem lokalen Benutzerkonto oder Domänenbenutzerkonto ausführen. Um ein lokales Benutzerkonto zu verwenden, müssen das Verwaltungstool und der Controller auf demselben Computer ausgeführt werden.

Weitere Informationen finden Sie unter Distributed Replay Security.

Weitere Informationen