시스템 변수
업데이트: 2007년 9월 15일
SQL Server 2005 Integration Services(SSIS)에는 런타임 패키지 및 해당 개체에 대한 정보가 저장되는 일련의 시스템 변수가 제공됩니다. 이러한 변수를 식 및 속성 식에서 사용하여 패키지, 컨테이너, 작업 및 이벤트 처리기를 사용자 지정할 수 있습니다.
SQL 실행 작업에서 변수를 매개 변수에 매핑하는 데 사용되는 매개 변수 바인딩에는 시스템 변수와 사용자 정의 변수를 포함한 모든 변수를 사용할 수 있습니다.
패키지의 시스템 변수
다음 표에서는 Integration Services에서 패키지에 대해 제공하는 시스템 변수에 대해 설명합니다.
| 시스템 변수 | 데이터 형식 | 설명 |
|---|---|---|
CancelEvent |
Int32 |
작업에서 실행 중지 요청 신호를 전달할 수 있는 Windows 이벤트 개체 핸들입니다. |
CreationDate |
DateTime |
패키지를 만든 날짜입니다. |
CreatorComputerName |
String |
패키지를 만든 컴퓨터입니다. |
CreatorName |
String |
패키지를 만든 사용자의 이름입니다. |
ExecutionInstanceGUID |
String |
실행 중인 패키지의 고유 식별자입니다. |
InteractiveMode |
Boolean |
패키지가 대화형 모드에서 실행 중인지 여부를 나타냅니다. SSIS 디자이너에서 패키지를 실행 중인 경우 이 속성은 True로 설정됩니다. DTExec 명령 프롬프트 유틸리티를 사용하여 패키지를 실행 중인 경우 이 속성은 False로 설정됩니다. |
LocaleId |
Int32 |
패키지에서 사용되는 로캘입니다. |
MachineName |
String |
패키지가 실행 중인 컴퓨터 이름입니다. |
OfflineMode |
Boolean |
패키지가 오프라인 모드인지 여부를 나타냅니다. 오프라인 모드에서는 데이터 원본에 연결하지 않습니다. |
PackageID |
String |
패키지의 고유 식별자입니다. |
PackageName |
String |
패키지의 이름입니다. |
StartTime |
DateTime |
패키지 실행을 시작한 시간입니다. |
UserName |
String |
패키지를 시작한 사용자의 계정입니다. 사용자 이름은 도메인 이름에 의해 한정됩니다. |
VersionBuild |
Int32 |
패키지 버전입니다. |
VersionComment |
String |
패키지 버전에 대한 설명입니다. |
VersionGUID |
String |
버전의 고유 식별자입니다. |
VersionMajor |
Int32 |
패키지의 주 버전입니다. |
VersionMinor |
Int32 |
패키지의 부 버전입니다. |
컨테이너의 시스템 변수
다음 표에서는 For 루프, Foreach 루프 및 시퀀스 컨테이너에 대해 Integration Services에서 제공하는 시스템 변수에 대해 설명합니다.
| 시스템 변수 | 데이터 형식 | 설명 | 컨테이너 |
|---|---|---|---|
LocaleId |
Int32 |
컨테이너에서 사용되는 로캘입니다. |
For 루프 컨테이너 Foreach 루프 컨테이너 시퀀스 컨테이너 |
작업의 시스템 변수
다음 표에서는 Integration Services에서 작업에 대해 제공하는 시스템 변수에 대해 설명합니다.
| 시스템 변수 | 데이터 형식 | 설명 |
|---|---|---|
CreationName |
String |
작업 이름입니다. |
LocaleId |
Int32 |
작업에서 사용되는 로캘입니다. |
TaskID |
String |
작업의 고유 식별자입니다. |
TaskName |
String |
작업의 이름입니다. |
TaskTransactionOption |
Int32 |
작업에서 사용되는 트랜잭션 옵션입니다. |
이벤트 처리기의 시스템 변수
다음 표에서는 Integration Services에서 이벤트 처리기에 대해 제공하는 시스템 변수에 대해 설명합니다. 일부 변수는 특정 이벤트 처리기에서만 사용할 수 있습니다.
시스템 변수
데이터 형식
설명
이벤트 처리기
Cancel
Boolean
오류, 경고 또는 쿼리 취소가 발생할 때 이벤트 처리기 실행이 중지되는지 여부를 나타냅니다.
OnError 이벤트 처리기
OnWarning 이벤트 처리기
OnQueryCancel 이벤트 처리기
ErrorCode
Int32
오류 식별자입니다.
OnError 이벤트 처리기
OnInformation 이벤트 처리기
OnWarning 이벤트 처리기
ErrorDescription
String
오류에 대한 설명입니다.
OnError 이벤트 처리기
OnInformation 이벤트 처리기
OnWarning 이벤트 처리기
ExecutionStatus
Boolean
현재 실행 상태입니다.
OnExecStatusChanged 이벤트 처리기
ExecutionValue
DBNull
실행 값입니다.
OnTaskFailed 이벤트 처리기
LocaleId
Int32
이벤트 처리기에서 사용되는 로캘입니다.
모든 이벤트 처리기
PercentComplete
Int32
완료된 작업의 백분율입니다.
OnProgress 이벤트 처리기
ProgressCountHigh
Int32
OnProgress 이벤트에 의해 처리된 전체 작업 개수를 나타내는 64비트 값의 상위 부분입니다.
OnProgress 이벤트 처리기
ProgressCountLow
Int32
OnProgress 이벤트에 의해 처리된 전체 작업 개수를 나타내는 64비트 값의 하위 부분입니다.
OnProgress 이벤트 처리기
ProgressDescription
String
진행률에 대한 설명입니다.
OnProgress 이벤트 처리기
Propagate
Boolean
이벤트가 상위 수준의 이벤트 처리기로 전달되는지 여부를 나타냅니다.
.gif "ms141788.note(ko-kr,SQL.90).gif")
참고:
패키지 유효성 검사 중에는 Propagate 변수 값이 무시됩니다. 자식 패키지에서 Propagate를 False로 설정한 경우에는 이벤트가 부모 패키지로 전달됩니다. 부모 패키지가 이벤트를 처리하지 않도록 하려면 패키지 실행 작업의 DisableEventHandlers 속성을 True로 설정합니다.
모든 이벤트 처리기
SourceDescription
String
이벤트 처리기에서 이벤트를 발생시킨 실행 개체에 대한 설명입니다.
모든 이벤트 처리기
SourceID
String
이벤트 처리기에서 이벤트를 발생시킨 실행 개체의 고유 식별자입니다.
모든 이벤트 처리기
SourceName
String
이벤트 처리기에서 이벤트를 발생시킨 실행 개체의 이름입니다.
모든 이벤트 처리기
VariableDescription
String
변수 설명입니다.
OnVariableValueChanged 이벤트 처리기
VariableID
String
변수의 고유 식별자입니다.
OnVariableValueChanged 이벤트 처리기
매개 변수 바인딩에 시스템 변수 사용
패키지 실행 시 테이블의 시스템 변수 값을 저장하면 유용합니다. 예를 들어 테이블을 동적으로 만들고 이 테이블을 만든 패키지 실행 인스턴스의 GUID를 테이블 열에 쓰는 패키지가 있을 수 있습니다.
시스템 변수를 사용하여 SQL 실행 작업에서 사용되는 SQL 문의 매개 변수에 매핑하는 경우 각 매개 변수 바인딩의 데이터 형식을 시스템 변수의 데이터 형식으로 설정해야 합니다. 그렇게 하지 않으면 시스템 변수 값이 올바르게 번역되지 않을 수 있습니다. 예를 들어 패키지의 실행 인스턴스에 대한 GUID를 나타내는 문자열을 포함하는 문자열 데이터 형식의 ExecutionInstanceGUID 시스템 변수를 GUID 데이터 형식의 매개 변수 바인딩에 사용하면 패키지 인스턴스의 GUID가 올바르게 번역되지 않습니다.
이 규칙은 사용자 정의 변수에도 적용됩니다. 그러나 시스템 변수 데이터 형식의 경우 변경할 수 없으므로 데이터 형식에 맞게 적절하게 사용해야 하는 반면 사용자 정의 데이터 형식은 보다 융통성이 높습니다. 매개 변수 바인딩에 사용되는 사용자 정의 변수는 일반적으로 매핑되는 매개 변수의 데이터 형식과 호환 가능한 데이터 형식으로 정의됩니다.
참고 항목
개념
Integration Services 패키지
Integration Services 컨테이너
Integration Services 작업
Integration Services 이벤트 처리기
Integration Services 변수
도움말 및 정보
변경 내역
| 릴리스 | 내역 |
|---|---|
2007년 9월 15일 |
|
2005년 12월 5일 |
|