Opzione preprocess (strumento di amministrazione Riesecuzione distribuita)

  • Articolo

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

Controller-m
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.

-iinput_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.

-dcontroller_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.

-cconfig_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.

intervallo_stato-f
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.

Vedi anche