设置包属性

在 SQL Server Data Tools (SSDT) 中使用 Integration Services 提供的图形界面创建包时,可以在“属性”窗口中设置包对象的各个属性。

“属性” 窗口按分类和字母顺序排序列出了一系列属性列表。 若要按类别排列 “属性” 窗口,请单击“按分类顺序”图标。

按类别排列时, “属性” 窗口将属性分成以下类别:

有关不能在“属性” 窗口中设置的其他包属性的信息,请参阅

在“属性”窗口中设置包属性

按类别排列的属性

下表列出了按类别排列的包属性。

检查站

使用此类别中的属性可以从包控制流中的某一故障点重新启动包,而不是从包控制流的开始处重新运行包。 有关详细信息,请参阅 通过使用检查点重新启动包

资产 DESCRIPTION
CheckpointFileName 用于捕获使包重新启动的检查点信息的文件的名称。 当包成功完成时,该文件便会被删除。
CheckpointUsage 指定何时可以重新启动包。 具体的值为 NeverIfExistsAlways。 此属性的默认值为 Never,指示无法重启包。 有关详细信息,请参阅 DTSCheckpointUsage
SaveCheckpoints 指定在包运行时,是否将检查点写入检查点文件。 此属性的默认值为 False

注释

/CheckPointing on dtexec 的选项等效于将SaveCheckpoints包的属性设置为 True,并将CheckpointUsage属性设置为 Always。 有关详细信息,请参阅 dtexec Utility

执行

此类别中的属性可配置包对象的运行时行为。

资产 DESCRIPTION
DelayValidation 指示是否将包验证推迟至包运行之时进行。 此属性的默认值为 False.
禁用 指示包是否已禁用。 此属性的默认值为 False
DisableEventHandlers 指定包事件处理程序是否运行。 此属性的默认值为 False
FailPackageOnFailure 指定如果包组件中出现错误时,包是否失败。 此属性 False的唯一有效值为 。
FailParentOnError 指定如果子容器中出现错误,父容器是否失败。 此属性的默认值为 False.
MaxConcurrentExecutables 包可以同时执行的可执行文件数目。 此属性的默认值为 -1,表示没有任何限制。
MaximumErrorCount 包停止运行前可以出现的最大错误数。 此属性的默认值为 1
PackagePriorityClass 包线程的 Win32 线程优先级类。 这些值为 Default,, AboveNormalNormalBelowNormalIdle 此属性的默认值为 Default。 有关详细信息,请参阅 DTSPriorityClass

强制执行值

此类别中的属性用于配置包的可选执行值。

资产 DESCRIPTION
ForcedExecutionValue 如果将 ForceExecutionValue 设置为 True,则该值为包返回的可选执行值。 此属性的默认值为 0
ForcedExecutionValueType ForcedExecutionValue 的数据类型。 此属性的默认值为 Int32
ForceExecutionValue 指定容器的可选执行值是否应强制包含特定值的布尔值。 此属性的默认值为 False

标识

此类别中的属性提供诸如包的唯一标识符和名称等信息。

资产 DESCRIPTION
CreationDate 包的创建日期。
CreatorComputerName 创建包的计算机的名称。
CreatorName 包创建者的姓名。
Description 包功能说明。
ID 包 GUID,该属性是在创建包时分配的。 此属性为只读。 若要为ID属性生成新的随机值,请选择下拉列表中的“<生成新 ID>”。
Name 包的名称。
PackageType 包类型。 值为 Default、、DTSDesignerDTSDesigner100DTSWizardSQLDBMaintSQLReplication。 此属性的默认值为 Default。 有关详细信息,请参阅 DTSPackageType

杂项

此类别中的属性用于访问包所使用的配置和表达式,以及提供有关包的区域设置和日志记录模式的信息。 有关详细信息,请参阅 在包中使用属性表达式

资产 DESCRIPTION
Configurations 包使用的配置集合。 单击浏览按钮 (…) 可以查看和配置包配置 。
Expressions 单击浏览按钮 (…) 可以为包属性创建表达式 。

注意:可以为对象模型包括的所有包属性创建属性表达式,而不仅仅是“属性”窗口中列出的属性。

有关详细信息,请参阅 在包中使用属性表达式

若要查看现有属性表达式,请展开 Expressions。 单击表达式文本框中的浏览按钮 (…) 可以修改和计算表达式 。
ForceExecutionResult 包的执行结果。 其值为:NoneSuccessFailureCompletion。 此属性的默认值为 None。 有关详细信息,请参阅 T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult。
LocaleId Microsoft Win32 区域设置。 此属性的默认值为本地计算机上操作系统的区域设置。
LoggingMode 指定包日志记录行为的值。 具体的值为 DisabledEnabledUseParentSetting。 此属性的默认值为 UseParentSetting。 有关详细信息,请参阅 DTSLoggingMode
OfflineMode 指示该包是否处于脱机模式下。 此属性为只读。 该属性在项目级设置。 通常, SSIS 设计器将尝试连接包使用的每个数据源以验证与源和目标相关联的元数据。 您可以从 “SSIS” 菜单中启用 “脱机工作” (即使在打开包之前也可以)以阻止这些连接尝试和数据源不可用时导致的验证错误。 您还可以启用 “脱机工作” 以加快设计器中操作的速度,而仅在需要验证包的时候再禁用此选项。
SuppressConfigurationWarnings 指示是否取消配置生成的警告。 此属性的默认值为 False
UpdateObjects 指示当包所含对象的更新版本可用时,是否更新包以使用更新版本的对象。 例如,如果此属性设置为 True,则会更新包含大容量插入任务的包,以使用 Integration Services 提供的较新版本的大容量插入任务。 此属性的默认值为 False

安全

此类别中的属性用于设置包的保护级别。 有关详细信息,请参阅 Access Control for Sensitive Data in Packages

资产 DESCRIPTION
PackagePassword 需要密码的包保护级别(EncryptSensitiveWithPasswordEncryptAllWithPassword)的密码。
ProtectionLevel 包的保护级别。 值为 DontSaveSensitive、、EncryptSensitiveWithUserKeyEncryptSensitiveWithPasswordEncryptAllWithPasswordServerStorage。 此属性的默认值为 EncryptSensitiveWithUserKey。 有关详细信息,请参阅 DTSProtectionLevel

交易

此类别中的属性用于配置包的隔离级别和事务选项。 有关详细信息,请参阅 Integration Services 事务

资产 DESCRIPTION
IsolationLevel 包事务的隔离级别。 此属性的默认值为 Serializable。 有效值为
Unspecified
Chaos
ReadUncommitted
ReadCommitted
RepeatableRead
Serializable
Snapshot

仅当属性的值TransactionOptionRequired时,系统才将IsolationLevel属性应用于包事务。

如果满足以下条件,则忽略子容器请求的属性的值 IsolationLevel

子容器 TransactionOption 属性的值为 Supported.
子容器联接父容器的事务。

仅当容器启动新事务时,才会尊重容器请求的属性的值 IsolationLevel 。 在以下条件成立时,容器将开始新的事务:

容器 TransactionOption 属性的值为 Required.
父级已开始一个事务。



注意:属性 Snapshot 的值 IsolationLevel 与包事务不兼容。 因此,不能使用 IsolationLevel 属性将包事务的隔离级别设置为 Shapshot。 请改用 SQL 查询将包事务设置为 Snapshot。 有关详细信息,请参阅 SET TRANSACTION ISOLATION LEVEL (Transact-SQL)

有关属性 IsolationLevel 的详细信息,请参阅 IsolationLevel
TransactionOption 包的事务参与情况。 值为 NotSupportedSupportedRequired。 此属性的默认值为 Supported。 有关详细信息,请参阅 DTSTransactionOption

版本

此类别中的属性用于提供包对象的版本信息。

资产 DESCRIPTION
VersionBuild 包的内部版本号。
VersionComments 包的版本注释。
VersionGUID 包版本的 GUID。 此属性为只读。
VersionMajor 包的最新主版本。
VersionMinor 包的最新次版本。