preprocess 选项(分布式重播管理工具)

Microsoft SQL Server Distributed Replay 管理工具是一种命令行工具, DReplay.exe可用于与分布式重播控制器通信。 本主题介绍 preprocess 命令行选项和相应的语法。

preprocess 选项用于启动预处理阶段。 在此阶段,控制器会准备对针对目标服务器进行重播的输入跟踪数据。

“主题链接”图标有关与管理工具语法一起使用的语法约定的详细信息,请参阅 Transact-SQL 语法约定(Transact-SQL)。

语法


      dreplay preprocess [-mcontroller] -iinput_trace_file
    -dcontroller_working_dir [-cconfig_file] [-fstatus_interval]

参数

-m 控制器 指定控制器的计算机名称。 可以用“localhost”或“.”指代本地计算机。

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

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

如果同一目录中存在滚动更新文件,则会自动加载并使用这些文件。 文件必须遵循文件滚动更新命名约定,例如:Mytrace.trcMytrace_1.trcMytrace_2.trcMytrace_3.trcMytrace_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

另请参阅

准备输入跟踪数据SQL Server Distributed Replay 配置 Distributed Replay