Opzione preprocess (strumento di amministrazione Riesecuzione distribuita)
Si applica a: 
SQL Server 2016 (13.x), SQL Server 2017 (14.x) e SQL Server 2019 (15.x)
Importante
Riesecuzione distribuita di SQL Server non è disponibile con SQL Server 2022 (16.x).
Lo strumento di amministrazione Riesecuzione distribuita di Microsoft SQL Server, DReplay.exe, è uno strumento da riga di comando che consente di comunicare con il controller di riesecuzione distribuita. Questo argomento descrive l'opzione della riga di comando preprocess e la sintassi corrispondente.
L'opzione preprocess avvia la fase di pre-elaborazione. Durante questa fase il controller prepara i dati di traccia di input per la riproduzione sul server di destinazione.
Per altre informazioni sulle convenzioni relative alla sintassi dello strumento di amministrazione, vedere Convenzioni della sintassi Transact-SQL.
Sintassi
dreplay preprocess [-m controller] -i input_trace_file
-d controller_working_dir [-c config_file] [-f status_interval]
Parametri
-m controller
Specifica il nome computer del controller. È possibile utilizzare "localhost" o "." per fare riferimento al computer locale.
Se il parametro -m non è specificato, viene usato il computer locale.
-i input_trace_file
Specifica il percorso completo del file di traccia di input nel controller, ad esempio D:\Mytrace.trc. Il parametro -i è obbligatorio.
Se nella stessa directory sono presenti file di rollover, questi verranno caricati e utilizzati automaticamente. I file devono rispettare la convenzione di denominazione per il rollover dei file, ad esempio Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, ... Mytrace_n.trc.
Nota
Se si utilizza lo strumento di amministrazione in un computer diverso dal controller, sarà necessario copiare i file di traccia di input nel controller in modo da poter utilizzare un percorso locale per questo parametro.
-d controller_working_dir
Specifica la directory nel controller in cui verrà archiviato il file intermedio. Il parametro -d è obbligatorio.
Di seguito vengono indicati i requisiti per questo parametro:
La directory deve trovarsi nel controller.
È necessario specificare il percorso completo, che inizia con una lettera di unità, ad esempio
c:\WorkingDir.Il percorso non deve terminare con una barra rovesciata "
\".I percorsi UNC non sono supportati.
-c config_file
È il percorso completo del file di configurazione della pre-elaborazione. Viene utilizzato per specificare il percorso del file di configurazione della pre-elaborazione quando tale file viene archiviato in una posizione diversa. Questo parametro può essere un percorso UNC o un percorso locale nel computer in cui viene eseguito lo strumento di amministrazione.
Il parametro -c non è obbligatorio se non è necessario applicare filtri o non si vuole modificare il tempo massimo di inattività.
Senza il parametro -c , viene usato il file di configurazione della pre-elaborazione predefinito, ovvero DReplay.exe.preprocess.config.
-f status_interval
Specifica la frequenza in secondi in base alla quale visualizzare messaggi di stato.
Se -f non è specificato, l'intervallo predefinito è 30 secondi.
Esempi
In questo esempio la fase di pre-elaborazione viene avviata con tutte le impostazioni predefinite. Il valore localhost indica che il servizio controller viene eseguito nello stesso computer dello strumento di amministrazione. Il parametro input_trace_file specifica il percorso dei dati di traccia di input, ad esempio c:\mytrace.trc. Il file di traccia non viene filtrato, quindi è necessario specificare il parametro -c.
dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir
In questo esempio viene avviata la fase di pre-elaborazione e viene specificato un file di configurazione della pre-elaborazione modificato. A differenza dell'esempio precedente, il parametro -c viene usato per puntare al file di configurazione modificato, se è stato archiviato in un percorso diverso. Ad esempio:
dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config
Nel file di configurazione della pre-elaborazione modificato, viene aggiunta una condizione di filtro per filtrare le sessioni di sistema durante la riproduzione distribuita. Il filtro viene aggiunto modificando l'elemento <PreprocessModifiers> nel file di configurazione della pre-elaborazione DReplay.exe.preprocess.config.
Nell'esempio seguente viene illustrato un file di configurazione modificato:
<?xml version='1.0'?>
<Options>
<PreprocessModifiers>
<IncSystemSession>No</IncSystemSession>
<MaxIdleTime>-1</MaxIdleTime>
</PreprocessModifiers>
</Options>
Autorizzazioni
È necessario eseguire lo strumento di amministrazione come utente interattivo, scegliendo tra utente locale e account utente di dominio. Per utilizzare un account utente locale, lo strumento di amministrazione e il controller devono essere eseguiti nello stesso computer.
Per altre informazioni, vedere Sicurezza di Distributed Replay.