다음을 통해 공유

패키지 속성 설정

  • 아티클

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

Integration Services에서 제공하는 그래픽 인터페이스를 사용하여 SQL Server Data Tools (SSDT)에서 패키지를 만들 때 속성 창 패키지 개체의 속성을 설정합니다.

속성 창은 속성의 범주화된 검색 및 사전 순 목록을 제공합니다. 범주별로 속성 창을 정렬하려면, 범주화된 검색 아이콘을 클릭합니다.

범주별로 정렬된 경우 속성 창은 다음 범주의 속성을 그룹화합니다.

속성 창에서 설정할 수 없는 추가 패키지 속성에 대한 내용은 Package를 참조하세요.

속성 창에서 패키지 속성을 설정하려면

범주별 속성

다음 표는 범주별 패키지 속성을 나열합니다.

검사점

이 항목의 속성을 사용하면 제어 흐름 시작부터 패키지를 다시 실행하는 대신 패키지 제어 흐름의 오류 발생 시점으로부터 패키지를 다시 시작할 수 있습니다. 자세한 내용은 검사점을 사용하여 패키지 다시 시작을 참조하세요.

속성 설명
CheckpointFileName 패키지를 다시 시작할 수 있도록 하는 검사점 정보를 캡처하는 파일의 이름 패키지가 성공적으로 완료되면 이 파일은 삭제됩니다.
CheckpointUsage 패키지를 다시 시작할 수 있는 시기를 나타냅니다. 가능한 값은 Never, IfExists및 Always입니다. 이 속성의 기본값은 Never이며 이 경우 패키지를 다시 시작할 수 없습니다. 자세한 내용은 DTSCheckpointUsage를 참조하세요.
SaveCheckpoints 패키지가 실행되면 검사점이 검사점 파일에 기록되는지 여부를 나타냅니다. 이 속성의 기본값은 False입니다.

참고 항목

dtexec의 /CheckPointing on 옵션은 패키지의 SaveCheckpoints 속성을 True로 설정하고 CheckpointUsage 속성을 Always로 설정하는 것과 같습니다. 자세한 내용은 dtexec Utility를 참조하세요.

실행

이 범주의 속성은 패키지 개체의 런타임 동작을 구성합니다.

속성 설명
DelayValidation 패키지가 실행될 때까지 패키지 유효성 검사가 지연되는지 여부를 나타냅니다. 이 속성의 기본값은 False입니다.
사용 안 함 패키지가 비활성화되는지 여부를 나타냅니다. 이 속성의 기본값은 False입니다.
DisableEventHandlers 패키지 이벤트 처리기가 실행되는지 여부를 나타냅니다. 이 속성의 기본값은 False입니다.
FailPackageOnFailure 패키지 구성 요소에서 오류가 발생하는 경우 패키지가 실패하는지 여부를 나타냅니다. 이 속성의 유효한 값은 False가 유일합니다.
FailParentOnError 자식 컨테이너에서 오류가 발생하는 경우 부모 컨테이너가 실패하는지 여부를 나타냅니다. 이 속성의 기본값은 False입니다.
MaxConcurrentExecutables 패키지가 동시에 실행할 수 있는 실행 파일 수를 지정합니다. 이 속성의 기본값은 -1이고, 제한이 없음을 나타냅니다.
MaximumErrorCount 패키지 실행이 중지될 때까지 발생할 수 있는 최대 오류 수입니다. 이 속성의 기본값은 1입니다.
PackagePriorityClass 패키지 스레드의 Win32 스레드 우선순위 클래스 가능한 값은 Default, AboveNormal, Normal, BelowNormal및 Idle입니다. 이 속성의 기본값은 Default입니다. 자세한 내용은 DTSPriorityClass를 참조하세요.

강제 실행 값

이 범주의 속성은 패키지에 대한 선택적 실행 값을 구성합니다.

속성 설명
ForcedExecutionValue ForceExecutionValue이 트루로 설정되었을 경우, 패키지가 반환하는 선택적 실행 값을 나타내는 값입니다. 이 속성의 기본값은 0입니다.
ForcedExecutionValueType ForcedExecutionValue의 데이터 형식 이 속성의 기본값은 Int32입니다.
ForceExecutionValue 컨테이너의 선택적 실행 값에 특정 값을 강제로 포함해야 하는지 여부를 나타내는 부울 값입니다. 이 속성의 기본값은 False입니다.

ID

이 범주의 속성은 패키지의 고유 식별자 및 이름과 같은 정보를 제공합니다.

속성 설명
CreationDate 패키지를 만든 날짜입니다.
CreatorComputerName 패키지가 만들어진 컴퓨터의 이름입니다.
CreatorName 패키지를 만든 사람의 이름
설명 패키지 기능에 대한 설명
ID 패키지를 만들 때 할당되는 패키지 GUID입니다. 이 속성은 읽기 전용입니다. ID 속성의 새 임의 값을 생성하려면 드롭다운 목록에서 <새 ID 생성>을 선택합니다.
이름 패키지 이름
PackageType 패키지 유형 가능한 값은 Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaint및 SQLReplication입니다. 이 속성의 기본값은 Default입니다. 자세한 내용은 DTSPackageType를 참조하세요.

기타

이 범주의 속성은 패키지에서 사용하는 구성에 액세스하고 패키지의 로캘 및 로깅 모드에 대한 내용을 제공하는 데 사용됩니다. 자세한 내용은 패키지에서 속성 식 사용을 참조하세요.

속성 설명
구성 패키지가 사용하는 구성의 컬렉션 찾아보기 단추 (...) 를 클릭하여 패키지 구성을 구성합니다.
식 찾아보기 단추 (...) 를 클릭하여 패키지 속성에 대한 식을 만듭니다.

속성 창 나열된 속성뿐만 아니라 개체 모델에 포함된 모든 패키지 속성에 대한 속성 식을 만들 수 있습니다.

자세한 내용은 패키지에서 속성 식 사용을 참조하세요.

기존 속성 식을 보려면 식을 확장합니다. 식 텍스트 상자에서 찾아보기 단추 (...) 를 클릭하여 식을 수정하고 평가할 수 있습니다.
ForceExecutionResult 패키지의 실행 결과 가능한 값은 None, Success, Failure및 Completion입니다. 이 속성의 기본값은 None입니다. 자세한 내용은 T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult를 참조하세요.
LocaleId Microsoft Win32 로캘 이 속성의 기본값은 로컬 컴퓨터에서 운영 체제의 로캘입니다.
LoggingMode 패키지의 로깅 동작을 나타내는 값 가능한 값은 Disabled, Enabled및 UseParentSetting입니다. 이 속성의 기본값은 UseParentSetting입니다. 자세한 내용은 DTSLoggingMode를 참조하세요.
OfflineMode 패키지가 오프라인 모드인지 여부를 나타냅니다. 이 속성은 읽기 전용입니다. 이 속성은 프로젝트 수준에서 설정됩니다. 일반적으로 SSIS 디자이너는 패키지에서 사용하는 각 데이터 원본에 연결하여 원본 및 대상과 연결된 메타데이터를 확인합니다. 패키지를 열기 전에 SSIS 메뉴에서 오프라인으로 작업을 사용하도록 설정하여 데이터 원본을 사용할 수 없는 경우 이러한 연결 시도 및 결과 유효성 검사 오류를 방지할 수 있습니다. 또한 오프라인으로 작업 을 설정하여 디자이너에서의 작업 속도를 높이고, 패키지의 유효성을 검사하려는 경우에만 이 옵션을 해제할 수도 있습니다.
SuppressConfigurationWarnings 구성에 의해 생성된 경고가 표시되지 않는지 여부를 나타냅니다. 이 속성의 기본값은 False입니다.
UpdateObjects 새로운 버전을 사용할 수 있는 경우 패키지에 포함된 새로운 버전의 개체를 사용하도록 패키지가 업데이트되는지 여부를 나타냅니다. 예를 들어 이 속성을 트루로 설정하면 Bulk Insert 작업이 포함된 패키지가 Integration Services에서 제공하는 최신 버전의 대량 삽입 작업을 사용하도록 업데이트됩니다. 이 속성의 기본값은 False입니다.

보안

이 범주의 속성은 패키지의 보호 수준을 설정하는 데 사용됩니다. 자세한 내용은 Access Control for Sensitive Data in Packages을 참조하세요.

속성 설명
PackagePassword 암호가 필요한 패키지 보호 수준(EncryptSensitiveWithPassword 및 EncryptAllWithPassword)의 암호
ProtectionLevel 패키지에 대한 보호 수준 가능한 값은 DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassword 및 ServerStorage입니다. 이 속성의 기본값은 EncryptSensitiveWithUserKey입니다. 자세한 내용은 DTSProtectionLevel를 참조하세요.

트랜잭션

이 범주의 속성은 패키지의 격리 수준 및 트랜잭션 옵션을 구성합니다. 자세한 내용은 Integration Services 트랜잭션을 참조하세요.

속성 설명
IsolationLevel 패키지 트랜잭션의 격리 수준 가능한 값은 Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable및 Snapshot입니다. 이 속성의 기본값은 Serializable입니다.

참고: IsolationLevel 속성의 Snapshot 값은 패키지 트랜잭션에 사용할 수 없습니다. 따라서 IsolationLevel 속성을 사용하여 패키지 트랜잭션의 격리 수준을 스냅샷으로 설정할 수 없습니다. 대신 SQL 쿼리를 사용하여 패키지 트랜잭션을 스냅샷으로 설정합니다. 자세한 내용은 SET TRANSACTION ISOLATION LEVEL(Transact-SQL)을 참조하세요.

IsolationLevel 속성 값을 TransactionOption 로 설정한 경우에만 Required속성이 패키지 트랜잭션에 적용됩니다.

다음과 같은 경우 자식 컨테이너에서 요청하는 IsolationLevel 속성 값이 무시됩니다.
자식 컨테이너의 TransactionOption 속성 값이 Supported일 경우
자식 컨테이너는 부모 컨테이너의 트랜잭션을 조인합니다.

컨테이너에서 요청한 IsolationLevel 속성의 가능한 값은 컨테이너가 새 트랜잭션을 시작할 때만 적용됩니다. 다음과 같은 경우 컨테이너가 새 트랜잭션을 시작합니다.
컨테이너의 TransactionOption 속성의 가능한 값이 Required일 경우
부모가 트랜잭션을 시작하지 않은 경우



자세한 내용은 IsolationLevel를 참조하세요.
TransactionOption 컨테이너의 트랜잭션 참여 가능한 값은 NotSupported, Supported, Required입니다. 이 속성의 기본값은 Supported입니다. 자세한 내용은 DTSTransactionOption를 참조하세요.

버전

이 범주의 속성은 패키지 개체의 버전에 대한 정보를 제공합니다.

속성 설명
VersionBuild 패키지 빌드의 버전 번호입니다.
VersionComments 패키지 버전에 대한 설명입니다.
VersionGUID 패키지 버전의 GUID 이 속성은 읽기 전용입니다.
VersionMajor 패키지의 최신 주 버전입니다.
VersionMinor 최신 부 버전의 패키지

속성 창에서 패키지 속성을 설정합니다.

  1. SSDT(SQL Server Data Tools)에서 구성하기 원하는 패키지가 들어 있는 Integration Services 프로젝트를 엽니다.

  2. 솔루션 탐색기에서 패키지를 두 번 클릭하여 SSIS 디자이너에서 열거나 마우스 오른쪽 단추를 클릭하고 뷰 디자이너를 선택합니다.

  3. 제어 흐름 탭을 클릭한 다음 다음 중 하나를 수행합니다.

    • 제어 흐름 디자인 화면 배경의 아무 곳이나 마우스 오른쪽 단추로 클릭한 다음, 속성을 선택합니다.

    • 보기 메뉴에서 속성 창을 클릭합니다.

  4. 속성 창에서 패키지 속성을 편집합니다.

  5. 파일 메뉴에서 선택한 항목 저장 을 클릭하여 업데이트된 패키지를 저장합니다.