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

[アーティクル]
2017-06-13

Microsoft SQL Server 分散再生管理ツール (DReplay.exe) は、分散再生コントローラーとの通信に使用できるコマンドラインツールです。このトピックでは、 replay コマンドラインオプションとそれに対応する構文について説明します。

replay オプションはイベント再生段階を開始します。ここでは、コントローラーは、指定されたクライアントに再生データをディスパッチし、分散再生を開始して、クライアントを同期します。必要に応じて、再生に参加している各クライアントは再生アクティビティを記録し、結果トレースファイルをローカルに保存できます。

トピックリンクアイコン管理ツールの構文で使用される構文規則の詳細については、「 Transact-SQL 構文規則 (Transact-SQL)」を参照してください。

構文


      dreplay replay [-mcontroller] -dcontroller_working_dir [-o]
    [-starget_server] -wclients [-cconfig_file]
    [-fstatus_interval]

パラメーター

-m controller コントローラーのコンピューター名を指定します。 "localhost" または "." を使用してローカルコンピューターを参照できます。

-m パラメーターが指定されていない場合、ローカルコンピューターが使用されます。

-d controller_working_dir 中間ファイルを格納するコントローラー上のディレクトリを指定します。 -d パラメーターは必須です。

これには次の要件があります。

ディレクトリはコントローラー上に置く必要があります。
ドライブ文字で始まる完全なパスを指定する必要があります (たとえば、 c:\WorkingDir)。
パスはバックスラッシュ "\" で終了することはできません。
UNC パスはサポートされません。

-o クライアントの再生アクティビティをキャプチャし、クライアント構成ファイルの <ResultDirectory> 要素で指定されたパスの結果トレースファイルに保存 DReplayClient.xml。

-o パラメーターが指定されていない場合は、結果トレースファイルは生成されません。コンソール出力は再生の最後に概要情報を返しますが、他の再生統計情報は提供されません。

-s target_server 分散ワークロードの再生対象となる SQL Server のターゲットインスタンスを指定します。このパラメーターは、 server_name[\instance name] の形式で指定します。

"localhost" または "." をターゲットサーバーとして使用することはできません。

再生構成ファイルのセクションに <Server> 要素が指定されている場合、 <ReplayOptions> -s DReplay.exe.replay.configパラメーターは必要ありません。

-s パラメーターが使用されている場合、再生構成ファイルの <Server> セクションの <ReplayOptions> 要素は無視されます。

-w clients この必須パラメーターは、分散再生に参加する必要があるクライアントのコンピューター名を指定するコンマ区切りのリスト (スペースなし) です。 IP アドレスは指定できません。コントローラーにクライアントが既に登録されている必要があることに注意してください。

Note

クライアントサービスが開始するときに、クライアント構成ファイルで指定されているコントローラーにクライアントが登録されます。

-c config_file 再生構成ファイルの完全なパスです。別の場所に格納される場所を指定するために使用されます。

再生構成ファイル の既定値を使用する場合、 -c DReplay.exe.replay.configパラメーターは必要ありません。

-f status_interval 状態を表示する頻度 (秒単位) を指定します。

-f を指定しない場合は、既定の間隔は 30 秒です。

例

この例の分散再生では、変更された再生構成ファイル DReplay.exe.replay.configから多くの動作が派生しています。

-m パラメーターは、 controller1 というコンピューターがコントローラーとして動作するように指定しています。コントローラーサービスが別のコンピューターで実行されている場合は、コンピューター名を指定する必要があります。
-d パラメーターは、コントローラーの中間ファイルの場所として c:\WorkingDirを指定しています。
-o パラメーターは、指定された各クライアントが再生アクティビティをキャプチャし、それを結果トレースファイルに保存するように指定しています。注:構成ファイル内の <ResultTrace> 要素は、行数と結果セットが記録される場合に使用できます。
-w パラメーターは、 client1 から client4 までのコンピューターがクライアントとして分散再生に参加するように指定しています。
-c パラメーターは、変更された構成ファイル DReplay.exe.replay.configを指すために使用されています。
再生構成ファイルの要素で <Server> 要素が指定されているため、 <ReplayOptions> -s DReplay.exe.replay.configパラメーターは必要ありません。

管理ツールがコントローラーとは別のコンピューターから実行される場合、イベント再生段階は、次の構文で開始されます。

dreplay replay -m controller1 -d c:\WorkingDir -o -w client1,client2,client3,client4 -c c:\DReplay.exe.replay.config

同期シーケンスモードを指定するために、 <SequencingMode> ファイルの DReplay.exe.replay.config 要素が値 synchronizationと同じに設定されます。再生構成ファイルの <ResultTrace> セクションは、行数を記録するように変更されます。これらの変更を示したものが、次の XML 例です。

<?xml version='1.0'?>
<Options>
    <ReplayOptions>
        <Server>server_name\replay_target_instance</Server>
        <SequencingMode>synchronization</SequencingMode>
        <ConnectTimeScale></ConnectTimeScale>
        <ThinkTimeScale></ThinkTimeScale>
        <HealthmonInterval>60</HealthmonInterval>
        <QueryTimeout>3600</QueryTimeout>
        <ThreadsPerClient></ThreadsPerClient>
    </ReplayOptions>
    <OutputOptions>
        <ResultTrace>
            <RecordRowCount>Yes</RecordRowCount>
            <RecordResultSet>No</RecordResultSet>
        </ResultTrace>
    </OutputOptions>
</Options>

ストレスシーケンスモードを指定するために、 <SequencingMode> ファイルの DReplay.exe.replay.config 要素が値 stressと同じに設定されます。 <ConnectTimeScale> および <ThinkTimeScale> 要素が値 50 に設定されます (50% を指定する場合)。接続時間と待ち時間の詳細については、「 Configure Distributed Replay」を参照してください。これらの変更を示したものが、次の XML 例です。

<?xml version='1.0'?>
<Options>
    <ReplayOptions>
        <Server>server_name\replay_target_instance_name</Server>
        <SequencingMode>stress</SequencingMode>
        <ConnectTimeScale>50</ConnectTimeScale>
        <ThinkTimeScale>50</ThinkTimeScale>
        <HealthmonInterval>60</HealthmonInterval>
        <QueryTimeout>3600</QueryTimeout>
        <ThreadsPerClient></ThreadsPerClient>
    </ReplayOptions>
    <OutputOptions>
        <ResultTrace>
            <RecordRowCount>Yes</RecordRowCount>
            <RecordResultSet>No</RecordResultSet>
        </ResultTrace>
    </OutputOptions>
</Options>

アクセス許可

対話ユーザー (ローカルユーザーまたはドメインユーザーアカウント) として、管理ツールを実行する必要があります。ローカルユーザーアカウントを使用するには、管理ツールとコントローラーが同じコンピューター上で実行されている必要があります。

詳細については、「 Distributed Replay Security」を参照してください。

参照

トレースデータの再生再生結果の確認 SQL Server 分散再生分散再生SQL Server 分散再生フォーラムの構成分散再生を使用して SQL Server をロードテストする - パート 2 分散再生を使用して SQL Server をロードテストする - パート 1

次の方法で共有

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

構文

パラメーター

例

アクセス許可

参照

その他のリソース