Opzione preprocess (strumento di amministrazione Distributed Replay)Preprocess Option (Distributed Replay Administration Tool)

In questo argomento si applica a: SìSQL ServernonDatabase SQL di AzurenonAzure SQL Data Warehouse non Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse Il MicrosoftMicrosoft SQL ServerSQL Server dello strumento di amministrazione riesecuzione distribuita DReplay.exe, è uno strumento da riga di comando che è possibile utilizzare per comunicare con il controller di riesecuzione distribuita. The MicrosoftMicrosoft SQL ServerSQL Server Distributed Replay administration tool, DReplay.exe, is a command-line tool that you can use to communicate with the distributed replay controller. Questo argomento descrive l'opzione della riga di comando preprocess e la sintassi corrispondente.This topic describes the preprocess command-line option and corresponding syntax.

L'opzione preprocess avvia la fase di pre-elaborazione.The preprocess option initiates the preprocess stage. Durante questa fase il controller prepara i dati di traccia di input per la riproduzione sul server di destinazione.During this stage, the controller prepares the input trace data for replay against the target server.

Icona di collegamento argomento per ulteriori informazioni sulle convenzioni di sintassi utilizzate con la sintassi dello strumento di amministrazione, vedere convenzioni della sintassi Transact-SQL ( Transact-SQL ) .Topic link icon For more information about the syntax conventions that are used with the administration tool syntax, see Transact-SQL Syntax Conventions (Transact-SQL).

SintassiSyntax


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

ParametriParameters

Controller -m-m controller
Specifica il nome computer del controller.Specifies the computer name of the controller. È possibile utilizzare "localhost" o "." per fare riferimento al computer locale.You can use "localhost" or "." to refer to the local computer.

Se il parametro -m non è specificato, viene usato il computer locale.If the -m parameter is not specified, the local computer is used.

-i input_trace_file-i input_trace_file
Specifica il percorso completo del file di traccia di input nel controller, ad esempio D:\Mytrace.trc.Specifies the full path of the input trace file on the controller, such as D:\Mytrace.trc. Il parametro -i è obbligatorio.The -i parameter is required.

Se nella stessa directory sono presenti file di rollover, questi verranno caricati e utilizzati automaticamente.If there are rollover files in the same directory, they will be loaded and used automatically. 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, …The files must follow the file rollover naming convention, for example: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, … Mytrace_n.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.If you are using the administration tool on a different computer than the controller, you will need to copy the input trace files to the controller so that a local path can be used for this parameter.

-d controller_working_dir-d controller_working_dir
Specifica la directory nel controller in cui verrà archiviato il file intermedio.Specifies the directory on the controller where the intermediate file will be stored. Il parametro -d è obbligatorio.The -d parameter is required.

Di seguito vengono indicati i requisiti per questo parametro:The following requirements apply:

  • La directory deve trovarsi nel controller.The directory must reside on the controller.

  • È necessario specificare il percorso completo, che inizia con una lettera di unità, ad esempio c:\WorkingDir.You must specify the full path, starting with a drive letter (for example, c:\WorkingDir).

  • Il percorso non deve terminare con una barra rovesciata "\".The path must not end with a backslash "\".

  • I percorsi UNC non sono supportati.UNC paths are not supported.

    -c config_file-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.Is the full path of the preprocess configuration file; used to specify the location of the preprocess configuration file when stored in a different location. Questo parametro può essere un percorso UNC o un percorso locale nel computer in cui viene eseguito lo strumento di amministrazione.This parameter can be a UNC path, or can reside locally on the computer where you run the administration tool.

    Il parametro -c non è obbligatorio se non è necessario applicare filtri o non si vuole modificare il tempo massimo di inattività.The -c parameter is not required if no filtering is needed, or if you do not want to modify the maximum idle time.

    Senza il parametro -c, viene usato il file di configurazione della pre-elaborazione predefinito, ovvero DReplay.exe.preprocess.config.Without the -c parameter, the default preprocess configuration file, DReplay.exe.preprocess.config, is used.

    intervallo_stato-f-f status_interval
    Specifica la frequenza in secondi in base alla quale visualizzare messaggi di stato.Specifies the frequency (in seconds) at which to display status messages.

    Se -f non è specificato, l'intervallo predefinito è 30 secondi.If -f is not specified, the default interval is 30 seconds.

EsempiExamples

In questo esempio la fase di pre-elaborazione viene avviata con tutte le impostazioni predefinite.In this example, the preprocess stage is initiated with all of the default settings. Il valore localhost indica che il servizio controller viene eseguito nello stesso computer dello strumento di amministrazione.The value localhost indicates that the controller service is running on the same computer as the administration tool. Il parametro input_trace_file specifica il percorso dei dati di traccia di input, ad esempio c:\mytrace.trc.The input_trace_file parameter specifies the location of the input trace data, c:\mytrace.trc. Il file di traccia non viene filtrato, quindi è necessario specificare il parametro -c .Because there is no trace file filtering involved, the -c parameter does have to be specified.

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.In this example, the preprocess stage is initiated and a modified preprocess configuration file is specified. A differenza dell'esempio precedente, il parametro -c viene usato per puntare al file di configurazione modificato, se è stato archiviato in un percorso diverso.Unlike the previous example, the -c parameter is used to point to the modified configuration file, if you have stored it in a different location. Esempio:For example:

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.In the modified preprocess configuration file, a filter condition is added that filters out system sessions during distributed replay. Il filtro viene aggiunto modificando l'elemento <PreprocessModifiers> nel file di configurazione della pre-elaborazione DReplay.exe.preprocess.config.The filter is added by modifying the <PreprocessModifiers> element in the preprocess configuration file, DReplay.exe.preprocess.config.

Nell'esempio seguente viene illustrato un file di configurazione modificato:The following shows an example of the modified configuration file:

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

AutorizzazioniPermissions

È necessario eseguire lo strumento di amministrazione come utente interattivo, scegliendo tra utente locale e account utente di dominio.You must run the administration tool as an interactive user, as either a local user or a domain user account. Per utilizzare un account utente locale, lo strumento di amministrazione e il controller devono essere eseguiti nello stesso computer.To use a local user account, the administration tool and controller must be running on the same computer.

Per altre informazioni, vedere Sicurezza di Distributed Replay.For more information, see Distributed Replay Security.

Vedere ancheSee Also

Preparazione dei dati di traccia di input Prepare the Input Trace Data
SQL Server Distributed Replay SQL Server Distributed Replay
Configurare Riesecuzione distribuitaConfigure Distributed Replay