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

  • 아티클

적용 대상: SQL Server 2016(13.x), SQL Server 2017(14.x), SQL Server 2019(15.x)

중요

SQL Server Distributed Replay는 SQL Server 2022(16.x)에서 사용할 수 없습니다.

Microsoft SQL Server Distributed Replay 관리 도구인 DReplay.exe는 Distributed Replay Controller와 통신하는 데 사용할 수 있는 명령줄 도구입니다. 이 항목에서는 preprocess 명령줄 옵션과 해당 구문에 대해 설명합니다.

프로세스 옵션은 전처리 단계를 시작합니다. 이 단계 동안 컨트롤러는 대상 서버에 대해 재생할 입력 추적 데이터를 준비합니다.

관리 도구 구문에서 사용되는 구문 표기 규칙에 대한 자세한 내용은 Transact-SQL 구문 표기 규칙을 참조하세요.

구문


dreplay preprocess [-m controller] -i input_trace_file  
    -d controller_working_dir [-c config_file] [-f status_interval]

매개 변수

-mcontroller
컨트롤러의 컴퓨터 이름을 지정합니다. "localhost" 또는 "."을 사용하여 로컬 컴퓨터를 참조할 수 있습니다.

-m 매개 변수를 지정하지 않으면 로컬 컴퓨터가 사용됩니다.

-iinput_trace_file
컨트롤러에서 입력 추적 파일의 전체 경로(예: D:\Mytrace.trc)를 지정합니다. -i 매개 변수는 필수 항목입니다.

같은 디렉터리에 롤오버 파일이 있으면 자동으로 로드되어 사용됩니다. 파일은 파일 롤오버 명명 규칙을 따라야 합니다(예: Mytrace.trc, Mytrace_1.trc, Mytrace_2.trc, Mytrace_3.trc, Mytrace_n.trc).

참고

컨트롤러와는 다른 컴퓨터에서 관리 도구를 사용하는 경우 이 매개 변수에 로컬 경로를 사용할 수 있도록 입력 추적 파일을 컨트롤러로 복사해야 합니다.

-dcontroller_working_dir
컨트롤러에서 중간 파일이 저장될 디렉터리를 지정합니다. -d 매개 변수는 필수 항목입니다.

적용되는 요구 사항은 다음과 같습니다.

  • 디렉터리가 컨트롤러에 있어야 합니다.

  • 드라이브 문자로 시작하는 전체 경로(예: c:\WorkingDir)를 지정해야 합니다.

  • 경로가 백슬래시("\")로 끝나지 않아야 합니다.

  • UNC 경로는 지원되지 않습니다.

-cconfig_file
전처리 구성 파일의 전체 경로이며, 다른 위치에 저장된 경우 전처리 구성 파일의 위치를 지정하는 데 사용됩니다. 이 매개 변수는 UNC 경로이거나 관리 도구를 실행하는 컴퓨터에 로컬로 있을 수 있습니다.

필터링이 필요 없거나 최대 유휴 시간을 수정하지 않으려는 경우에는 -c 매개 변수를 지정하지 않아도 됩니다.

-c 매개 변수를 지정하지 않을 경우 기본 전처리 구성 파일 DReplay.exe.preprocess.config가 사용됩니다.

-fstatus_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 Security을 참조하세요.

참고 항목