재생 옵션(Distributed Replay Administration Tool)Replay Option (Distributed Replay Administration Tool)

이 항목 적용 대상: 예SQL Server없습니다Azure SQL 데이터베이스없습니다Azure SQL 데이터 웨어하우스 없습니다 병렬 데이터 웨어하우스THIS TOPIC APPLIES TO: yesSQL ServernoAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse MicrosoftMicrosoft SQL ServerSQL Server Distributed Replay 관리 도구인 DReplay.exe, distributed replay controller와 통신 하는 데 사용할 수 있는 명령줄 도구입니다. The MicrosoftMicrosoft SQL ServerSQL Server Distributed Replay administration tool, DReplay.exe, is a command-line tool that you can use to communicate with the distributed replay controller. 이 항목에서는 replay 명령줄 옵션과 해당 구문에 대해 설명합니다.This topic describes the replay command-line option and corresponding syntax.

replay 옵션은 이벤트 재생 단계를 시작합니다. 이 단계에서 컨트롤러는 재생 데이터를 지정된 클라이언트로 발송하고 분산 재생을 시작하며 클라이언트를 동기화합니다.The replay option initiates the event replay stage, in which the controller dispatches replay data to the specified clients, launches the distributed replay and synchronizes the clients. 필요에 따라 재생에 참여하는 각 클라이언트는 재생 작업을 기록하고 결과 추적 파일을 로컬에 저장할 수 있습니다.Optionally, each client participating in the replay can record the replay activity and save a result trace file locally.

항목 링크 아이콘 관리 도구 구문과 함께 사용 되는 구문 표기 규칙에 대 한 자세한 내용은 참조 하십시오. TRANSACT-SQL 구문 표기 규칙 ( Transact SQL ) .Topic link icon For more information about the syntax conventions that are used with the administration tool syntax, see Transact-SQL Syntax Conventions (Transact-SQL).

구문Syntax


dreplay replay [-m controller] -d controller_working_dir [-o]  
    [-s target_server] -w clients [-c config_file]  
    [-f status_interval]  

매개 변수Parameters

-m controller-m controller
컨트롤러의 컴퓨터 이름을 지정합니다.Specifies the computer name of the controller. "localhost" 또는 "."을 사용하여 로컬 컴퓨터를 참조할 수 있습니다.You can use "localhost" or "." to refer to the local computer.

-m 매개 변수를 지정하지 않으면 로컬 컴퓨터가 사용됩니다.If the -m parameter is not specified, the local computer is used.

-d controller_working_dir-d controller_working_dir
컨트롤러에서 중간 파일이 저장될 디렉터리를 지정합니다.Specifies the directory on the controller where the intermediate file will be stored. -d 매개 변수는 필수 항목입니다.The -d parameter is required.

적용되는 요구 사항은 다음과 같습니다.The following requirements apply:

  • 디렉터리가 컨트롤러에 있어야 합니다.The directory must reside on the controller.

  • 드라이브 문자로 시작하는 전체 경로(예: c:\WorkingDir)를 지정해야 합니다.You must specify the full path, starting with a drive letter (for example, c:\WorkingDir).

  • 경로가 백슬래시("\")로 끝나지 않아야 합니다.The path must not end with a backslash "\".

  • UNC 경로는 지원되지 않습니다.UNC paths are not supported.

    -o-o
    클라이언트의 재생 작업을 캡처하여 클라이언트 구성 파일 <ResultDirectory>DReplayClient.xml요소에 지정된 경로에 있는 결과 추적 파일에 저장합니다.Captures the clients' replay activity and saves it to a result trace file in the path specified by the <ResultDirectory> element in the client configuration file, DReplayClient.xml.

    –o 매개 변수를 지정하지 않으면 결과 추적 파일이 생성되지 않습니다.When the –o parameter is not specified, the result trace file is not generated. 콘솔 출력은 재생이 끝날 때 요약 정보를 반환하지만 그 외 다른 재생 통계는 사용할 수 없습니다.The console output returns summary information at the end of replay, but no other replay statistics are available.

    -s target_server-s target_server
    분산 작업이 재생될 대상 SQL ServerSQL Server 인스턴스를 지정합니다.Specifies the target instance of SQL ServerSQL Server that the distributed workload should be replayed against. 이 매개 변수는 server_name[\인스턴스 이름]형식으로 지정해야 합니다.You must specify this parameter in the format server_name[\instance name].

    "localhost" 또는 "."을 대상 서버로 사용할 수 없습니다.You cannot use "localhost" or "." as the target server.

    재생 구성 파일 섹션에 <Server> 요소가 지정되어 있으면 <ReplayOptions> -s DReplay.exe.replay.config매개 변수를 지정할 필요가 없습니다.The -s parameter is not required if the <Server> element is specified in the <ReplayOptions> section of the replay configuration file, DReplay.exe.replay.config.

    -s 매개 변수를 사용하는 경우 재생 구성 파일의 <Server> 섹션에 있는 <ReplayOptions> 요소가 무시됩니다.If the -s parameter is used, the <Server> element in the <ReplayOptions> section of the replay configuration file will be ignored.

    -w clients-w clients
    이 필수 매개 변수는 분산 재생에 참여할 클라이언트의 컴퓨터 이름을 지정하는 쉼표로 구분된 목록(공백 없음)입니다.This required parameter is a comma-separated list (without spaces) that specifies the computer names of clients that should participate in the distributed replay. IP 주소는 허용되지 않습니다.IP addresses are not allowed. 클라이언트가 컨트롤러에 이미 등록되어 있어야 합니다.Be aware that the clients must already be registered with the controller.

참고

각 클라이언트는 클라이언트 서비스가 시작될 때 클라이언트 구성 파일에 지정된 컨트롤러에 등록됩니다.Each client registers with the controller that is specified in the client configuration file when the client service starts.

-c config_file-c config_file
재생 구성 파일의 전체 경로이며, 다른 위치에 저장된 경우 파일의 위치를 지정하는 데 사용됩니다.Is the full path of the replay configuration file; used to specify the location when it is stored in a different location.

재생 구성 파일 의 기본값을 사용하려는 경우 -c DReplay.exe.replay.config매개 변수를 지정할 필요가 없습니다.The -c parameter is not required if you want to use the default values of the replay configuration file, DReplay.exe.replay.config.

-f status_interval-f status_interval
상태를 표시할 빈도(초)를 지정합니다.Specifies the frequency (in seconds) at which to display the status.

-f 를 지정하지 않을 경우 기본 간격은 30초입니다.If -f is not specified, the default interval is 30 seconds.

Examples

이 예에서는 분산 재생 동작의 대부분이 수정된 재생 구성 파일인 DReplay.exe.replay.config에서 파생됩니다.In this example, the distributed replay derives much of its behavior from a modified replay configuration file, DReplay.exe.replay.config.

  • -m 매개 변수는 controller1 이라는 컴퓨터가 컨트롤러로 사용되도록 지정합니다.The -m parameter specifies that a computer named controller1 acts as the controller. 컨트롤러 서비스가 다른 컴퓨터에서 실행 중일 때는 컴퓨터 이름을 반드시 지정해야 합니다.The computer name must be specified when the controller service is running on a different computer.

  • -d 매개 변수는 컨트롤러에서 중간 파일의 위치( c:\WorkingDir)를 지정합니다.The -d parameter specifies the location of the intermediate file on the controller, c:\WorkingDir.

  • -o 매개 변수는 지정된 각 클라이언트가 재생 작업을 캡처하여 결과 추적 파일에 저장하도록 지정합니다.The -o parameter specifies that each specified client capture the replay activity and save it to a result trace file. 참고: 구성 파일의 <ResultTrace> 요소를 사용하면 행 개수 및 결과 집합을 기록할지 여부를 지정할 수 있습니다.Note: The <ResultTrace> element in the configuration file can be used to specify if row count and result set be recorded.

  • -w 매개 변수는 client1 부터 client4 까지의 컴퓨터가 분산 재생에 클라이언트로 참여하도록 지정합니다.The -w parameter specifies that computers client1 through client4 participate as clients in the distributed replay.

  • -c 매개 변수는 수정된 구성 파일인 DReplay.exe.replay.config를 가리키는 데 사용됩니다.The -c parameter is used to point to the modified configuration file, DReplay.exe.replay.config.

  • 재생 구성 파일 요소에 <Server> 요소가 지정되어 있으므로 <ReplayOptions> -s DReplay.exe.replay.config매개 변수를 지정할 필요가 없습니다.The -s parameter is not required because the <Server> element is specified in the <ReplayOptions> element of the replay configuration file, DReplay.exe.replay.config.

    다음 구문을 사용하여 이벤트 재생 단계가 시작되며 이때 관리 도구는 컨트롤러와는 다른 컴퓨터에서 실행됩니다.The event replay stage is initiated with the following syntax, when the administration tool is run from a different computer than the controller:

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값으로 설정되었습니다.To specify a synchronous sequencing mode, the <SequencingMode> element of the DReplay.exe.replay.config file is set equal to the value synchronization. 행 개수를 기록하도록 지정하기 위해 재생 구성 파일의 <ResultTrace> 섹션이 수정되었습니다.The <ResultTrace> section of the replay configuration file is modified to specify that row count be recorded. 다음 XML 예에서는 이러한 변경 내용을 보여 줍니다.These changes are shown in the following XML example:

<?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값으로 설정되었습니다.To specify a stress sequencing mode, the <SequencingMode> element of the DReplay.exe.replay.config file is set equal to the value stress. <ConnectTimeScale><ThinkTimeScale> 요소는 50%를 지정하기 위해 50 으로 설정되었습니다.The <ConnectTimeScale> and <ThinkTimeScale> elements are set to the value 50 (to specify 50 percent). 연결 시간 및 대기 시간에 대한 자세한 내용은 Configure Distributed Replay를 참조하십시오.For more information about connect time and think time, see Configure Distributed Replay. 다음 XML 예에서는 이러한 변경 내용을 보여 줍니다.These changes are shown in the following XML example:

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

사용 권한Permissions

관리 도구는 로컬 사용자 또는 도메인 사용자 등의 대화형 사용자 계정으로 실행해야 합니다.You must run the administration tool as an interactive user, as either a local user or a domain user account. 로컬 사용자 계정을 사용하려면 관리 도구와 컨트롤러가 동일한 컴퓨터에서 실행되고 있어야 합니다.To use a local user account, the administration tool and controller must be running on the same computer.

자세한 내용은 Distributed Replay Security을 참조하세요.For more information, see Distributed Replay Security.

참고 항목See Also

추적 데이터 재생 Replay Trace Data
재생 결과 검토 Review the Replay Results
SQL Server Distributed Replay SQL Server Distributed Replay
Distributed Replay 구성 Configure Distributed Replay
SQL Server Distributed Replay 포럼 SQL Server Distributed Replay Forum
사용 하 여 Distributed Replay를 2 부-SQL Server 테스트 로드 Using Distributed Replay to Load Test Your SQL Server – Part 2
사용 하 여 Distributed Replay를 1 부-SQL Server 테스트 로드Using Distributed Replay to Load Test Your SQL Server - Part 1