패키지 속성 설정Set Package Properties

SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) 가 제공하는 그래픽 인터페이스를 사용하여 Integration ServicesIntegration Services 에서 패키지를 만들 때는 속성 창에서 패키지 개체의 속성을 설정합니다.When you create a package in SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) by using the graphical interface that Integration ServicesIntegration Services provides, you set the properties of the package object in the Properties window.

속성 창에는 속성이 항목별 및 사전순으로 제공됩니다.The Properties window provides a categorized and alphabetical list of properties. 속성 창을 항목별로 정렬하려면 항목별 아이콘을 클릭합니다.To arrange the Properties window by category, click the Categorized icon.

항목별로 정렬되면 속성 창의 속성이 다음과 같은 항목에 따라 그룹화됩니다.When arranged by category, the Properties window groups properties in the following categories:

속성 창에서 패키지 속성을 설정하려면To set package properties in the Properties window

항목별 속성Properties by Category

다음 표에서는 항목별 패키지 속성을 나열합니다.The following tables list the package properties by category.

검사점 Checkpoints

이 항목의 속성을 사용하면 제어 흐름 시작부터 패키지를 다시 실행하는 대신 패키지 제어 흐름의 오류 발생 시점으로부터 패키지를 다시 시작할 수 있습니다.You can use the properties in this category to restart the package from a point of failure in the package control flow, instead of rerunning the package from the beginning of its control flow. 자세한 내용은 Restart Packages by Using Checkpoints을 참조하세요.For more information, see Restart Packages by Using Checkpoints.

속성Property DescriptionDescription
CheckpointFileNameCheckpointFileName 패키지를 다시 시작하도록 만드는 검사점 정보를 캡처하는 파일 이름입니다.The name of the file that captures the checkpoint information that enables a package to restart. 패키지가 성공적으로 종료되면 이 파일이 삭제됩니다.When the package finishes successfully, this file is deleted.
CheckpointUsageCheckpointUsage 패키지를 다시 시작할 수 있는 시점을 지정합니다.Specifies when a package can be restarted. 가능한 값은 Never, IfExistsAlways입니다.The values are Never, IfExists, and Always. 이 속성의 기본값은 Never이며 이 경우 패키지를 다시 시작할 수 없습니다.The default value of this property is Never, which indicates that the package cannot be restarted. 자세한 내용은 DTSCheckpointUsage를 참조하세요.For more information, see DTSCheckpointUsage.
SaveCheckpointsSaveCheckpoints 패키지가 실행될 때 검사점 파일에 검사점이 기록되는지 여부를 지정합니다.Specifies whether the checkpoints are written to the checkpoint file when the package runs. 이 속성의 기본값은 False입니다.The default value of this property is False.
참고

dtexec의 /CheckPointing on 옵션은 패키지의 SaveCheckpoints 속성을 True로 설정하고 CheckpointUsage 속성을 Always로 설정하는 것과 같습니다.The /CheckPointing on option of dtexec is equivalent to setting the SaveCheckpoints property of the package to True, and the CheckpointUsage property to Always. 자세한 내용은 dtexec Utility를 참조하세요.For more information, see dtexec Utility.

실행 Execution

이 항목의 속성은 패키지 개체의 런타임 동작을 구성합니다.The properties in this category configure the run-time behavior of the package object.

속성Property DescriptionDescription
DelayValidationDelayValidation 패키지가 실행될 때까지 패키지 유효성 검사를 지연할지 여부를 나타냅니다.Indicates whether package validation is delayed until the package runs. 이 속성의 기본값은 False입니다.The default value for this property is False.
사용 안함Disable 패키지가 비활성화되는지 여부를 나타냅니다.Indicates whether the package is disabled. 이 속성의 기본값은 False입니다.The default value of this property is False.
DisableEventHandlersDisableEventHandlers 패키지 이벤트 처리기가 실행되는지 여부를 지정합니다.Specifies whether the package event handlers run. 이 속성의 기본값은 False입니다.The default value of this property is False.
FailPackageOnFailureFailPackageOnFailure 패키지 구성 요소에서 오류가 발생하는 경우 패키지가 실패하는지 여부를 지정합니다.Specifies whether the package fails if an error occurs in a package component. 이 속성의 유효한 값은 False가 유일합니다.The only valid value of this property is False.
FailParentOnErrorFailParentOnError 자식 컨테이너에서 오류가 발생하는 경우 부모 컨테이너가 실패하는지 여부를 나타냅니다.Specifies whether the parent container fails if an error occurs in a child container. 이 속성의 기본값은 False입니다.The default value is of this property is False.
MaxConcurrentExecutablesMaxConcurrentExecutables 패키지에서 동시에 실행할 수 있는 실행 파일 수입니다.The number of executable files that the package can run concurrently. 이 속성의 기본값은 -1이며 이 경우 한계가 없습니다.The default value of this property is -1, which indicates that there is no limit.
MaximumErrorCountMaximumErrorCount 패키지 실행이 중지될 때까지 발생할 수 있는 최대 오류 수입니다.The maximum number of errors that can occur before a package stops running. 이 속성의 기본값은 1입니다.The default value of this property is 1.
PackagePriorityClassPackagePriorityClass 패키지 스레드의 Win32 스레드 우선 순위 클래스입니다.The Win32 thread priority class of the package thread. 가능한 값은 Default, AboveNormal, Normal, BelowNormalIdle입니다.The values are Default, AboveNormal, Normal, BelowNormal, Idle. 이 속성의 기본값은 Default입니다.The default value of this property is Default. 자세한 내용은 DTSPriorityClass를 참조하세요.For more information, see DTSPriorityClass.

강제 실행 값 Forced Execution Value

이 범주의 속성은 패키지의 선택적 실행 값을 구성합니다.The properties in this category configure an optional execution value for the package.

속성Property DescriptionDescription
ForcedExecutionValueForcedExecutionValue ForceExecutionValue가 True로 설정된 경우 패키지가 반환하는 선택적 실행 값을 지정하는 값입니다.If ForceExecutionValue is set to True, a value that specifies the optional execution value that the package returns. 이 속성의 기본값은 0입니다.The default value of this property is 0.
ForcedExecutionValueTypeForcedExecutionValueType ForcedExecutionValue의 데이터 형식입니다.The data type of ForcedExecutionValue. 이 속성의 기본값은 Int32입니다.The default value of this property is Int32.
ForceExecutionValueForceExecutionValue 컨테이너의 선택적 실행 값에 특정 값이 포함되도록 강제해야 하는지 여부를 나타내는 부울 값입니다.A Boolean value that specifies whether the optional execution value of the container should be forced to contain a particular value. 이 속성의 기본값은 False입니다.The default value of this property is False.

ID Identification

이 항목의 속성은 패키지의 고유 식별자 및 이름과 같은 정보를 제공합니다.The properties in this category provide information such as the unique identifier and name of the package.

속성Property DescriptionDescription
CreationDateCreationDate 패키지를 만든 날짜입니다.The date that the package was created.
CreatorComputerNameCreatorComputerName 패키지를 만든 컴퓨터의 이름입니다.The name of the computer on which the package was created.
CreatorNameCreatorName 패키지를 만든 사용자의 이름입니다.The name of the person who created the package.
DescriptionDescription 패키지 기능에 대한 설명입니다.A description of package functionality.
IDID 패키지를 만들 때 할당된 패키지 GUID입니다.The package GUID, which is assigned when the package is created. 이 속성은 읽기 전용입니다.This property is read-only. 에 대 한 새로운 임의 값을 생성 하는 ID 속성을 선택 <새 ID 만들기> 드롭 다운 목록에 있습니다.To generate a new random value for the ID property, select <Generate New ID> in the drop-down list.
이름Name 패키지의 이름입니다.The name of the package.
PackageTypePackageType 패키지 유형입니다.The package type. 가능한 값은 Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaintSQLReplication입니다.The values are Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaint, and SQLReplication. 이 속성의 기본값은 Default입니다.The default value of this property is Default. 자세한 내용은 DTSPackageType를 참조하세요.For more information, see DTSPackageType.

기타 Misc

이 항목의 속성은 패키지에서 사용하는 구성 및 식에 액세스하고 패키지의 로캘 및 로깅 모드에 대한 정보를 제공하는 데 사용됩니다.The properties in this category are used to access the configurations and expressions that a package uses and to provide information about the locale and logging mode of the package. 자세한 내용은 패키지에서 속성 식 사용을 참조하세요.For more information, see Use Property Expressions in Packages.

속성Property DescriptionDescription
구성Configurations 패키지에서 사용되는 구성 모음입니다.The collection of configurations that the package uses. 패키지 구성을 보고 구성하려면 찾아보기 단추 (…) 를 클릭합니다.Click the browse button (…) to view and configure package configurations.
Expressions 패키지 속성에 대한 식을 만들려면 찾아보기 단추 (…) 를 클릭합니다.Click the browse button (…) to create expressions for package properties.

속성 창에 나열된 속성뿐만 아니라 개체 모델에 포함되는 모든 패키지 속성에 대한 속성 식을 만들 수 있습니다.Note that you can create property expressions for all the package properties that object model includes, not just the properties listed in the Properties window.

자세한 내용은 패키지에서 속성 식 사용을 참조하세요.For more information, see Use Property Expressions in Packages.

기존 속성 식을 보려면 Expressions를 확장합니다.To view existing property expressions, expand Expressions. 식을 수정하고 계산하려면 식 입력란에 있는 찾아보기 단추 (…) 를 클릭합니다.Click the browse button (…) in an expression text box to modify and evaluate an expression.
ForceExecutionResultForceExecutionResult 패키지의 실행 결과입니다.The execution result of the package. 가능한 값은 None, Success, FailureCompletion입니다.The values are None, Success, Failure, and Completion. 이 속성의 기본값은 None입니다.The default value of this property is None. 자세한 내용은 T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult를 참조하세요.For more information, see T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.
LocaleIdLocaleId Microsoft Win32 로캘입니다.A Microsoft Win32 locale. 이 속성의 기본값은 로컬 컴퓨터 운영 체제의 로캘입니다.The default value of this property is the locale of the operating system on the local computer.
LoggingModeLoggingMode 패키지의 로깅 동작을 지정하는 값입니다.A value that specifies the logging behavior of the package. 가능한 값은 Disabled, EnabledUseParentSetting입니다.The values are Disabled, Enabled, and UseParentSetting. 이 속성의 기본값은 UseParentSetting입니다.The default value of this property is UseParentSetting. 자세한 내용은 DTSLoggingMode를 참조하세요.For more information, see DTSLoggingMode.
OfflineModeOfflineMode 패키지가 오프라인 모드인지 여부를 나타냅니다.Indicates whether the package is in offline mode. 이 속성은 읽기 전용입니다.This property is read-only. 이 속성은 프로젝트 수준에서 설정됩니다.The property is set at the project level. 일반적으로 SSISSSIS 디자이너는 패키지에서 원본 및 대상과 연결된 메타데이터의 유효성을 검사하는 데 사용되는 각 데이터 원본에 연결을 시도합니다.Normally, SSISSSIS Designer tries to connect to each data source used by your package to validate the metadata associated with sources and destinations. 패키지를 열기 전이라도 SSIS 메뉴의 오프라인으로 작업 을 설정하면 데이터 원본을 사용할 수 없을 때 이러한 연결이 시도됨으로써 유효성 검사 오류가 발생하는 것을 방지할 수 있습니다.You can enable Work Offline from the SSIS menu, even before you open a package, to prevent these connection attempts and the resulting validation errors when the data sources are not available. 또한 오프라인으로 작업 을 설정하여 디자이너에서의 작업 속도를 높이고, 패키지의 유효성을 검사하려는 경우에만 이 옵션을 해제할 수도 있습니다.You can also enable Work Offline to speed up operations in the designer, and disable it only when you want your package to be validated.
SuppressConfigurationWarningsSuppressConfigurationWarnings 구성에 의해 생성된 경고가 표시되지 않는지 여부를 나타냅니다.Indicates whether the warnings generated by configurations are suppressed. 이 속성의 기본값은 False입니다.The default value of this property is False.
UpdateObjectsUpdateObjects 새로운 버전을 사용할 수 있는 경우 패키지에 포함된 새로운 버전의 개체를 사용하도록 패키지가 업데이트되는지 여부를 나타냅니다.Indicates whether the package is updated to use newer versions of the objects it contains, if newer versions are available. 예를 들어 이 속성이 True로 설정된 경우 대량 삽입 태스크를 포함하는 패키지는 Integration ServicesIntegration Services 에서 제공하는 새로운 버전의 대량 삽입 태스크를 사용하도록 업데이트됩니다.For example, if this property is set to True, a package that includes a Bulk Insert task is updated to use the newer version of the Bulk Insert task that Integration ServicesIntegration Services provides. 이 속성의 기본값은 False입니다.The default value of this property is False.

보안 Security

이 항목의 속성은 패키지의 보호 수준을 설정하는 데 사용됩니다.The properties in this category are used to set the protection level of the package. 자세한 내용은 Access Control for Sensitive Data in Packages을 참조하세요.For more information, see Access Control for Sensitive Data in Packages.

속성Property DescriptionDescription
PackagePasswordPackagePassword 암호가 필요한 패키지 보호 수준(EncryptSensitiveWithPasswordEncryptAllWithPassword)에 대한 암호입니다.The password for package protection levels (EncryptSensitiveWithPassword and EncryptAllWithPassword) that require passwords.
ProtectionLevelProtectionLevel 패키지의 보호 수준입니다.The protection level of the package. 가능한 값은 DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPasswordServerStorage입니다.The values are DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassword, and ServerStorage. 이 속성의 기본값은 EncryptSensitiveWithUserKey입니다.The default value of this property is EncryptSensitiveWithUserKey. 자세한 내용은 DTSProtectionLevel를 참조하세요.For more information, see DTSProtectionLevel.

트랜잭션 Transactions

이 항목의 속성은 격리 수준과 패키지의 트랜잭션 옵션을 구성합니다.The properties in this category configure the isolation level and the transaction option of the package. 자세한 내용은 Integration Services 트랜잭션을 참조하세요.For more information, see Integration Services Transactions.

속성Property DescriptionDescription
IsolationLevelIsolationLevel 패키지 트랜잭션의 격리 수준입니다.The isolation level of the package transaction. 가능한 값은 Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, SerializableSnapshot입니다.The values are Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable, and Snapshot. 이 속성의 기본값은 Serializable입니다.The default value of this property is Serializable.

참고: IsolationLevel 속성의 Snapshot 값은 패키지 트랜잭션에 사용할 수 없습니다.Note: The Snapshot value of the IsolationLevel property is incompatible with package transactions. 따라서 IsolationLevel 속성으로는 패키지 트랜잭션의 격리 수준을 Shapshot으로 설정할 수 없습니다.Therefore, you cannot use the IsolationLevel property to set the isolation level of package transactions to Shapshot. 패키지 트랜잭션을 Snapshot으로 설정하려면 SQL 쿼리를 대신 사용해야 합니다.Instead, use an SQL query to set package transactions to Snapshot. 자세한 내용은 SET TRANSACTION ISOLATION LEVEL(Transact-SQL)을 참조하세요.For more information, see SET TRANSACTION ISOLATION LEVEL (Transact-SQL).

IsolationLevel 속성 값을 TransactionOption 로 설정한 경우에만 Required속성이 패키지 트랜잭션에 적용됩니다.The system applies the IsolationLevel property to package transactions only when the value of the TransactionOption property is Required.

다음과 같은 경우 자식 컨테이너에서 요청하는 IsolationLevel 속성 값이 무시됩니다.The value of the IsolationLevel property requested by a child container is ignored when the following conditions are true:
자식 컨테이너의 TransactionOption 속성 값이 Supported일 경우The value of the child container's TransactionOption property is Supported.
자식 컨테이너가 부모 컨테이너의 트랜잭션에 참여하는 경우The child container joins the transaction of a parent container.

컨테이너에서 요청하는 IsolationLevel 속성 값은 컨테이너가 새 트랜잭션을 시작할 때만 적용됩니다.The value of the IsolationLevel property requested by the container is respected only when the container initiates a new transaction. 다음과 같은 경우 컨테이너가 새 트랜잭션을 시작합니다.A container initiates a new transaction when the following conditions are true:
컨테이너의 TransactionOption 속성 값이 Required일 경우The value of the container's TransactionOption property is Required.
부모는 트랜잭션을 시작하지 않습니다.The parent has not already started a transaction.



자세한 내용은 IsolationLevel를 참조하세요.For more information, see IsolationLevel.
TransactionOptionTransactionOption 패키지의 트랜잭션 참여 옵션입니다.The transactional participation of the package. 가능한 값은 NotSupported, SupportedRequired입니다.The values are NotSupported, Supported, Required. 이 속성의 기본값은 Supported입니다.The default value of this property is Supported. 자세한 내용은 DTSTransactionOption를 참조하세요.For more information, see DTSTransactionOption.

버전 Version

이 항목의 속성은 패키지 개체의 버전에 대한 정보를 제공합니다.The properties in this category provide information about the version of the package object.

속성Property DescriptionDescription
VersionBuildVersionBuild 패키지 빌드의 버전 번호입니다.The version number of the build of the package.
VersionCommentsVersionComments 패키지 버전에 대한 설명입니다.Comments about the version of the package.
VersionGUIDVersionGUID 패키지 버전의 GUID입니다.The GUID of the version of the package. 이 속성은 읽기 전용입니다.This property is read-only.
VersionMajorVersionMajor 패키지의 최신 주 버전입니다.The latest major version of the package.
VersionMinorVersionMinor 패키지의 최신 부 버전입니다.The latest minor version of the package.

속성 창에서 패키지 속성 설정Set package properties in the Properties window

  1. SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)에서 구성할 패키지가 들어 있는 Integration ServicesIntegration Services 프로젝트를 엽니다.In SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services project that contains the package you want to configure.

  2. 솔루션 탐색기에서 패키지를 두 번 클릭하여 SSISSSIS 디자이너로 열거나 마우스 오른쪽 단추로 클릭하고 디자이너 보기를 선택합니다.In Solution Explorer, double-click the package to open it in SSISSSIS Designer, or right-click and select View Designer.

  3. 제어 흐름 탭을 클릭한 후 다음 중 하나를 수행합니다.Click the Control Flow tab and then do one of the following:

    • 제어 흐름 디자인 화면 배경의 아무 위치나 마우스 오른쪽 단추로 클릭한 후 속성을 클릭합니다.Right-click anywhere in the background of the control flow design surface, and then click Properties.

    • 보기 메뉴에서 속성 창을 클릭합니다.On the View menu, click Properties Window.

  4. 속성 창에서 패키지 속성을 편집합니다.Edit the package properties in the Properties window.

  5. 파일 메뉴에서 선택한 항목 저장 을 클릭하여 업데이트된 패키지를 저장합니다.On the File menu, click Save Selected Items to save the updated package.