Opción de preprocesamiento (herramienta de administración Distributed Replay)

  • Artículo

Se aplica a: SQL Server 2016 (13.x), SQL Server 2017 (14.x) y SQL Server 2019 (15.x)

Importante

Distributed Replay de SQL Server no está disponible con la versión preliminar de SQL Server 2022 (16.x).

La herramienta de administración de Distributed Replay de Microsoft SQL Server, DReplay.exe, es una herramienta de línea de comandos que se puede usar para comunicarse con el controlador de reproducción distribuida. En este tema se describen la opción del símbolo del sistema preprocess y la sintaxis correspondiente.

La opción preprocess inicia la fase de preprocesamiento. Durante esta fase, el controlador prepara los datos de seguimiento de entrada para la reproducción en el servidor destino.

Para obtener más información sobre las convenciones de sintaxis que se usan con la sintaxis de la herramienta de administración, vea Convenciones de sintaxis de Transact-SQL.

Sintaxis


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

Parámetros

-mcontroller
Especifica el nombre del equipo que se va a controlar. Puede utilizar "localhost" o "." para hacer referencia al equipo local.

Si no se especifica el parámetro -m, se usará el equipo local.

-iinput_trace_file
Especifica la ruta de acceso completa del archivo de seguimiento de entrada en el controlador, por ejemplo, D:\Mytrace.trc. El parámetro -i es obligatorio.

Si hay archivos de sustitución incremental en el mismo directorio, se cargarán y usarán automáticamente. Los archivos deben seguir la convención de nomenclatura de sustitución incremental de archivos, por ejemplo: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc... Mytrace_n.trc.

Nota:

Si está usando la herramienta de administración en un equipo que no es el controlador, tendrá que copiar los archivos de seguimiento de entrada en el controlador de forma que se pueda usar una ruta de acceso local para este parámetro.

-dcontroller_working_dir
Especifica el directorio del controlador donde se almacenará el archivo intermedio. El parámetro -d es obligatorio.

Se aplican los siguientes requisitos:

  • El directorio debe residir en el controlador.

  • Debe especificar la ruta de acceso completa, comenzando por una letra de unidad (por ejemplo, c:\WorkingDir).

  • La ruta de acceso no debe finalizar con una barra diagonal inversa "\".

  • No se admiten rutas de acceso UNC.

-cconfig_file
Es la ruta de acceso completa del archivo de configuración de preprocesamiento; se usa para especificar la ubicación del archivo de configuración del preprocesamiento cuando está almacenado en una ubicación diferente. Este parámetro puede ser una ruta UNC o puede residir localmente en el equipo donde se ejecuta la herramienta de administración.

El parámetro -c no es obligatorio si no se necesita ningún filtrado o si no se quiere modificar el tiempo de inactividad máximo.

Sin el parámetro -c , se usa el archivo de configuración de preprocesamiento predeterminado, DReplay.exe.preprocess.config.

-fstatus_interval
Especifica la frecuencia (en segundos) con la que se muestran los mensajes de estado.

Si no se especifica -f, el intervalo predeterminado es de 30 segundos.

Ejemplos

En este ejemplo, la copia intermedia del preprocesamiento se inicia con toda la configuración predeterminada. El valor localhost indica que el servicio del controlador se está ejecutando en el mismo equipo que la herramienta de administración. El parámetro input_trace_file especifica la ubicación de los datos de seguimiento de entrada, c:\mytrace.trc. Dado que no se usa ningún filtrado de archivos de seguimiento, es necesario especificar el parámetro -c.

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

En este ejemplo, se inicia la fase de preprocesamiento y se especifica un archivo de configuración del preprocesamiento modificado. A diferencia del ejemplo anterior, el parámetro -c se usa para indicar el archivo de configuración modificado, si se ha almacenado en otra ubicación. Por ejemplo:

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

En el archivo de configuración del preprocesamiento modificado, se agrega una condición de filtro que deja fuera las sesiones del sistema durante la reproducción distribuida. El filtro se agrega modificando el elemento <PreprocessModifiers> del archivo de configuración del preprocesamiento, DReplay.exe.preprocess.config.

En el ejemplo siguiente se muestra un ejemplo del archivo de configuración modificado:

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

Permisos

Debe ejecutar la herramienta de administración como un usuario interactivo, como un usuario local o una cuenta de usuario de dominio. Para utilizar una cuenta de usuario local, la herramienta de administración y el controlador se deben estar ejecutando en el mismo equipo.

Para más información, consulte Distributed Replay Security.

Consulte también