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]

参数

-mcontroller
指定控制器的计算机名称。 可以用“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。

-fstatus_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。

另请参阅