dtexec 유틸리티(SSIS 도구)
dtexec 명령 프롬프트 유틸리티는 SQL Server Integration Services 패키지를 구성 및 실행하는 데 사용됩니다. dtexec 유틸리티에서는 연결, 속성, 변수, 로깅, 진행률 표시기 등의 모든 패키지 구성 및 실행 기능에 액세스할 수 있습니다. dtexec 유틸리티를 사용하면 Microsoft SQL Server 데이터베이스, SSIS 서비스 및 파일 시스템에서 패키지를 로드할 수 있습니다.
[!참고]
SQL Server 2008과 함께 제공되는 dtexec 유틸리티 버전을 사용하여 SQL Server 2005 Integration Services(SSIS) 패키지를 실행할 경우 Integration Services는 일시적으로 패키지를 SQL Server 2008 Integration Services(SSIS)로 업그레이드합니다. 그러나 dtexec 유틸리티를 사용하여 이러한 업그레이드된 변경 내용을 저장할 수는 없습니다. SQL Server 2005 패키지를 영구적으로 SQL Server 2008로 업그레이드하는 방법은 Integration Services 패키지 업그레이드을 참조하십시오.
64비트 컴퓨터에서의 dtexec (SSIS 도구) 설치 고려 사항
64비트 컴퓨터의 경우 Integration Services에서는 64비트 버전의 dtexec 유틸리티(dtexec.exe)를 설치합니다. 특정 패키지를 32비트 모드로 실행해야 하는 경우 dtexec 유틸리티의 32비트 버전을 설치해야 합니다. 32비트 버전의 dtexec 유틸리티를 설치하려면 설치 도중 클라이언트 도구 또는 Business Intelligence Development Studio를 선택해야 합니다.
기본적으로 64비트 및 32비트 버전의 Integration Services 명령 프롬프트 유틸리티가 모두 설치되어 있는 64비트 컴퓨터는 명령 프롬프트에서 32비트 버전을 실행합니다. 64비트 버전에 대한 디렉터리 경로 앞에 32비트 버전에 대한 디렉터리 경로가 PATH 환경 변수에 나타나기 때문에 32비트 버전이 실행됩니다. 일반적으로 32비트 디렉터리 경로는 <drive>:\Program Files(x86)\Microsoft SQL Server\100\DTS\Binn이며 64비트 디렉터리 경로는 <drive>:\Program Files\Microsoft SQL Server\100\DTS\Binn입니다.
[!참고]
SQL Server 에이전트를 사용하여 유틸리티를 실행하는 경우 SQL Server 에이전트는 64비트 버전의 유틸리티를 자동으로 사용합니다. SQL Server 에이전트는 PATH 환경 변수가 아닌 레지스트리를 사용하여 유틸리티에 대한 올바른 실행 파일을 찾습니다.
명령 프롬프트에서 64비트 버전의 유틸리티를 실행하기 위해 다음 동작 중 하나를 수행할 수 있습니다.
명령 프롬프트 창을 열고 64비트 버전의 유틸리티가 포함되어 있는 디렉터리(<drive>:\Program Files\Microsoft SQL Server\100\DTS\Binn)로 변경한 다음 해당 위치에서 유틸리티를 실행합니다.
명령 프롬프트에서 64비트 버전의 유틸리티에 대한 전체 경로(<drive>:\Program Files\Microsoft SQL Server\100\DTS\Binn)를 입력하여 유틸리티를 실행합니다.
변수에서 32비트 경로(<drive>:\ Program Files(x86)\Microsoft SQL Server\100\DTS\Binn) 앞에 64비트 경로(<drive>:\Program Files\Microsoft SQL Server\100\DTS\Binn)를 배치하여 PATH 환경 변수에서의 경로 순서를 영구적으로 변경합니다.
dtexec(SSIS 도구): 실행 단계
이 유틸리티를 실행하면 다음 4단계가 수행됩니다.
명령을 읽어들이는 단계: 명령 프롬프트는 지정된 옵션 및 인수 목록을 읽습니다. /? 또는 /HELP 옵션이 있으면 이후의 모든 단계를 건너 뜁니다.
패키지 로드 단계: /SQL, /FILE 또는 /DTS 옵션으로 지정된 패키지가 로드됩니다.
구성 단계: 옵션은 다음 순서로 처리됩니다.
패키지 플래그, 변수 및 속성을 설정하는 옵션
패키지 버전 및 빌드를 확인하는 옵션
보고와 같은 유틸리티의 런타임 동작을 구성하는 옵션
유효성 검사 및 실행 단계: 패키지가 실행됩니다. /VALIDATE 옵션을 지정한 경우에는 실행되지 않고 유효성이 검사됩니다.
dtexec(SSIS 도구): 반환된 종료 코드
패키지를 실행하면 dtexec에서 종료 코드를 반환할 수 있습니다. 종료 코드는 ERRORLEVEL 변수를 채우는 데 사용되며 이 변수의 값은 배치 파일 내의 분기 논리 또는 조건문에서 테스트될 수 있습니다. 다음 표에서는 dtexec 종료 시 유틸리티에서 설정할 수 있는 값을 나열합니다.
값 |
설명 |
|---|---|
0 |
패키지가 성공적으로 실행되었습니다. |
1 |
패키지가 실패했습니다. |
3 |
사용자가 패키지를 취소했습니다. |
4 |
유틸리티에서 요청된 패키지를 찾을 수 없습니다. 패키지를 찾을 수 없습니다. |
5 |
유틸리티에서 요청된 패키지를 로드할 수 없습니다. 패키지를 로드할 수 없습니다. |
6 |
유틸리티의 명령줄에서 내부 구문 오류 또는 의미 체계 오류가 발생했습니다. |
dtexec(SSIS 도구): 구문 규칙
모든 옵션은 슬래시(/) 또는 빼기 기호(-)로 시작해야 합니다. 여기에 표시된 옵션은 슬래시(/)로 시작하지만 빼기 기호(-)를 대신 사용할 수 있습니다.
인수에 공백이 있는 경우 따옴표로 묶어야 합니다. 인수를 따옴표로 묶지 않으면 인수에 공백을 사용할 수 없습니다.
따옴표로 묶인 문자열 안의 큰따옴표는 이스케이프된 작은따옴표를 나타냅니다.
암호를 제외한 옵션 및 인수는 대/소문자를 구분하지 않습니다.
xp_cmdshell에서 dtexec(SSIS 도구) 사용
xp_cmdshell 프롬프트에서 dtexec를 실행할 수 있습니다. 다음 예에서는 UpsertData.dtsx라는 패키지를 실행하고 반환 코드를 무시하는 방법을 보여 줍니다.
EXEC xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'
다음 예에서는 동일한 패키지를 실행하고 반환 코드를 캡처하는 방법을 보여 줍니다.
DECLARE @returncode int
EXEC @returncode = xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'
.gif "중요 정보") 중요 |
|---|
Microsoft SQL Server에서는 기본적으로 새 설치에 대해 xp_cmdshell 옵션을 사용할 수 없습니다. 이 옵션은 sp_configure 시스템 저장 프로시저를 실행하여 사용할 수 있습니다. 자세한 내용은 xp_cmdshell 옵션을 참조하십시오. |
구문
dtexec /option [value] [/option [value]]...
매개 변수
SQL Server 2000 dtsrun 유틸리티에 사용되는 명령 프롬프트 옵션이 SQL Serverdtexec 유틸리티에 사용되는 명령 프롬프트 옵션에 매핑되는 방법은 dtexec 옵션에 dtsrun 옵션 매핑을 참조하십시오.
옵션 |
설명 |
|---|---|
/? [option_name] |
선택 사항입니다. 지정된 option_name에 대한 명령 프롬프트 옵션 또는 도움말을 표시하고 유틸리티를 닫습니다. option_name 인수를 지정하면 dtexec는 SQL Server 온라인 설명서를 시작하고 dtexec 유틸리티(SSIS 도구) 항목을 표시합니다. |
/CheckF[ile]filespec |
선택 사항입니다. 패키지의 CheckpointFileName 속성을 filespec에 지정된 경로와 파일로 설정합니다. 이 파일은 패키지를 다시 시작할 때 사용됩니다. 이 옵션을 지정하고 파일 이름 값을 제공하지 않으면 패키지의 CheckpointFileName이 빈 문자열로 설정됩니다. 이 옵션을 지정하지 않으면 패키지의 값이 유지됩니다. |
/CheckP[ointing]{on\off} |
선택 사항입니다. 패키지 실행 중 패키지에서 검사점을 사용하는지 여부를 결정하는 값을 설정합니다. 값 on은 실패한 패키지를 다시 실행하도록 지정합니다. 실패한 패키지가 다시 실행되면 런타임 엔진에서 검사점 파일을 사용하여 실패한 지점에서 패키지를 다시 시작합니다. 값을 지정하지 않고 이 옵션을 선언할 경우 기본값은 on입니다. 값을 on으로 설정한 경우 검사점 파일을 찾을 수 없으면 패키지를 실행할 수 없습니다. 이 옵션을 지정하지 않으면 패키지에 설정된 값이 유지됩니다. 자세한 내용은 검사점을 사용하여 실패한 패키지 다시 시작을 참조하십시오. dtexec의 /CheckPointing on 옵션은 패키지의 SaveCheckpoints 속성을 True로 설정하고 CheckpointUsage 속성을 Always로 설정하는 것과 같습니다. |
/Com[mandFile]filespec |
선택 사항입니다. 유틸리티에서 명령을 읽어들이는 단계 동안 filespec에 지정된 파일을 열고 파일에서 EOF가 검색될 때까지 옵션을 읽도록 지정합니다. filespec은 추가 dtexec 명령 옵션을 포함하는 텍스트 파일입니다. filespec 인수는 패키지 실행과 연관시킬 명령 파일의 이름과 경로를 지정합니다. |
/Conf[igFile]filespec |
선택 사항입니다. 값을 추출할 구성 파일을 지정합니다. 이 옵션을 사용하면 패키지의 디자인 타임에 지정한 구성과 다르게 런타임 구성을 설정할 수 있습니다. 다른 구성 설정을 XML 구성 파일에 저장한 다음 패키지를 실행하기 전에 /ConfigFile 옵션을 사용하여 이 설정을 로드할 수 있습니다. /ConfigFile 옵션을 사용하면 디자인 타임에 지정하지 않은 추가 구성을 런타임에 로드할 수 있습니다. 그러나 디자인 타임에도 지정한 구성 값을 /ConfigFile 옵션을 사용하여 바꿀 수는 없습니다. 패키지 구성이 적용되는 방법을 이해하려면 SSIS 패키지 구성. 및 SQL Server 2008 R2 Integration Services 기능의 동작 변경 내용을 참조하십시오. |
/Conn[ection]id_or_name;connection_string [[;id_or_name;connection_string] ] |
선택 사항입니다. 이름 또는 GUID가 지정된 연결 관리자가 패키지에 있음을 지정하고 연결 문자열을 지정합니다. 이 옵션을 사용하려면 두 매개 변수 모두를 지정해야 합니다. 즉, id_or_name 인수에 연결 관리자 이름 또는 GUID를 제공하고 connection_string 인수에 올바른 연결 문자열을 지정해야 합니다. 자세한 내용은 Integration Services 연결을 참조하십시오. 런타임에 /Connection 옵션을 사용하면 디자인 타임에 지정한 위치와 다른 위치에서 패키지 구성을 로드할 수 있습니다. 그러면 원래 지정된 값이 이러한 구성 값으로 바뀝니다. 그러나 연결 관리자를 사용하는 SQL Server 구성과 같은 구성에만 /Connection 옵션을 사용할 수 있습니다. 패키지 구성이 적용되는 방법을 이해하려면 SSIS 패키지 구성. 및 SQL Server 2008 R2 Integration Services 기능의 동작 변경 내용을 참조하십시오. |
/Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...] |
선택 사항입니다. 패키지 실행 중 지정된 로그 항목을 콘솔에 표시합니다. 이 옵션을 생략하면 콘솔에 로그 항목이 표시되지 않습니다. 표시를 제한하는 매개 변수 없이 이 옵션을 지정하면 모든 로그 항목이 표시됩니다. 콘솔에 표시되는 항목을 제한하려면 displayoptions 매개 변수를 사용하여 표시할 열을 지정하고 list_options 매개 변수를 사용하여 로그 항목 유형을 제한합니다. displayoptions 값은 다음과 같습니다.
list_options 값은 다음과 같습니다.
같은 명령 프롬프트에 여러 /ConsoleLog 옵션을 사용하면 다음과 같이 작동합니다.
/ConsoleLog 옵션에 관한 여러 가지 예는 주의 섹션을 참조하십시오. |
/D[ts]package_path |
선택 사항입니다. SSIS 패키지 저장소에서 패키지를 로드합니다. package_path 인수는 SSIS 패키지 저장소의 루트에서 시작하여 SSIS 패키지의 상대 경로를 지정하고 SSIS 패키지의 이름을 포함합니다. package_path 인수에 지정된 경로나 파일 이름에 공백이 있는 경우 package_path 인수를 따옴표로 묶어야 합니다. /DTS 옵션은 /File 또는 /SQL 옵션과 함께 사용할 수 없습니다. 여러 개의 옵션을 지정하는 경우 dtexec는 실패합니다. |
/De[crypt] password |
선택 사항입니다. 암호가 암호화된 패키지를 로드할 때 사용할 해독 암호를 설정합니다. |
/Dumperror code |
선택 사항입니다. 패키지가 실행되는 동안 하나 이상의 지정된 이벤트가 발생할 때 디버그 덤프 파일(.mdmp 및 .tmp)을 만듭니다. error code 인수는 시스템에서 디버그 덤프 파일을 만들도록 트리거할 이벤트 코드 유형(오류, 경고 또는 정보)을 지정합니다. 여러 이벤트 코드를 지정하려면 각 error code 인수를 세미콜론(;)으로 구분합니다. 기본적으로 Integration Services에서는 디버그 덤프 파일을 <drive>:\Program Files\Microsoft SQL Server\100\Shared\ErrorDumps 폴더에 저장합니다. .gif "참고") 참고
디버그 덤프 파일에는 중요한 정보가 들어 있을 수 있습니다. ACL(액세스 제어 목록)을 사용하여 파일에 대한 액세스를 제한하거나 파일을 액세스가 제한된 폴더에 복사합니다. 예를 들어 디버그 파일을 Microsoft 지원 서비스에 보내기 전에 중요한 정보나 기밀 정보를 제거하는 것이 좋습니다.
dtexec 유틸리티가 실행하는 모든 패키지에 이 옵션을 적용하려면 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath 레지스트리 키에 DumpOnCodes REG_SZ 값을 추가합니다. DumpOnCodes의 데이터 값은 시스템에서 디버그 덤프 파일을 만들도록 트리거할 오류 코드를 지정합니다. 여러 오류 코드를 지정하려면 세미콜론(;)으로 구분해야 합니다. 레지스트리 키에 DumpOnCodes 값을 추가하고 /Dump 옵션을 사용하는 경우 시스템에서는 두 설정 모두를 기반으로 디버그 덤프 파일을 만듭니다. 디버그 덤프 파일에 대한 자세한 내용은 디버그 덤프 파일 작업을 참조하십시오. |
/DumpOnError |
선택 사항입니다. 패키지가 실행되는 동안 오류가 발생할 때 디버그 덤프 파일(.mdmp 및 .tmp)을 만듭니다. 기본적으로 Integration Services에서는 디버그 덤프 파일을 <drive>:\Program Files\Microsoft SQL Server\100\Shared\ErrorDumps 폴더에 저장합니다. 참고
디버그 덤프 파일에는 중요한 정보가 들어 있을 수 있습니다. ACL(액세스 제어 목록)을 사용하여 파일에 대한 액세스를 제한하거나 파일을 액세스가 제한된 폴더에 복사합니다. 예를 들어 디버그 파일을 Microsoft 지원 서비스에 보내기 전에 중요한 정보나 기밀 정보를 제거하는 것이 좋습니다.
dtexec 유틸리티가 실행하는 모든 패키지에 이 옵션을 적용하려면 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath 레지스트리 키에 DumpOnError REG_DWORD 값을 추가합니다. DumpOnError REG_DWORD 값은 dtexec 유틸리티에 /DumpOnError 옵션을 사용해야 하는지 여부를 결정합니다.
디버그 덤프 파일에 대한 자세한 내용은 디버그 덤프 파일 작업을 참조하십시오. |
/F[ile]filespec |
선택 사항입니다. 파일 시스템에 저장된 패키지를 로드합니다. filespec 인수는 패키지의 경로와 파일 이름을 지정합니다. 경로는 UNC(Universal Naming Convention) 경로나 로컬 경로로 지정할 수 있습니다. filespec 인수에 지정된 경로나 파일 이름에 공백이 있는 경우 filespec 인수를 따옴표로 묶어야 합니다. /File 옵션은 /DTS 또는 /SQL 옵션과 함께 사용할 수 없습니다. 여러 개의 옵션을 지정하는 경우 dtexec는 실패합니다. |
/H[elp] [option_name] |
선택 사항입니다. 옵션에 대한 도움말 또는 지정된 option_name에 대한 도움말을 표시하고 유틸리티를 닫습니다. option_name 인수를 지정하면 dtexec는 SQL Server 온라인 설명서를 시작하고 dtexec 유틸리티(SSIS 도구) 항목을 표시합니다. |
/L[ogger]classid_orprogid;configstring |
선택 사항입니다. SSIS 패키지 실행에 하나 이상의 로그 공급자를 연결합니다. classid_orprogid 매개 변수는 로그 공급자를 지정하며 클래스 GUID로 지정될 수 있습니다. configstring은 로그 공급자를 구성하는 데 사용되는 문자열입니다. 다음 목록에서는 사용 가능한 로그 공급자를 보여 줍니다.
|
/M[axConcurrent]concurrent_executables |
선택 사항입니다. 패키지에서 동시에 실행할 수 있는 실행 파일 수를 지정합니다. 값은 음수가 아닌 정수 또는 -1로 지정해야 합니다. -1 값은 SSIS에서 패키지를 실행하는 컴퓨터의 총 프로세서 수에 2를 더한 값과 같은 동시에 실행 가능한 최대 실행 파일 수를 허용함을 의미합니다. |
/P[assword]password |
선택 사항입니다. SQL Server 인증으로 보호되는 패키지를 검색할 수 있도록 합니다. 이 옵션은 /User 옵션과 함께 사용합니다. /Password 옵션을 생략하고 /User 옵션을 사용하면 빈 암호가 사용됩니다. password 값은 따옴표로 묶을 수 있습니다. .gif "보안 정보") 보안 정보
가능하면 Windows 인증을 사용하십시오.
|
/Remcomment |
선택 사항입니다. 명령 프롬프트 또는 명령 파일에 설명을 포함합니다. 이 인수는 선택 사항입니다. comment 값은 따옴표로 묶여 있거나 공백이 없는 문자열이어야 합니다. 인수를 지정하지 않으면 빈 줄이 삽입됩니다. comment 값은 명령을 읽어 들이는 단계를 수행하는 동안 삭제됩니다. |
/Rep[orting]level [;event_guid_or_name[;event_guid_or_name[...]] |
선택 사항입니다. 보고할 메시지의 유형을 지정합니다. level에 대해 사용할 수 있는 보고 옵션은 다음과 같습니다. N - 보고하지 않습니다. E - 오류를 보고합니다. W - 경고를 보고합니다. I - 정보 메시지를 보고합니다. C - 사용자 지정 이벤트를 보고합니다. D - 데이터 흐름 태스크 이벤트를 보고합니다. P - 진행률을 보고합니다. V - 자세한 사항을 보고합니다. V 및 N 인수는 다른 인수와 함께 사용할 수 없으므로 단독으로 지정해야 합니다. /Reporting 옵션을 지정하지 않을 경우 기본 수준은 E(오류), W(경고) 및 P(진행 상황)입니다. 모든 이벤트 앞에는 "YY/MM/DD HH:MM:SS" 형식의 타임스탬프가 있으며 GUID 또는 이름이 옵니다(사용 가능한 경우). 선택적 매개 변수 event_guid_or_name은 로그 공급자에 대한 예외 목록입니다. 예외는 정상적인 상황에서는 기록되어야 하지만 기록되지 않는 이벤트를 지정합니다. 기본적으로 기록되지 않는 경우에는 이벤트를 제외시킬 필요가 없습니다. |
/Res[tart] {deny | force | ifPossible} |
선택 사항입니다. 패키지에서 CheckpointUsage 속성의 새 값을 지정합니다. 매개 변수의 의미는 다음과 같습니다. Deny - CheckpointUsage 속성을 DTSCU_NEVER로 설정합니다. Force - CheckpointUsage 속성을 DTSCU_ALWAYS로 설정합니다. ifPossible - CheckpointUsage 속성을 DTSCU_IFEXISTS로 설정합니다. 값을 지정하지 않으면 기본값인 force가 사용됩니다. |
/SetpropertyPath;value |
선택 사항입니다. 패키지에서 변수, 속성, 컨테이너, 로그 공급자, Foreach 열거자 또는 연결의 구성을 재지정합니다. 이 옵션을 사용하면 /Set는 propertyPath 인수를 지정된 값으로 변경합니다. 여러 /Set 옵션을 지정할 수 있습니다. 패키지 구성 마법사를 실행하여 propertyPath의 값을 확인할 수 있습니다. 선택한 항목의 경로는 마지막 마법사 완료 페이지에 표시되며 복사하여 붙여 넣을 수 있습니다. 이러한 용도로만 마법사를 사용하는 경우에는 경로를 복사한 다음 마법사를 취소할 수 있습니다. 다음은 패키지를 실행하고 변수에 새 값을 제공하는 예입니다. dtexec /f mypackage.dtsx /set \package.variables[myvariable].Value;myvalue /Set 옵션을 사용하면 패키지 구성이 로드되는 위치를 변경할 수 있습니다. 그러나 디자인 타임에 구성에서 지정한 값은 /Set 옵션을 사용하여 재정의할 수 없습니다. 패키지 구성이 적용되는 방법을 이해하려면 SSIS 패키지 구성. 및 SQL Server 2008 R2 Integration Services 기능의 동작 변경 내용을 참조하십시오. |
/Ser[ver]server |
선택 사항입니다. /SQL 또는 /DTS 옵션을 지정한 경우 이 옵션은 패키지를 검색할 서버의 이름을 지정합니다. /Server 옵션을 생략하고 /SQL 또는 /DTS 옵션을 지정하면 로컬 서버에 대해 패키지가 실행됩니다. server_instance 값은 따옴표로 묶을 수 있습니다. |
/SQ[L]package_path |
SQL Server에 저장된 패키지를 로드합니다. package_path 인수는 검색할 패키지의 이름을 지정합니다. 경로에 폴더가 포함된 경우 백슬래시("\")로 끝납니다. package_path 값은 따옴표로 묶을 수 있습니다. package_path 인수에 지정된 경로나 파일 이름에 공백이 있는 경우 package_path 인수를 따옴표로 묶어야 합니다. /User, /Password 및 /Server 옵션과 /SQL 옵션을 함께 사용할 수 있습니다. /User 옵션을 생략하면 패키지에 액세스하는 데 Windows 인증이 사용됩니다. /User 옵션을 지정하면 지정된 /User 로그인 이름이 SQL Server 인증과 연결됩니다. /Password 옵션은 /User 옵션과 함께만 사용할 수 있습니다. /Password 옵션을 사용하면 제공된 사용자 이름과 암호 정보를 사용하여 패키지에 액세스합니다. /Password 옵션을 생략하면 빈 암호가 사용됩니다. 보안 정보
가능하면 Windows 인증을 사용하십시오.
/Server 옵션을 생략하면 SQL Server의 기본 로컬 인스턴스로 가정됩니다. /SQL 옵션은 /DTS 또는 /File 옵션과 함께 사용할 수 없습니다. 여러 개의 옵션을 지정하는 경우 dtexec는 실패합니다. |
/Su[m] |
선택 사항입니다. 다음 구성 요소에서 받을 행 수를 포함하는 증분 카운터를 표시합니다. |
/U[ser]user_name |
선택 사항입니다. SQL Server 인증으로 보호되는 패키지를 검색할 수 있도록 합니다. 이 옵션은 /SQL 옵션을 지정한 경우에만 사용합니다. user_name 값은 따옴표로 묶을 수 있습니다. 보안 정보
가능하면 Windows 인증을 사용하십시오.
|
/Va[lidate] |
선택 사항입니다. 유효성 검사 단계 후에 실제로 패키지를 실행하지 않고 패키지 실행을 중지합니다. /WarnAsError 옵션을 사용하면 유효성 검사 중 dtexec에서 경고를 오류로 간주하므로 유효성 검사 중 경고가 발생하면 패키지가 실패합니다. |
/VerifyB[uild]major[;minor[;build]] |
선택 사항입니다. 확인 단계 동안 major, minor 및 build 인수에 지정된 빌드 번호에 대해 패키지의 빌드 번호를 확인합니다. 일치하지 않을 경우 패키지가 실행되지 않습니다. 값은 정수(Long)입니다. 인수의 형식으로 3가지 중 하나를 사용할 수 있으며 major 값은 항상 필요합니다.
|
/VerifyP[ackageID]packageID |
선택 사항입니다. 실행할 패키지의 GUID를 package_id 인수에 지정된 값과 비교하여 확인합니다. |
/VerifyS[igned] |
선택 사항입니다. Integration Services가 패키지의 디지털 서명을 확인하도록 합니다. 패키지가 서명되지 않았거나 서명이 잘못된 경우 패키지가 실패합니다. 자세한 내용은 패키지에 디지털 서명 사용을 참조하십시오. 중요
패키지의 서명을 확인하도록 구성된 경우 Integration Services는 디지털 서명이 있는지, 유효한지, 그리고 신뢰할 수 있는 원본에서 제공된 것인지만 확인합니다. Integration Services는 패키지가 변경되었는지 여부는 확인하지 않습니다.
참고
선택적 BlockedSignatureStates 레지스트리 값은 Business Intelligence Development Studio 또는 dtexec 명령줄에서 설정한 디지털 서명 옵션보다 더 제한적인 설정을 지정합니다. 이 경우 더 제한적인 설정이 다른 설정보다 우선합니다.
|
/VerifyV[ersionID]versionID |
선택 사항입니다. 패키지 유효성 검사 단계 동안 실행할 패키지의 버전 GUID를 version_id 인수에 지정된 값과 비교하여 확인합니다. |
/VLog[Filespec] |
선택 사항입니다. 패키지를 디자인할 때 사용하도록 설정한 로그 공급자에 모든 Integration Services 패키지 이벤트를 기록합니다. Integration Services가 텍스트 파일용 로그 공급자를 사용하고 지정된 텍스트 파일에 로그 이벤트를 기록하도록 만들려면 경로 및 파일 이름을 Filespec 매개 변수로 포함합니다. Filespec 매개 변수를 포함하지 않으면 Integration Services가 텍스트 파일용 로그 공급자를 사용하지 않습니다. Integration Services는 패키지를 디자인할 때 사용하도록 설정한 로그 공급자에만 로그 이벤트를 기록합니다. |
/W[arnAsError] |
선택 사항입니다. 패키지에서 경고를 오류로 간주하도록 하므로 유효성 검사 동안 경고가 발생하면 패키지가 실패합니다. 유효성 검사 동안 경고가 발생하지 않았고 /Validate 옵션을 지정하지 않은 경우 패키지가 실행됩니다. |
/X86 |
선택 사항입니다. SQL Server 에이전트가 64비트 컴퓨터에서 32비트 모드로 패키지를 실행하도록 합니다. 이 옵션은 다음 조건이 충족되는 경우 SQL Server 에이전트에서 설정됩니다.
또한 저장 프로시저나 SMO(SQL Server Management Objects)를 사용하여 프로그래밍 방식으로 작업을 만들어 SQL Server 에이전트 작업 단계에 대해 이 옵션을 설정할 수도 있습니다. 이 옵션은 SQL Server 에이전트에서만 사용됩니다. 명령 프롬프트에서 dtexec 유틸리티를 실행하는 경우에는 이 옵션이 무시됩니다. |
주의
명령 옵션을 지정하는 순서에 따라 패키지 실행 방법이 달라질 수 있습니다.
명령줄에 나타나는 순서대로 옵션이 처리됩니다. 명령줄에 명령 파일이 있으면 명령 파일을 읽습니다. 명령 파일의 명령도 나타나는 순서대로 처리됩니다.
같은 명령줄 문에 같은 옵션, 매개 변수 또는 변수가 두 번 이상 나타나는 경우 마지막 옵션이 우선 순위를 갖습니다.
/Set 및 /ConfigFile 옵션은 나타나는 순서대로 처리됩니다.
dtexec(SSIS 도구): 예
SSIS 패키지 실행
Windows 인증을 사용하여 SQL Server에 저장된 SSIS 패키지를 실행하려면 다음 코드를 사용합니다.
dtexec /sq pkgOne /ser productionServer
SSIS 패키지 저장소의 파일 시스템 폴더에 저장된 SSIS 패키지를 실행하려면 다음 코드를 사용합니다.
dtexec /dts "\File System\MyPackage"
Windows 인증을 사용하며 SQL Server에 저장된 패키지를 실행하지 않고 유효성을 검사하려면 다음 코드를 사용합니다.
dtexec /sq pkgOne /ser productionServer /va
파일 시스템에 저장된 SSIS 패키지를 실행하려면 다음 코드를 사용합니다.
dtexec /f "c:\pkgOne.dtsx"
파일 시스템에 저장된 SSIS 패키지를 실행하고 로깅 옵션을 지정하려면 다음 코드를 사용합니다.
dtexec /f "c:\pkgOne.dtsx" /l "DTS.LogProviderTextFile;c:\log.txt"
Windows 인증을 사용하며 SQL Server의 기본 로컬 인스턴스에 저장된 패키지를 실행하려면 실행하기 전에 버전을 확인하고 다음 코드를 사용합니다.
dtexec /sq pkgOne /verifyv {c200e360-38c5-11c5-11ce-ae62-08002b2b79ef}
파일 시스템에 저장되고 외부적으로 구성된 SSIS 패키지를 실행하려면 다음 코드를 사용합니다.
dtexec /f "c:\pkgOne.dtsx" /conf "c:\pkgOneConfig.cfg"
[!참고]
경로나 파일 이름에 공백이 있는 경우 /SQL, /DTS 또는 /FILE 옵션의 package_path 또는 filespec 인수를 따옴표로 묶어야 합니다. 인수를 따옴표로 묶지 않으면 인수에 공백을 사용할 수 없습니다.
로깅 옵션
A, B, C라는 3개의 로그 항목 유형이 있는 경우 매개 변수가 없는 다음 ConsoleLog 옵션은 모든 필드와 함께 3개의 로그 유형을 모두 표시합니다.
/CONSOLELOG
다음 옵션은 모든 로그 유형을 표시하지만 이름 및 메시지 열만 표시합니다.
/CONSOLELOG NM
다음 옵션은 모든 열을 표시하지만 로그 항목 유형 A에 대해서만 표시합니다.
/CONSOLELOG I;LogEntryTypeA
다음 옵션은 이름 및 메시지 열과 함께 로그 항목 유형 A만 표시합니다.
/CONSOLELOG NM;I;LogEntryTypeA
다음 옵션은 로그 항목 유형 A와 B에 대한 로그 항목을 표시합니다.
/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB
여러 ConsoleLog 옵션을 사용하여 같은 결과를 얻을 수 있습니다.
/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB
ConsoleLog 옵션을 매개 변수 없이 사용하면 모든 필드가 표시됩니다. list_options 매개 변수를 포함시키면 다음은 모든 필드와 함께 로그 항목 유형 A만 표시합니다.
/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG
다음은 로그 항목 유형 A를 제외한 모든 로그 항목을 표시합니다. 즉, 로그 항목 유형 B 및 C를 표시합니다.
/CONSOLELOG E;LogEntryTypeA
다음 예에서는 여러 ConsoleLog 옵션을 사용하고 하나를 제외하여 같은 결과를 얻습니다.
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG E;LogEntryTypeA
/CONSOLELOG E;LogEntryTypeA;LogEntryTypeA
로그 파일 종류가 포함 목록과 제외 목록 모두에 있는 경우 제외되므로 다음 예에서는 로그 메시지를 표시하지 않습니다.
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA
SET 옵션
다음은 명령줄에서 패키지를 시작하는 경우 모든 패키지의 속성 또는 변수 값을 변경할 수 있는 /SET 옵션을 사용하는 방법을 보여 줍니다.
/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue
|
.gif "Integration Services 아이콘(작은 아이콘)")
Integration Services 관련 최신 정보 얻기