前置處理選項 (Distributed Replay 管理工具)
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.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 安全性。