패키지 실행 유틸리티(dtexecui)

적용 대상: SQL Server Azure Data Factory의 SSIS Integration Runtime

패키지 실행 유틸리티를 사용하여 패키지를 실행할 수 있습니다. 이 유틸리티는 Microsoft SQL Server 데이터베이스, SSIS 패키지 저장소 및 파일 시스템의 세 위치 중 하나에 저장된 패키지를 실행합니다. 이 사용자 인터페이스는 SQL Server Management Studio에서 열거나 명령 프롬프트에서 dtexecui 를 입력하여 열 수 있으며 DTExec 명령 프롬프트 도구를 사용하여 패키지를 실행하는 방법 대신 사용할 수 있습니다.

패키지는 dtexecui.exe 유틸리티와 동일한 프로세스에서 실행됩니다. 이 유틸리티는 32비트 도구이므로 패키지는 WOW(Windows on Win32)에서 실행되는 64비트 환경에서 dtexecui.exe 사용하여 실행됩니다. 64비트 컴퓨터에서 dtexecui.exe 유틸리티를 사용하여 명령을 개발하고 테스트하는 경우 프로덕션 서버에서 명령을 배포하거나 예약하기 전에 64비트 버전의 dtexec.exe 사용하여 64비트 모드로 명령을 테스트해야 합니다.

패키지 실행 유틸리티는 DTExec 명령 프롬프트 도구에 대한 그래픽 사용자 인터페이스입니다. 사용자 인터페이스를 사용하면 옵션을 쉽게 구성할 수 있으며 지정된 옵션에서 패키지를 실행할 때 DTExec 명령 프롬프트 도구에 전달되는 명령줄을 자동으로 어셈블합니다.

패키지 실행 유틸리티를 사용하여 DTExec를 직접 실행할 때 사용하는 명령줄을 어셈블할 수도 있습니다.

SQL Server Management Studio에서 패키지 실행 유틸리티를 열려면

1. SQL Server Management Studio의 보기 메뉴에서 개체 탐색기를 클릭합니다.

2. 개체 탐색기에서 연결을 클릭한 후 Integration Services를 클릭합니다.

3. 서버에 연결 대화 상자의 서버 이름 목록에서 (로컬)을 선택한 후 연결을 클릭합니다.

4. 저장된 패키지의 폴더 및 하위 폴더를 확장하고 실행할 패키지를 마우스 오른쪽 단추로 클릭한 다음 패키지 실행을 클릭합니다.

명령 프롬프트에서 패키지 실행 유틸리티를 열려면

• 명령 프롬프트 창에서 dtexecui를 실행합니다.

다음 섹션에서는 패키지 실행 유틸리티 대화 상자의 페이지에 대해 설명합니다.

일반 페이지

패키지 실행 유틸리티 대화 상자의 일반 페이지를 사용하여 패키지 이름과 위치를 지정할 수 있습니다.

패키지 실행 유틸리티(dtexecui.exe)는 패키지가 원격 서버에 저장되어 있어도 항상 로컬 컴퓨터에서 패키지를 실행합니다. 원격 패키지가 원격 서버에 저장된 구성 파일을 사용하는 경우 패키지 실행 유틸리티가 구성을 찾지 못하고 패키지가 실패할 수 있습니다. 이 문제를 방지하려면 \\myserver\myfile과 같은 UNC(범용 명명 규칙) 공유 이름을 사용하여 구성을 참조해야 합니다.

정적 옵션

패키지 원본
다음 옵션을 사용하여 실행할 패키지의 위치를 지정합니다.

값	설명
SQL Server	패키지가 Microsoft SQL Server에 있으면 이 옵션을 선택합니다 SQL Server 인스턴스를 지정하고 SQL Server 인증에 대한 사용자 이름과 암호를 제공합니다. 사용자 이름과 암호를 입력할 때마다 명령 프롬프트에 /USER username 및 /PASSWORD password 옵션이 추가됩니다.
파일 시스템	패키지가 파일 시스템 에 있으면 이 옵션을 선택합니다.
SSIS 패키지 저장소	패키지가 SSIS 패키지 저장소에 있으면 이 옵션을 선택합니다.

이러한 각 선택 항목에는 다음과 같은 옵션 집합이 있습니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

동적 옵션

패키지 원본 = SQL Server

서버
패키지가 있는 서버의 이름을 입력하거나 목록에서 서버를 선택합니다.

서버에 로그온
패키지가 SQL Server에 연결할 때 Windows 인증을 사용할지, 아니면 SQL Server 인증을 사용할지 지정합니다. 보안을 강화하려면 Windows 인증을 사용하는 것이 좋습니다. Windows 인증을 사용하면 사용자 이름과 암호를 지정할 필요가 없습니다.

Windows 인증 사용
Windows 인증을 사용하고 Microsoft Windows 사용자 계정을 사용하여 로그온하려면 이 옵션을 선택합니다.

SQL Server 인증 사용
SQL Server 인증을 사용하려면 이 옵션을 선택합니다. 사용자가 지정한 로그인 이름과 암호를 사용하여 트러스트되지 않은 연결로부터 연결하면 SQL Server 로그인 계정이 설정되고 지정한 암호가 전에 기록한 암호와 일치하는지를 확인하여 SQL Server가 자체적으로 인증을 수행합니다. SQL Server에서 로그인 계정을 찾을 수 없으면 인증이 실패하고 오류 메시지가 나타납니다.

Important

가능하면 Windows 인증을 사용하세요.

Package(패키지)
패키지 이름을 입력하거나 줄임표 단추 (...) 를 클릭하여 SSIS 패키지 선택 대화 상자에서 패키지를 찾습니다.

패키지 원본 = 파일 시스템

Package(패키지)
패키지 이름을 입력하거나 줄임표 단추 (...) 를 클릭하여 열기 대화 상자에서 패키지를 찾습니다. 기본적으로 이 대화 상자에서는 확장명이 .dtsx인 파일만 나열합니다.

패키지 원본 = SSIS 패키지 저장소

서버
패키지가 있는 컴퓨터의 이름을 입력하거나 목록에서 컴퓨터를 선택합니다.

서버에 로그온
패키지에서 Microsoft Windows 인증을 사용하여 패키지 원본에 연결할지를 지정합니다. 보안을 강화하려면 Windows 인증을 사용하는 것이 좋습니다. Windows 인증을 사용하면 사용자 이름과 암호를 지정할 필요가 없습니다.

Windows 인증 사용
Windows 인증을 사용하고 Microsoft Windows 사용자 계정을 사용하여 로그온하려면 이 옵션을 선택합니다.

SQL Server 인증 사용
이 옵션은 SSIS 패키지 저장소에 저장된 패키지를 실행할 때 사용할 수 없습니다.

Package(패키지)
패키지 이름을 입력하거나 줄임표 단추 (...) 를 클릭하여 SSIS 패키지 선택 대화 상자에서 패키지를 찾습니다.

구성 페이지

패키지 실행 유틸리티 대화 상자의 구성 페이지를 사용하여 런타임에 로드할 구성 파일을 선택하고 로드 순서를 지정할 수 있습니다.

옵션

구성 파일
패키지가 사용하는 구성을 나열합니다. 각 구성 파일은 명령 프롬프트에 /CONFIGFILE 파일 이름 옵션을 추가합니다.

화살표 키
목록에서 구성 파일을 선택한 다음 오른쪽에 있는 화살표 키를 사용하여 로드 순서를 변경합니다. 구성은 목록의 맨 위에서 시작하여 차례로 로드합니다.

참고 항목

여러 구성에서 동일한 속성을 수정하는 경우 마지막으로 로드되는 구성이 사용됩니다.

추가
열기 대화 상자를 사용하여 구성을 추가하려면 클릭합니다. 기본적으로 이 대화 상자에서는 확장명이 .dtsconfig인 파일만 나열합니다.

제거
목록의 구성 파일을 선택한 다음 제거를 클릭합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

명령 파일 페이지

패키지 실행 유틸리티 대화 상자의 명령 파일 페이지를 사용하여 런타임에 로드할 명령 파일을 선택할 수 있습니다.

옵션

명령 파일
패키지가 사용하는 명령 파일을 나열합니다. 패키지는 여러 파일을 사용하여 명령줄 옵션을 설정할 수 있습니다.

화살표 키
목록에서 명령 파일을 선택한 다음 오른쪽에 있는 화살표 키를 사용하여 로드 순서를 변경합니다. 명령 파일은 목록의 맨 위에서 시작하여 차례로 로드합니다.

추가
열기 대화 상자를 사용하여 명령 파일을 추가하려면 클릭합니다.

제거
입력란에서 명령 파일을 선택한 다음 제거 단추를 사용하여 선택한 명령 파일을 제거합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

연결 관리자 페이지

패키지 실행 유틸리티 대화 상자의 연결 관리자 페이지를 사용하여 패키지에서 사용하는 연결 관리자의 연결 문자열 편집합니다.

옵션

연결 관리자
연결 문자열 열을 편집할 수 있도록 확인란을 선택합니다.

설명
각 연결 관리자에 대한 설명을 봅니다. 설명을 편집할 수 없습니다.

연결 문자열
연결 관리자에 대한 연결 문자열 편집합니다. 이 필드는 연결 관리자 확인란을 선택한 경우에만 편집할 수 있습니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

실행 옵션 페이지

패키지 실행 유틸리티 대화 상자의 실행 옵션 페이지를 사용하여 패키지에 대한 런타임 옵션을 지정할 수 있습니다.

옵션

유효성 검사 경고 발생 시 패키지 실패
유효성 검사 경고가 발생할 경우 패키지가 실패하는지 여부를 나타냅니다.

패키지를 실행하지 않고 유효성 검사
패키지의 유효성만 검사되는지 여부를 나타냅니다.

최대 동시 실행 파일 수
패키지에서 동시에 실행할 수 있는 최대 실행 파일 수를 지정할지 여부를 나타냅니다. 이 확인란을 선택한 후 스핀 상자를 사용하여 최대 실행 파일 수를 지정합니다.

패키지 검사점 사용
패키지 검사점을 사용할지 여부를 나타냅니다.

검사점 파일
패키지 검사점을 사용하는 경우 패키지가 사용하는 검사점 파일을 나열합니다.

찾아보기
패키지 검사점을 활성화한 경우, 찾아보기 단추 (...)을 클릭하여 열기 대화 상자를 사용해 검사점 파일을 찾으세요. 검사점 파일이 이미 지정된 경우 선택한 파일로 대체됩니다.

다시 시작 옵션 무시
패키지 검사점을 사용하도록 설정하는 경우 다시 시작 옵션을 재정의할지 여부를 나타냅니다.

다시 시작 옵션
다시 시작 옵션을 무시하는 경우 검사점 사용 방법을 선택합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

보고 페이지

패키지 실행 유틸리티 대화 상자의 보고 페이지를 사용하여 패키지가 실행되면 콘솔에 로그온할 패키지에 대한 이벤트 및 정보를 지정할 수 있습니다.

옵션

콘솔 이벤트
보고할 이벤트와 메시지 유형을 나타냅니다.

없음
보고하지 않으려면 선택합니다.

Errors
오류 메시지를 보고하려면 선택합니다.

경고
경고 메시지를 보고하려면 선택합니다.

사용자 지정 이벤트
사용자 지정 이벤트 메시지를 보고하려면 선택합니다.

이벤트 파이프라인
데이터 흐름 이벤트 메시지를 보고하려면 선택합니다.

정보
정보 메시지를 보고하려면 선택합니다.

자세한 정보 표시
자세한 정보를 보고하려면 선택합니다.

콘솔 로깅
선택한 이벤트가 발생할 때 로그에 쓸 정보를 지정합니다.

이름
패키지를 만든 사용자 이름을 보고하려면 선택합니다.

컴퓨터
패키지를 실행 중인 컴퓨터의 이름을 보고하려면 선택합니다.

Operator
패키지를 시작한 사용자 이름을 보고하려면 선택합니다.

원본 이름
패키지 이름을 보고하려면 선택합니다.

원본 GUID
패키지 GUID를 보고하려면 선택합니다.

실행 GUID
패키지 실행 인스턴스의 GUID를 보고하려면 선택합니다.

Message
메시지를 보고하려면 선택합니다.

시작 시간 및 종료 시간
패키지가 시작되고 완료되면 보고하려면 선택합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

로깅 페이지

패키지 실행 유틸리티 대화 상자의 로깅 페이지를 사용하여 런타임에 패키지에 로그 공급자를 사용할 수 있도록 합니다. 패키지 로그 공급자 유형 및 로그에 연결하기 위한 연결 문자열 제공합니다. 각 로그 공급자 항목은 명령 프롬프트에 /LOGGERclassid 옵션을 추가합니다.

옵션

로그 공급자
목록에서 로그 공급자를 선택합니다.

구성 문자열
로그 위치를 가리키는 패키지에서 연결 관리자의 이름을 선택하거나 로그 공급자에 연결하기 위한 연결 문자열 입력합니다.

제거
로그 공급자를 선택하여 제거하려면 클릭합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

값 설정 페이지

패키지 실행 유틸리티 대화 상자의 값 설정 페이지에서 속성의 경로 및 해당 속성 값을 입력하여 패키지, 실행 파일, 연결, 변수 및 로그 공급자의 속성 값을 설정할 수 있습니다. 경로를 입력할 때마다 명령 프롬프트에 /SETpropertypath;value 옵션이 추가됩니다.

옵션

속성 경로
속성의 경로를 입력합니다. 경로 구문은 백슬래시(\)를 사용하여 다음 항목이 컨테이너이고, 마침표(.)가 속성임을 나타내고, 컬렉션 멤버를 나타내는 대괄호를 나타냅니다. 멤버는 인덱스 또는 해당 이름으로 식별할 수 있습니다. 예를 들어 패키지 변수의 속성 경로는 \Package.Variables[MyVariable].Value입니다.

값
속성 값을 입력합니다.

제거
속성 경로를 선택하고 클릭하여 제거합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

확인 페이지

패키지 실행 대화 상자의 확인 페이지를 사용하여 패키지 확인 조건을 설정할 수 있습니다.

옵션

서명된 패키지만 실행
서명된 패키지만 실행하려면 선택합니다.

패키지 빌드 확인
패키지 빌드를 확인하려면 선택합니다.

빌드
빌드와 연결된 순차 빌드 번호를 지정합니다.

패키지 ID 확인
패키지 ID를 확인하려면 선택합니다.

패키지 ID
패키지 ID 번호를 지정합니다.

버전 ID 확인
버전 ID를 확인하려면 선택합니다.

버전 ID
버전 ID 번호를 지정합니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

명령줄 페이지

패키지 실행 유틸리티 대화 상자의 명령줄 노드를 사용하여 다양한 대화 상자에서 만든 옵션에 의해 생성된 명령줄을 편집합니다.

옵션

원래 옵션 복원
명령줄을 원래 상태로 복원하려면 클릭합니다. 명령줄 수동 수정 옵션을 사용하여 수정한 후 원래 명령줄 옵션을 복원하려는 경우 이 옵션을 사용합니다.

수동으로 명령줄 편집
명령줄 텍스트 상자에서 명령줄을 편집하려면 클릭합니다.

명령줄
현재 명령줄을 표시합니다. 명령줄을 수동으로 편집하는 옵션을 선택한 경우 편집할 수 있습니다.

Execute
패키지를 실행하려면 클릭합니다.

닫기
클릭하여 패키지 실행 유틸리티 대화 상자를 닫습니다.

참고 항목

dtexec 유틸리티