通过

  • 项目

目标自定义属性

Microsoft SQL Server Integration Services 对象模型中的数据流对象在组件、输入和输出以及输入列和输出列级别具有通用属性和自定义属性。自定义属性仅在运行时才可用，而且在 Integration Services 托管编程参考文档中没有对此进行介绍

本主题列出并介绍了数据流目标的自定义属性。

  • ADO NET 目标

  • 数据挖掘模型定型目标

  • DataReader 目标

  • 维度处理目标

  • Excel 目标

  • 平面文件目标

  • OLE DB 目标

  • 分区处理目标

  • 原始文件目标

  • 记录集目标

  • SQL Server Compact Edition 目标

  • SQL Server 目标

有关对大多数数据流对象都通用的属性的信息，请参阅通用属性。

目标的某些属性可以使用属性表达式进行设置，如本主题中所述。有关详细信息，请参阅可以使用表达式设置的数据流属性。

ADO NET 目标

ADO.NET 目标具有自定义属性和所有数据流组件通用的属性。

下表介绍了 ADO.NET 目标的自定义属性。所有属性均可读/写。这些属性在**“ADO NET 目标编辑器”中不可用，但可以使用“高级编辑器”**进行设置。

属性

数据类型

说明

BatchSize

整型

向服务器发送的批中的行数。值 0 指示批大小与内部缓冲区大小匹配。此属性的默认值为 0。

CommandTimeOut

Integer

SQL 命令在超时前可以运行的最大秒数。值 0 表示不限制时间。此属性的默认值为 0。

TableOrViewName

String

目标表或视图的名称

UseBulkInsertWhenAvailable

Boolean

一个值，指定是否使用 System.Data.SqlClient..::..SqlBulkCopy 接口来提高大容量插入操作的性能。只有某些 ADO.NET 访问接口支持此接口。

默认值为 True。

有关详细信息，请参阅 ADO NET 目标。

数据挖掘模型定型目标自定义属性

数据挖掘模型定型目标具有自定义属性和所有数据流组件通用的属性。

下表介绍了数据挖掘模型定型目标的自定义属性。所有属性均可读/写。

属性

数据类型

说明

ASConnectionId

String

连接管理器的唯一标识符。

ASConnectionString

String

Analysis Services 的实例或 Analysis Services 项目的连接字符串。

ObjectRef

String

标识转换使用的数据挖掘结构的 XML 标记。

数据挖掘模型定型目标的输入和输入列没有自定义属性。

有关详细信息，请参阅数据挖掘模型定型目标。

DataReader 目标自定义属性

DataReader 目标具有自定义属性和所有数据流组件通用的属性。

下表介绍了 DataReader 目标的自定义属性。除 DataReader 以外的所有属性均可读/写。

属性名称

数据类型

说明

DataReader

String

DataReader 目标的类名。

FailOnTimeout

Boolean

指示发生 ReadTimeout 时是否失败。此属性的默认值为 False。

ReadTimeout

Integer

超时发生之前的毫秒数。此属性的默认值为 30000（30 秒）。

DataReader 目标的输入和输入列没有自定义属性。

有关详细信息，请参阅 DataReader 目标。

维度处理目标自定义属性

维度处理目标具有自定义属性和所有数据流组件通用的属性。

下表介绍了纬度处理目标的自定义属性。所有属性均可读/写。

属性

数据类型

说明

ASConnectionString

String

Analysis Services 的实例或 Analysis Services 项目的连接字符串。

KeyDuplicate

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理重复键错误的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 IgnoreError (0)。

KeyErrorAction

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理键错误的值。可能的值为 ConvertToUnknown (0) 和 DiscardRecord (1)。此属性的默认值为 ConvertToUnknown (0)。

KeyErrorLimit

Integer

当 UseDefaultConfiguration 为 False 时，启用的键错误的上限。

KeyErrorLimitAction

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示达到 KeyErrorLimit 时要采取的操作的值。可能的值为 StopLogging (1) 和 StopProcessing (0)。此属性的默认值为 StopProcessing (0)。

KeyErrorLogFile

String

当 UseDefaultConfiguration 为 False 时，错误日志文件的路径和文件名。

KeyNotFound

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理缺少的键错误的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 IgnoreError (0)。

NullKeyConvertedToUnknown

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理转换为 unknown 值的 null 键的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 IgnoreError (0)。

NullKeyNotAllowed

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理禁止的 null 的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 IgnoreError (0)。

ProcessType

Integer（枚举）

转换使用的维度处理类型。值为 ProcessAdd (1)（增量）、ProcessFull (0) 和 ProcessUpdate (2)。

UseDefaultConfiguration

Boolean

一个指定转换是否使用默认错误配置的值。如果此属性为 False，则转换包含有关错误处理的信息。

纬度处理目标的输入和输入列没有自定义属性。

有关详细信息，请参阅维度处理目标。

Excel 目标自定义属性

Excel 目标具有自定义属性和所有数据流组件通用的属性。

下表介绍 Excel 目标的自定义属性。所有属性均可读/写。

属性名称

数据类型

说明

AccessMode

Integer（枚举）

一个指定目标如何访问其目标数据库的值。

此属性可以为下列值之一：

  • OpenRowset (0) - 需要提供表或视图的名称。

  • OpenRowset from Variable (1) - 需要提供包含表或视图名称的变量的名称。

  • OpenRowset Using Fastload (3) - 需要提供表或视图的名称。

  • OpenRowset Using Fastload from Variable (4) - 需要提供包含表或视图名称的变量的名称。

  • SQL Command (2) - 需要提供 SQL 语句。

CommandTimeout

Integer

SQL 命令在超时前可以运行的最大秒数。值 0 表示不限制时间。此属性的默认值为 0。

注意注意
此属性在“Excel 目标编辑器”中不可用，但可以使用“高级编辑器”进行设置。

FastLoadKeepIdentity

Boolean

该值指定加载数据时是否复制标识值。此属性仅对其中一个快速加载选项可用。此属性的默认值为 False。

FastLoadKeepNulls

Boolean

一个值，指定加载数据时是否复制 Null 值。此属性仅对其中一个快速加载选项可用。此属性的默认值为 False。

FastLoadMaxInsertCommitSize

Integer

指定 Excel 目标在快速加载操作期间尝试提交的批大小的值。默认值 0 指示处理所有的行后的单个提交操作。

FastLoadOptions

String

快速加载选项的集合。快速加载选项包括锁定表和检查约束。可以指定其中的一个，或同时指定两个，或不指定其中的任何一个。

注意注意
此属性的某些选项在“Excel 目标编辑器”中不可用，但可以使用“高级编辑器”进行设置。

OpenRowset

String

当 AccessMode 为 OpenRowset 时，Excel 目标访问的表或视图的名称。

OpenRowsetVariable

String

当 AccessMode 为 OpenRowset from Variable 时，包含 Excel 目标访问的表或视图名称的变量的名称。

SqlCommand

String

当 AccessMode 为 SQL 命令时，Excel 目标用于指定数据的目标列的 Transact-SQL 语句。

Excel 目标的输入和输入列没有自定义属性。

有关详细信息，请参阅 Excel 目标。

平面文件目标自定义属性

平面文件目标具有自定义属性和所有数据流组件通用的属性。

下表介绍平面文件目标的自定义属性。所有属性均可读/写。

属性名称

数据类型

说明

Header

String

写入任何数据之前插入到文件的文本块。

此属性的值可以使用属性表达式来指定。

Overwrite

Boolean

一个值，指定是覆盖还是追加到具有相同名称的现有目标文件。此属性的默认值为 True。

平面文件目标的输入和输入列没有自定义属性。

有关详细信息，请参阅平面文件目标。

OLE DB 目标自定义属性

OLE DB 目标具有自定义属性和所有数据流组件通用的属性。

下表介绍 OLE DB 目标的自定义属性。所有属性均可读/写。

注意注意

此处列出的 FastLoad 选项（FastLoadKeepIdentity、FastLoadKeepNulls 和 FastLoadOptions）对应于由 Microsoft OLE DB Provider for SQL Server (SQLOLEDB) 实现的 IRowsetFastLoad 接口公开的具有相似名称的属性。有关详细信息，请在 MSDN 库中搜索 IRowsetFastLoad。

属性名称

数据类型

说明

AccessMode

Integer（枚举）

一个指定目标如何访问其目标数据库的值。

此属性可以为下列值之一：

  • OpenRowset (0) - 需要提供表或视图的名称。

  • OpenRowset from Variable (1) - 需要提供包含表或视图名称的变量的名称。

  • OpenRowset Using Fastload (3) - 需要提供表或视图的名称。

  • OpenRowset Using Fastload from Variable (4) - 需要提供包含表或视图名称的变量的名称。

  • SQL Command (2) - 需要提供 SQL 语句。

AlwaysUseDefaultCodePage

Boolean

一个值，指示是使用每列的 DefaultCodePage 属性的值，还是尝试从每列的区域设置中派生代码页。此属性的默认值为 False。

CommandTimeout

Integer

SQL 命令在超时前可以运行的最大秒数。值 0 表示不限制时间。此属性的默认值为 0。

注意注意
此属性在“OLE DB 目标编辑器”中不可用，但可以使用“高级编辑器”进行设置。

DefaultCodePage

Integer

与 OLE DB 目标关联的默认代码页。

FastLoadKeepIdentity

Boolean

该值指定加载数据时是否复制标识值。此属性仅对其中一个快速加载选项可用。此属性的默认值为 False。此属性对应于 OLE DB IRowsetFastLoad (OLE DB) 属性 SSPROP_FASTLOADKEEPIDENTITY。

FastLoadKeepNulls

Boolean

一个值，指定加载数据时是否复制 Null 值。此属性仅对其中一个快速加载选项可用。此属性的默认值为 False。此属性对应于 OLE DB IRowsetFastLoad (OLE DB) 属性 SSPROP_FASTLOADKEEPNULLS。

FastLoadMaxInsertCommitSize

Integer

一个值，指定 OLE DB 目标在快速加载操作期间尝试提交的批大小。默认值 2147483647 指示处理所有的行后的单个提交操作。

FastLoadOptions

String

快速加载选项的集合。快速加载选项包括锁定表和检查约束。可以指定其中的一个，或同时指定两个，或不指定其中的任何一个。此属性对应于 OLE DB IRowsetFastLoad 属性 SSPROP_FASTLOADOPTIONS 并接受 CHECK_CONSTRAINTS 和 TABLOCK 等字符串选项。

注意注意
此属性的某些选项在“Excel 目标编辑器”中不可用，但可以使用“高级编辑器”进行设置。

OpenRowset

String

当 AccessMode 为 OpenRowset 时，OLE DB 目标访问的表或视图的名称。

OpenRowsetVariable

String

当 AccessMode 为 OpenRowset from Variable 时，包含 OLE DB 目标访问的表或视图名称的变量的名称。

SqlCommand

String

当 AccessMode 为 SQL 命令时，OLE DB 目标用于指定数据的目标列的 Transact-SQL 语句。

OLE DB 目标的输入和输入列没有自定义属性。

有关详细信息，请参阅 OLE DB 目标。

分区处理目标自定义属性

分区处理目标具有自定义属性和所有数据流组件通用的属性。

下表介绍分区处理目标的自定义属性。所有属性均可读/写。

属性

数据类型

说明

ASConnectionString

String

Analysis Services 项目或 Analysis Services 实例的连接字符串。

KeyDuplicate

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理重复键错误的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 IgnoreError (0)。

KeyErrorAction

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理键错误的值。可能的值为 ConvertToUnknown (0) 和 DiscardRecord (1)。此属性的默认值为 ConvertToUnknown (0)。

KeyErrorLimit

Integer

当 UseDefaultConfiguration 为 False 时，允许的键错误的上限。

KeyErrorLimitAction

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示达到 KeyErrorLimit 时要采取的操作的值。可能的值为 StopLogging (1) 和 StopProcessing (0)。此属性的默认值为 StopProcessing (0)。

KeyErrorLogFile

String

当 UseDefaultConfiguration 为 False 时，错误日志文件的路径和文件名。

KeyNotFound

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理缺少的键错误的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 ReportAndContinue (1)。

NullKeyConvertedToUnknown

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理转换为 Unknown 值的 null 键的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 IgnoreError (0)。

NullKeyNotAllowed

Integer（枚举）

当 UseDefaultConfiguration 为 False 时，指示如何处理禁止的 null 的值。可能的值为 IgnoreError (0)、ReportAndContinue (1) 和 ReportAndStop (2)。此属性的默认值为 ReportAndContinue (1)。

ProcessType

Integer（枚举）

转换使用的分区处理的类型。可能的值为 ProcessAdd (1)（增量）、ProcessFull (0) 和 ProcessUpdate (2)。

UseDefaultConfiguration

Boolean

一个指定转换是否使用默认错误配置的值。如果此属性为 False，则转换使用此表中列出的错误处理自定义属性的值，包括 KeyDuplicate 和 KeyErrorAction 等。

分区处理目标的输入和输入列没有自定义属性。

有关详细信息，请参阅分区处理目标。

原始文件目标自定义属性

原始文件目标具有自定义属性和所有数据流组件通用的属性。

下表介绍了原始文件目标的自定义属性。所有属性均可读/写。

属性名称

数据类型

说明

AccessMode

Integer（枚举）

一个值，指定 FileName 属性是包含文件名还是包含变量（包含文件名）名。选项为 File name (0) 和 File name from variable (1)。

FileName

String

原始文件目标要写入的文件的名称。

WriteOption

Integer（枚举）

一个指定原始文件目标是否删除具有相同名称的现有文件的值。选项为 Create Always (0)、Create Once (1)、Truncate and Append (3) 和 Append (2)。此属性的默认值为 Create Always (0)。
注意注意

追加操作要求追加数据的元数据与文件中已有数据的元数据匹配。

原始文件目标的输入和输入列没有自定义属性。

有关详细信息，请参阅原始文件目标。

记录集目标自定义属性

记录集目标具有自定义属性和所有数据流组件通用的属性。

下表介绍记录集目标的自定义属性。所有属性均可读/写。

属性名称

数据类型

说明

VariableName

String

包含 ADO 记录集的变量的名称。

记录集目标的输入和输入列没有自定义属性。

有关详细信息，请参阅记录集目标。

SQL Server Compact Edition 目标自定义属性

SQL Server Compact 目标具有自定义属性和所有数据流组件通用的属性。

下表介绍 SQL Server Compact 目标的自定义属性。所有属性均可读/写。

属性名称

数据类型

说明

TableName

String

SQL Server Compact 数据库中目标表的名称。

此属性的值可以使用属性表达式来指定。

SQL Server Compact 目标的输入和输入列没有自定义属性。

有关详细信息，请参阅 SQL Server Compact Edition 目标。

SQL Server 目标自定义属性

SQL Server 目标具有自定义属性和所有数据流组件通用的属性。

下表介绍 SQL Server 目标的自定义属性。所有属性均可读/写。

属性名称

数据类型

说明

AlwaysUseDefaultCodePage

Boolean

强制使用 DefaultCodePage 属性值。此属性的默认值为 False。

BulkInsertCheckConstraints

Boolean

一个值，指定大容量插入是否检查约束。此属性的默认值为 True。

BulkInsertFireTriggers

Boolean

一个值，指定大容量插入是否对表激发触发器。此属性的默认值为 False。

BulkInsertFirstRow

Integer

一个值，指定要插入的第一行。此属性的默认值为 -1，指示尚未分配值

BulkInsertKeepIdentity

Boolean

一个值，指定值是否可以插入到标识列。此属性的默认值为 False。

BulkInsertKeepNulls

Boolean

一个值，指定大容量插入是否可以保持 Null 值。此属性的默认值为 False。

BulkInsertLastRow

Integer

一个值，指定要插入的最后一行。此属性的默认值为 -1，指示尚未分配值。

BulkInsertMaxErrors

Integer

一个值，指定在大容量插入任务停止之前可以发生的错误数。此属性的默认值为 –1，表示尚未分配值。

BulkInsertOrder

String

排序列的名称。每一列都可以按升序或降序排序。如果使用了多个排序列，则使用逗号分隔列名称。

BulkInsertTableName

String

向其中复制数据的数据库中的 SQL Server 表或视图。

BulkInsertTablock

Boolean

一个值，指定大容量插入期间是否锁定表。此属性的默认值为 True。

DefaultCodePage

Integer

当数据源中的代码页信息不可用时要使用的代码页。

MaxInsertCommitSize

Integer

一个值，指定一批可以插入的最大行数。当值为零时，可一批插入所有的行。

Timeout

Integer

一个值，指定如果没有数据需要插入，SQL Server 目标终止前等待的秒数。值 0 表示 SQL Server 目标将不会超时。此属性的默认值为 30。

SQL Server 目标的输入和输入列没有自定义属性。

有关详细信息，请参阅 SQL Server 目标。