导出列转换
适用于:SQL Server Azure 数据工厂中的 SSIS Integration Runtime
导出列转换读取数据流中的数据,并将数据插入到文件中。 例如,如果数据流包含产品信息(如每件产品的图片),则可使用导出列转换将图像保存到文件中。
追加和截断选项
下表说明了追加和截断选项的设置如何影响结果。
Append | Truncate | 文件存在 | 结果 |
---|---|---|---|
False | False | 否 | 该转换将创建一个新文件并将数据写入到该文件中。 |
True | False | 否 | 该转换将创建一个新文件并将数据写入到该文件中。 |
False | True | 否 | 该转换将创建一个新文件并将数据写入到该文件中。 |
True | True | 否 | 该转换的设计时验证失败。 将两个属性都设置为 true是无效的。 |
False | False | 是 | 发生运行时错误。 文件存在,但转换无法写入到文件中。 |
False | True | 是 | 转换将删除文件,然后重新创建文件并将数据写入到文件中。 |
True | False | 是 | 转换将打开文件并将数据写入到文件末尾。 |
True | True | 是 | 该转换的设计时验证失败。 将两个属性都设置为 true是无效的。 |
导出列转换的配置
可以按照下列方式配置导出列转换:
指定数据列和包含要向其写入数据的文件的路径的列。
指定数据插入操作是追加还是截断现有文件。
指定是否将字节顺序标记 (BOM) 写入到文件中。
备注
仅在不将数据追加到现有文件且数据具有 DT_NTEXT 数据类型时写入 BOM。
此转换使用成对的输入列:一列包含文件名,另一列包含数据。 数据集中的每一行都可指定一个不同的文件。 转换在处理行时,数据将插入到指定的文件中。 在运行时,如果这些文件不存在,转换将创建这些文件,然后将数据写入到文件中。 要写入的数据必须具有 DT_TEXT、DT_NTEXT 或 DT_IMAGE 数据类型。 有关详细信息,请参阅 Integration Services 数据类型。
此转换有一个输入、一个输出和一个错误输出。
可以通过 SSIS 设计器或以编程方式来设置属性。
“高级编辑器” 对话框反映了可以通过编程方式进行设置的属性。 有关可以在 “高级编辑器” 对话框中或以编程方式设置的属性的详细信息,请单击下列主题之一:
有关如何设置属性的详细信息,请参阅 设置数据流组件的属性。
导出列转换编辑器(“列”页)
可以使用 “导出列转换编辑器” 对话框的 “列” 页,指定数据流中要提取到文件的列。 可以指定导出列转换是将数据追加到文件还是覆盖现有文件。
选项
提取列
从包含文本数据或图像数据的输入列的列表中进行选择。 所有行都应包含 “提取列” 和 “文件路径列”的定义。
“文件路径列”
从包含文件路径和文件名的输入列的列表中进行选择。 所有行都应包含 “提取列” 和 “文件路径列”的定义。
允许追加
指定转换是否将数据追加到现有文件。 默认值为 false。
强制截断
指定转换在写入数据之前是否删除现有文件的内容。 默认值为 false。
写入 BOM
指定是否将字节顺序标记 (BOM) 写入文件。 只有在数据具有 DT_NTEXT 或 DT_WSTR 数据类型,并且未将数据追加到现有数据文件时,才会写入 BOM。
导出列转换编辑器(“错误输出”页)
可以使用 “导出列转换编辑器” 对话框的 “错误输出” 页指定错误的处理方式。
选项
输入/输出
查看输出的名称。 单击名称可以展开视图以包括列。
列
查看在“导出列转换编辑器”对话框的“列”页中选择的输出列。
错误
指定发生错误时要执行的操作:忽略失败、重定向行或使组件失败。
截断
指定发生截断时要执行的操作:忽略失败、重定向行或使组件失败。
说明
查看操作的说明。
将此值设置到选定的单元格
指定发生错误或截断时应对所有选定单元格执行的操作:忽略失败、重定向行或使组件失败。
应用
将错误处理选项应用到选定的单元格。