平面文件源

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

平面文件源从文本文件中读取数据。 文本文件可以为带分隔符格式、固定宽度格式或混合格式。

  • 带分隔符格式使用列和行分隔符定义列和行。

  • 固定宽度格式使用宽度定义列和行。 此格式还包含一个用于将字段填充到其最大宽度的字符。

  • 右边未对齐格式使用宽度定义除最后一列的所有列,最后一列由行分隔符分隔。

可以按照下列方式配置平面文件源:

  • 将一个列添加到转换输出(此转换输出包含平面文件源从中提取数据的文本文件的名称)中。

  • 指定平面文件源是否将列中长度为零的字符串解释为空值。

    注意

    若要将长度为零的字符串解释为空值,平面文件源使用的平面文件连接管理器必须配置为使用带分隔符格式。 如果连接管理器使用固定宽度或右边未对齐格式,那么由空格组成的数据便无法解释为空值。

平面文件源输出中的输出列包含 FastParse 属性。 FastParse 指示该列是使用 Integration Services 提供的速度较快但不区分区域设置的较快分析例程,还是使用区分区域设置的标准分析例程。 有关详细信息,请参阅 Fast ParseStandard Parse

输出列还包含 UseBinaryFormat 属性。 使用该属性可在文件中实现对二进制数据(如带有组合型十进制格式的数据)的支持。 默认情况下 UseBinaryFormat 设置为 false。 如果要使用二进制格式,请将 UseBinaryFormat 设置为 true ,并将输出列的数据类型设置为 DT_BYTES。 执行上述操作时,平面文件源将跳过数据转换并将数据原样传递到输出列。 然后,可以使用“派生列”或“数据转换”等转换将 DT_BYTES 数据转换为不同的数据类型,或者在脚本转换中编写自定义脚本来解释数据。 也可以编写自定义数据流组件来解释数据。 有关可将 DT_BYTES 转换为哪些数据类型的详细信息,请参阅转换(SSIS 表达式)

此源使用平面文件连接管理器访问文本文件。 通过设置平面文件连接管理器的属性,可以提供关于文件和文件中每列的信息,并可以指定平面文件源应如何处理文本文件中的数据。 例如,可以指定文件中分隔列和行的字符,以及每列的数据类型和长度。 有关详细信息,请参阅 Flat File Connection Manager

此源具有一个输出和一个错误输出。

平面文件源的配置

可以通过 SSIS 设计器或以编程方式来设置属性。

“高级编辑器” 对话框反映了可以通过编程方式进行设置的属性。 有关可以在 “高级编辑器” 对话框中或以编程方式设置的属性的详细信息,请单击下列主题之一:

有关如何设置数据流组件属性的详细信息,请参阅 设置数据流组件属性

平面文件源编辑器(“连接管理器”页)

可以使用 “平面文件源编辑器” 对话框的 “连接管理器” 页,选择平面文件源将使用的连接管理器。 平面文件源从文本文件中读取数据,文本文件可以采用分隔符分隔、固定宽度或混合格式。

平面文件源可以使用下列类型的连接管理器之一:

  • 如果源是单个平面文件,则使用平面文件连接管理器。 有关详细信息,请参阅 Flat File Connection Manager

  • 如果源是多平面文件并且数据流任务在循环容器(例如 For 循环容器)内,则使用多平面文件连接管理器。 在容器的每个循环中,平面文件源从多平面文件连接管理器提供的下一个文件名加载数据。 有关详细信息,请参阅 Multiple Flat Files Connection Manager

选项

平面文件连接管理器
从列表中选择现有的连接管理器,或单击“新建”创建新的连接管理器。

新建
通过使用“平面文件连接管理器编辑器”对话框创建新的连接管理器。

在数据流中保留源中的空值
指定提取数据时是否保留空值。 此属性的默认值为 false。 如果此值 为 false,平面文件源会将源数据中的 null 值替换为每个列的相应默认值,例如字符串列的空字符串和数值列的零。

预览
通过使用“数据视图” 对话框预览结果。 预览最多可以显示 200 行。

平面文件源编辑器(“列”页)

可以使用“平面文件源编辑器”对话框的“列”节点,将输出列映射到每个外部(源)列。

注意

平面文件源的 FileNameColumnName 属性及其输出列的 FastParse 属性未在 “平面文件源编辑器”中提供,但可以使用 “高级编辑器”进行设置。 有关这些属性的详细信息,请参阅 Flat File Custom Properties的“平面文件源”部分。

选项

可用外部列
查看数据源中可用外部列的列表。 无法使用此表添加或删除列。

“外部列”
按任务读取外部(源)列的顺序查看这些列。 首先清除表中所选的列,然后以不同的顺序从列表中选择外部列,即可更改顺序。

输出列
为每个输出列提供唯一的名称。 默认值为所选外部(源)列的名称;不过,您也可以任选一个唯一的描述性名称。 所提供的名称将在 SSIS 设计器中显示。

平面文件源编辑器(“错误输出”页)

可以使用“平面文件源编辑器”对话框的“错误输出”页选择错误处理选项,以及设置错误输出列的属性。

选项

输入/输出
查看数据源的名称。


查看您在“平面文件源编辑器”对话框的“连接管理器”页面上选择的外部(源)列。

错误
指定发生错误时应执行的操作:忽略失败、重定向行或使组件失败。

相关主题:数据中的错误处理

截断
指定发生截断时应执行的操作:忽略失败、重定向行或使组件失败。

说明
查看对错误的说明。

将此值设置到选定的单元格
指定发生错误或截断时应对所有选定单元格执行的操作:忽略失败、重定向行或使组件失败。

应用
将错误处理选项应用到选定的单元格。

另请参阅

平面文件目标
数据流