设置包属性

更新日期： 2006 年 7 月 17 日

在 Business Intelligence Development Studio 中使用 SQL Server 2005 Integration Services (SSIS) 提供的图形界面创建包时，可以在“属性”窗口中设置包对象的各个属性。

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

按类别排列时，**“属性”**窗口将属性分成以下类别：

• 检查点
• 执行
• 强制执行值
• 标识
• 杂项
• 安全性
• 事务
• 版本

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

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

• 如何使用“属性”窗口设置包属性

按类别排列的属性

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

检查点

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

属性	说明
CheckpointFileName	用于捕获使包重新启动的检查点信息的文件的名称。当包成功完成时，该文件便会被删除。
CheckpointUsage	指定何时可以重新启动包。值为 Never、IfExists 和 Always。此属性的默认值为 Never，指示包不能重新启动。有关详细信息，请参阅 DTSCheckpointUsage。
SaveCheckpoints	指定在包运行时，是否将检查点写入检查点文件。此属性的默认值为 False。

注意：
dtexec 的 /CheckPointing on 选项等同于将包的 SaveCheckpoints 属性设置为 True 并将 CheckpointUsage 属性设置为“Always”。有关详细信息，请参阅 dtexec 实用工具。

执行

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

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

强制执行值

此类别中的属性用于配置包的执行结果。

属性	说明
ForcedExecutionValue	如果 ForceExecutionValue 设置为 True，则该值指定包所返回的执行值。此属性的默认值为 0。
ForcedExecutionValueType	ForcedExecutionValue 的数据类型。
ForceExecutionValue	指定包的执行值是否为强制值。此属性的默认值为 False。

标识

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

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

杂项

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

属性

说明

Configurations

包使用的配置集合。单击浏览按钮 (…) 可以查看和配置包配置。

Expressions

单击浏览按钮 (…) 可以为包属性创建表达式。

注意：

您可以为对象模型包含的所有包属性，而不仅仅是“属性”窗口中列出的属性，创建属性表达式。

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

若要查看现有的属性表达式，请展开 Expressions。单击表达式文本框中的浏览按钮 (…) 可以修改和计算表达式。

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

指示当包所含对象的更新版本可用时，是否更新包以使用更新版本的对象。例如，如果此属性设置为 True，则会更新包含大容量插入任务的包，以使用 Integration Services 所提供的更新版本的大容量插入任务。此属性的默认值为 False。

安全性

此类别中的属性用于设置包的保护级别。有关详细信息，请参阅设置包的保护级别。

属性	说明
PackagePassword	要求密码的包保护级别（EncryptSensitiveWithPassword 和 EncryptAllWithPassword）的密码。
ProtectionLevel	包的保护级别。其值为：DontSaveSensitive、EncryptSensitiveWithUserKey、EncryptSensitiveWithPassword、EncryptAllWithPassword 和 ServerStorage。此属性的默认值为 EncryptSensitiveWithUserKey。有关详细信息，请参阅 DTSProtectionLevel。

事务

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

属性	说明
IsolationLevel	包事务的隔离级别。其值为：Unspecified、Chaos、ReadUncommitted、ReadCommitted、RepeatableRead、Serializable 和 Snapshot。此属性的默认值为 Serializable。有关详细信息，请参阅 IsolationLevel。
TransactionOption	包的事务参与情况。其值为：NotSupported、Supported、Required。此属性的默认值为 Supported。有关详细信息，请参阅 DTSTransactionOption。

版本

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

属性	说明
VersionBuild	包的内部版本号。
VersionComments	包的版本注释。
VersionGUID	包版本的 GUID。该属性为只读。
VersionMajor	包的最新主版本。
VersionMinor	包的最新次版本。

请参阅

其他资源

在 SSIS 设计器中创建包

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

发布日期	历史记录
2006 年 7 月 17 日	更改的内容： 增加了有关如何通过脱机工作防止出现验证错误的信息。
2006 年 4 月 14 日	更改的内容： 增加了有关新的 ForceExecutionResult 属性的信息。