preprocess 选项（Distributed Replay 管理工具）

适用于： SQL Server 2016 (13.x) SQL Server 2017 (14.x) SQL Server 2019 (15.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控制器
指定控制器的计算机名称。 可以用“localhost”或“.”指代本地计算机。

如果未指定 -m 参数，则使用本地计算机。

-iinput_trace_file
指定控制器上输入跟踪文件的完整路径，例如 D:\Mytrace.trc。 -i 参数是必需的。

如果同一目录中存在滚动更新文件，则会自动加载并使用这些文件。 文件必须遵循文件滚动更新命名约定，例如：Mytrace.trc、Mytrace_1.trc、Mytrace_2.trc、Mytrace_3.trc…Mytrace_n.trc。

-dcontroller_working_dir
指定控制器上用于存储中间文件的目录。 -d 参数是必需的。

需要满足以下要求：

• 目录必须位于控制器上。

• 必须指定以驱动器号开头（例如 c:\WorkingDir）的完整路径。

• 路径不能以反斜杠“\”结尾。

• 不支持 UNC 路径。

-cconfig_file
预处理配置文件的完整路径；当预处理配置文件存储在其他位置时，用于指定该配置文件的位置。 此参数可以是 UNC 路径，也可以是你运行管理工具的计算机上的本地路径。

如果不需要筛选，或者不想修改最大空闲时间，则 -c 参数不是必需的。

如果不使用 -c 参数，将使用默认预处理配置文件 。DReplay.exe.preprocess.config

-f状态间隔
指定显示状态消息的频率（以秒为单位）。

如果未指定 -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 安全性。

另请参阅

• 准备输入跟踪数据
• SQL Server 分布式重播
• 配置 Distributed Replay