通过

  • 项目

设置包属性

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

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

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

  • 检查点

  • 执行

  • 强制执行值

  • 标识

  • 杂项

  • 安全性

  • 事务

  • 版本

有关不能在**“属性”**窗口中设置的其他包属性的信息，请参阅 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 的数据类型。此属性的默认值为 Int32。

ForceExecutionValue

指定容器的可选执行值是否应强制包含特定值的布尔值。此属性的默认值为 False。

标识

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

属性

说明

CreationDate

包的创建日期。

CreatorComputerName

创建包的计算机的名称。

CreatorName

包创建者的姓名。

Description

包功能说明。

ID

包 GUID，该属性是在创建包时分配的。该属性为只读。若要为 ID 属性生成新的随机值，请在下拉列表中选择“<生成新 ID>”。

Name

包的名称。

PackageType

包类型。其值为：Default、DTSDesigner、DTSDesigner100、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 属性的 Snapshot 值与包事务不兼容。因此，您无法使用 IsolationLevel 属性将包事务的隔离级别设为 Shapshot。而是使用 SQL 查询将包事务设为 Snapshot。有关详细信息，请参阅SET TRANSACTION ISOLATION LEVEL (Transact-SQL)。

仅当 TransactionOption 属性的值设为 Required 时，系统才将 IsolationLevel 属性应用到包事务。

在以下条件成立时，将忽略子容器请求的 IsolationLevel 属性的值：

  • 子容器的 TransactionOption 属性的值为 Supported。

  • 子容器联接父容器的事务。

只有在容器开始新的事务时，才遵从该容器请求的 IsolationLevel 属性的值。在以下条件成立时，容器将开始新的事务：

  • 容器的 TransactionOption 属性的值为 Required。

  • 父级已开始一个事务。

有关详细信息，请参阅 IsolationLevel。

TransactionOption

包的事务参与情况。其值为：NotSupported、Supported、Required。此属性的默认值为 Supported。有关详细信息，请参阅 DTSTransactionOption。

版本

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

属性

说明

VersionBuild

包的内部版本号。

VersionComments

包的版本注释。

VersionGUID

包版本的 GUID。该属性为只读。

VersionMajor

包的最新主版本。

VersionMinor

包的最新次版本。
Integration Services 图标(小) 使 Integration Services 保持最新

若要从 Microsoft 获得最新的下载内容、文章、示例和视频，以及从社区获得所选解决方案，请访问 MSDN 或 TechNet 上的 Integration Services 页：

若要获得有关这些更新的自动通知，请订阅该页上提供的 RSS 源。

更改历史记录

更新的内容

  • 更新了“强制执行值”类别中值的说明。

  • 解释了 TransactionOption 属性如何影响是否忽略容器请求的 IsolationLevel 属性的值。

  • 添加了一条说明，指出为什么您不能使用 IsolationLevel 属性将包事务设为 Snapshot。