전처리 옵션(Distributed Replay Utility Administration Tool)Preprocess Option (Distributed Replay Administration Tool)

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. 이 항목에서는 preprocess 명령줄 옵션과 해당 구문에 대해 설명합니다.This topic describes the preprocess command-line option and corresponding syntax.

프로세스 옵션은 전처리 단계를 시작합니다.The preprocess option initiates the preprocess stage. 이 단계 동안 컨트롤러는 대상 서버에 대해 재생할 입력 추적 데이터를 준비합니다.During this stage, the controller prepares the input trace data for replay against the target server.

항목 링크 아이콘 관리 도구 구문과 함께 사용 되는 구문 표기 규칙에 대 한 자세한 내용은 참조 하십시오. 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 preprocess [-m controller] -i input_trace_file  
    -d controller_working_dir [-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.

-i input_trace_file-i input_trace_file
컨트롤러에서 입력 추적 파일의 전체 경로(예: D:\Mytrace.trc)를 지정합니다.Specifies the full path of the input trace file on the controller, such as D:\Mytrace.trc. -i 매개 변수는 필수 항목입니다.The -i parameter is required.

같은 디렉터리에 롤오버 파일이 있으면 자동으로 로드되어 사용됩니다.If there are rollover files in the same directory, they will be loaded and used automatically. 파일은 파일 롤오버 명명 규칙을 따라야 합니다. 예를 들면 Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc…과 같습니다.The files must follow the file rollover naming convention, for example: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, … Mytrace_n.trc을 참조하세요.Mytrace_n.trc.

참고

컨트롤러와는 다른 컴퓨터에서 관리 도구를 사용하는 경우 이 매개 변수에 로컬 경로를 사용할 수 있도록 입력 추적 파일을 컨트롤러로 복사해야 합니다.If you are using the administration tool on a different computer than the controller, you will need to copy the input trace files to the controller so that a local path can be used for this parameter.

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

    -c config_file-c config_file
    전처리 구성 파일의 전체 경로이며, 다른 위치에 저장된 경우 전처리 구성 파일의 위치를 지정하는 데 사용됩니다.Is the full path of the preprocess configuration file; used to specify the location of the preprocess configuration file when stored in a different location. 이 매개 변수는 UNC 경로이거나 관리 도구를 실행하는 컴퓨터에 로컬로 있을 수 있습니다.This parameter can be a UNC path, or can reside locally on the computer where you run the administration tool.

    필터링이 필요 없거나 최대 유휴 시간을 수정하지 않으려는 경우에는 -c 매개 변수를 지정하지 않아도 됩니다.The -c parameter is not required if no filtering is needed, or if you do not want to modify the maximum idle time.

    -c 매개 변수를 지정하지 않을 경우 기본 전처리 구성 파일 DReplay.exe.preprocess.config가 사용됩니다.Without the -c parameter, the default preprocess configuration file, DReplay.exe.preprocess.config, is used.

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

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

Examples

이 예에서는 모든 기본 설정을 사용하여 전처리 단계가 시작됩니다.In this example, the preprocess stage is initiated with all of the default settings. localhost 값은 컨트롤러 서비스가 관리 도구와 동일한 컴퓨터에서 실행 중임을 나타냅니다.The value localhost indicates that the controller service is running on the same computer as the administration tool. input_trace_file 매개 변수는 입력 추적 데이터 c:\mytrace.trc의 위치를 지정합니다.The input_trace_file parameter specifies the location of the input trace data, c:\mytrace.trc. 추적 파일 필터링은 사용되지 않으므로 -c 매개 변수는 지정할 필요가 없습니다.Because there is no trace file filtering involved, the -c parameter does have to be specified.

dreplay preprocess –m localhost -i c:\mytrace.trc -d c:\WorkingDir  

이 예에서는 전처리 단계가 시작되고 수정한 전처리 구성 파일이 지정됩니다.In this example, the preprocess stage is initiated and a modified preprocess configuration file is specified. 위의 예와는 달리 수정한 구성 파일을 다른 위치에 저장한 경우 -c 매개 변수를 사용하여 해당 위치를 가리켜야 합니다.Unlike the previous example, the -c parameter is used to point to the modified configuration file, if you have stored it in a different location. 예를 들어For example:

dreplay preprocess –m localhost -i c:\mytrace.trc -d c:\WorkingDir -c c:\DReplay.exe.preprocess.config  

수정한 전처리 구성 파일에는 분산 재생 중 시스템 세션을 필터링하는 필터 조건이 추가되었습니다.In the modified preprocess configuration file, a filter condition is added that filters out system sessions during distributed replay. 이 필터는 전처리 구성 파일 <PreprocessModifiers> 에서 DReplay.exe.preprocess.config요소를 수정하여 추가되었습니다.The filter is added by modifying the <PreprocessModifiers> element in the preprocess configuration file, DReplay.exe.preprocess.config.

다음은 수정된 구성 파일의 예입니다.The following shows an example of the modified configuration file:

<?xml version='1.0'?>  
<Options>  
    <PreprocessModifiers>  
        <IncSystemSession>No</IncSystemSession>  
        <MaxIdleTime>-1</MaxIdleTime>  
    </PreprocessModifiers>  
</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

입력된 추적 데이터 준비 Prepare the Input Trace Data
SQL Server Distributed Replay SQL Server Distributed Replay
Distributed Replay 구성Configure Distributed Replay