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.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

另请参阅