Opzione preprocess (strumento di amministrazione Distributed Replay)

Lo strumento di amministrazione Microsoft SQL Server Distributed Replay, DReplay.exe, è uno strumento da riga di comando che consente di comunicare con Distributed Replay Controller. In questo argomento vengono descritte 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 ulteriori informazioni sulle convenzioni di sintassi utilizzate con la sintassi dello strumento di amministrazione, vedere Convenzioni della sintassi Transact-SQL (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 utilizzato 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 desidera modificare il tempo massimo di inattività.

  Senza il parametro -c, viene utilizzato 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. Poiché il file di traccia non viene filtrato, è 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 utilizzato 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 ulteriori informazioni, vedere Sicurezza di Distributed Replay.

Vedere anche

Attivitá

Preparazione dei dati di traccia di input

Concetti

SQL Server Distributed Replay

Configurare Distributed Replay