preprocess 选项（分布式重播管理工具）
适用于：
SQL Server 2016 (13.x)、SQL Server 2017 (14.x) 和 SQL Server 2019 (15.x)
重要
SQL Server Distributed Replay 在 SQL Server 2022 (16.x) 中不可用。
Microsoft SQL Server Distributed Replay 管理工具 DReplay.exe 是一个命令行工具，可用于与 Distributed Replay 控制器进行通信。 本主题介绍 preprocess 命令行选项和相应的语法。
preprocess 选项用于启动预处理阶段。 在此阶段，控制器会准备对针对目标服务器进行重播的输入跟踪数据。
有关与此管理工具语法结合使用的语法约定的详细信息，请参阅 Transact-SQL 语法约定。
语法
dreplay preprocess [-m controller] -i input_trace_file
-d controller_working_dir [-c config_file] [-f status_interval]
参数
-m controller
指定控制器的计算机名称。 可以用“localhost”或“.”指代本地计算机。
如果未指定 -m 参数，则使用本地计算机。
-i input_trace_file
指定控制器上输入跟踪文件的完整路径，例如 D:\Mytrace.trc。 -i 参数是必需的。
如果同一目录中存在滚动更新文件，则会自动加载并使用这些文件。 文件必须遵循文件滚动更新命名约定，例如：Mytrace.trc、Mytrace_1.trc、Mytrace_2.trc、Mytrace_3.trc…Mytrace_n.trc。
注意
如果要在控制器以外的其他计算机上使用管理工具，则需要将输入跟踪文件复制到控制器上，以便可以对此参数使用本地路径。
-d controller_working_dir
指定控制器上用于存储中间文件的目录。 -d 参数是必需的。
需要满足以下要求：
目录必须位于控制器上。
必须指定以驱动器号开头（例如
c:\WorkingDir）的完整路径。路径不能以反斜杠“
\”结尾。不支持 UNC 路径。
-c config_file
预处理配置文件的完整路径；当预处理配置文件存储在其他位置时，用于指定该配置文件的位置。 此参数可以是 UNC 路径，也可以是您运行管理工具的计算机上的本地路径。
如果不需要筛选，或者不想修改最大空闲时间，则 -c 参数不是必需的。
如果不使用 -c 参数，将使用默认预处理配置文件 DReplay.exe.preprocess.config。
-f status_interval
指定显示状态消息的频率（以秒为单位）。
如果未指定 -f，则默认间隔为 30 秒。
示例
在本示例中，预处理阶段采用所有默认设置启动。 值 localhost 表示控制器服务与管理工具在同一计算机上运行。 Input_trace_file 参数指定输入跟踪数据的位置 c:\mytrace.trc。 由于不涉及跟踪文件筛选，因此必须指定 -c 参数。
dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir
在本示例中，启动了预处理阶段并指定了修改过的预处理配置文件。 与前面的示例不同，-c 参数用于指向修改过的配置文件（如果你将该文件存储在其他位置）。 例如：
dreplay preprocess -m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config
在修改过的预处理配置文件中，添加了筛选条件以在分布式重播期间筛选掉系统会话。 可通过修改预处理配置文件 <PreprocessModifiers> 中的 DReplay.exe.preprocess.config元素来添加筛选器。
下面是修改过的配置文件的示例：
<?xml version='1.0'?>
<Options>
<PreprocessModifiers>
<IncSystemSession>No</IncSystemSession>
<MaxIdleTime>-1</MaxIdleTime>
</PreprocessModifiers>
</Options>
权限
您必须作为交互用户、本地用户或域用户帐户运行管理工具。 若要使用本地用户帐户，管理工具和控制器必须在同一台计算机上运行。
有关详细信息，请参阅 Distributed Replay Security。