前置處理選項 (Distributed Replay 管理工具)
適用於： 
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 Controller 通訊。 本主題描述 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 安全性。