前処理オプション (Distributed Replay 管理ツール)

  • [アーティクル]

Microsoft SQL Server Distributed Replay 管理ツールである DReplay.exe は、Distributed Replay Controller と通信するために使用できるコマンド ライン ツールです。 このトピックでは、preprocess コマンド ライン オプションとそれに対応する構文について説明します。

preprocess オプションは、前処理段階を開始します。 この段階では、対象サーバーに対して、コントローラーが入力トレース データの再生の準備を行います。

トピック リンク アイコン 管理ツールの構文で使用される構文表記規則の詳細については、「Transact-SQL 構文表記規則 (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 のセキュリティ」を参照してください。

関連項目

タスク

入力トレース データの準備

概念

SQL Server Distributed Replay

Distributed Replay の構成