设置包属性

适用于: SQL Server Azure 数据工厂中的 SSIS Integration Runtime

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

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

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

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

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

按类别排列的属性

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

检查点

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

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

备注

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

执行

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

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

强制执行值

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

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

标识

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

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

杂项

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

properties 说明
配置 包使用的配置集合。 单击浏览按钮 (…) 可以查看和配置包配置 。
表达式 单击浏览按钮 (…) 可以为包属性创建表达式 。

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

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

若要查看现有的属性表达式,请展开 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

properties 说明
PackagePassword 需要密码的包保护级别 (EncryptSensitiveWithPasswordEncryptAllWithPassword) 的密码。
ProtectionLevel 包的保护级别。 其值为: DontSaveSensitiveEncryptSensitiveWithUserKeyEncryptSensitiveWithPasswordEncryptAllWithPasswordServerStorage。 此属性的默认值为 EncryptSensitiveWithUserKey。 有关详细信息,请参阅 DTSProtectionLevel

事务

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

properties 说明
IsolationLevel 包事务的隔离级别。 其值为: UnspecifiedChaosReadUncommittedReadCommittedRepeatableReadSerializableSnapshot。 此属性的默认值为 Serializable

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

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

在以下条件成立时,将忽略子容器请求的 IsolationLevel 属性的值:
子容器的 TransactionOption 属性的值为 Supported
子容器联接父容器的事务。

只有在容器开始新的事务时,才遵从该容器请求的 IsolationLevel 属性的值。 在以下条件成立时,容器将开始新的事务:
容器的 TransactionOption 属性的值为 Required
父级已开始一个事务。



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

版本

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

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

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

  1. 在 SQL Server Data Tools (SSDT)中,打开要配置的包所在的 Integration Services 项目。

  2. 在 “解决方案资源管理器”中双击此包,将其在 SSIS 设计器中打开,或者右键单击并选择“视图设计器” 。

  3. 单击 “控制流” 选项卡,然后执行下列操作之一:

    • 右键单击控制流设计图面背景中的任意位置,然后单击“属性” 。

    • “视图” 菜单上,单击 “属性窗口”

  4. “属性” 窗口中编辑包属性。

  5. “文件” 菜单上单击 “保存选定项” ,保存已更新的包。