Opción de preprocesamiento (herramienta de administración Distributed Replay)
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
-m controller
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.
-i input_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.
-d controller_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.
-c config_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.
-f status_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.