文件连接管理器

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

文件连接管理器使包可以在运行时引用现有的文件或文件夹,或者创建文件或文件夹。 例如,您可以引用 Excel 文件。 Microsoft SQL Server Integration Services 中的某些组件使用文件中的信息来执行其工作。 例如,执行 SQL 任务可以引用包含该任务执行的 SQL 语句的文件。 其他组件对文件执行操作。 例如,文件系统任务可以引用一个文件,以便将其复制到新的位置。

文件连接管理器的使用类型

文件连接管理器的 FileUsageType 属性指定如何使用文件连接。 文件连接管理器可以创建文件、创建文件夹、使用现有文件或使用现有文件夹。

下表列出了 FileUsageType的值。

说明
0 文件连接管理器使用现有文件。
1 文件连接管理器创建文件。
2 文件连接管理器使用现有文件夹。
3 文件连接管理器创建文件夹。

多个文件或文件夹连接

文件连接管理器只能引用一个文件或文件夹。 若要引用多个文件或文件夹,请使用多文件连接管理器,而不是文件连接管理器。 有关详细信息,请参阅 Multiple Files Connection Manager

文件连接管理器的配置

将文件连接管理器添加到包时, Integration Services 会创建将在运行时解析为文件连接的连接管理器,设置该文件连接的属性,并将该文件连接添加到包的 Connections 集合。

该连接管理器的 ConnectionManagerType 属性设置为 FILE

可以用下列方式配置文件连接管理器:

  • 指定使用类型。

  • 指定文件或文件夹。

通过在 SQL Server Data Tools (SSDT)的“属性”窗口中指定表达式,可以设置文件连接管理器的 ConnectionString 属性。 但为了避免在使用表达式指定文件或文件夹时出现验证错误,请在“文件连接管理器编辑器”中,为“文件/文件夹”添加文件或文件夹路径。

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

有关可以在 SSIS 设计器中设置的属性的详细信息,请参阅 文件连接管理器编辑器

有关以编程方式配置连接管理器的信息,请参阅 ConnectionManager以编程方式添加连接项目。

文件连接管理器编辑器

可以使用 “文件连接管理器编辑器” 对话框指定用于连接文件或文件夹的属性。

注意

通过在 SQL Server Data Tools (SSDT)的“属性”窗口中指定表达式,可以设置文件连接管理器的 ConnectionString 属性。 但为了避免在使用表达式指定文件或文件夹时出现验证错误,请在“文件连接管理器编辑器”中,为“文件/文件夹”添加文件或文件夹路径。

若要了解有关文件连接管理器的详细信息,请参阅 File Connection Manager

选项

使用类型
指定“文件连接管理器”是连接到现有文件或文件夹,还是创建新的文件或文件夹。

描述
创建文件 在运行时创建新文件。
现有文件 使用现有文件。
创建文件夹 在运行时创建新文件夹。
现有文件夹 使用现有文件夹。

文件/文件夹
对于“文件”,请指定要使用的文件。

对于 “文件夹”,请指定要使用的文件夹。

“浏览”
通过使用“选择文件”或“查找文件夹”对话框选择文件或文件夹。

“添加文件连接管理器”对话框 UI 参考

可以使用 “添加文件连接管理器” 对话框定义与一组文件或文件夹的连接。

若要了解有关多文件连接管理器的详细信息,请参阅 Multiple Files Connection Manager

注意

Integration Services 中的内置任务和数据流组件不使用多文件连接管理器。 但是,可以在脚本任务或脚本组件中使用此连接管理器。

“添加文件”连接管理器的对话框选项

使用类型
指定要用于多个文件连接管理器的文件类型。

说明
创建文件 连接管理器将创建文件。
现有文件 连接管理器将使用现有文件。
创建文件夹 连接管理器将创建文件夹。
现有文件夹 连接管理器将使用现有文件夹。

文件/文件夹
查看使用下面介绍的按钮所添加的文件或文件夹。

添加
通过使用“选择文件”对话框添加文件,或者通过使用“查找文件夹”对话框添加文件夹。

编辑
选择一个文件或文件夹,再通过使用“选择文件”或“查找文件夹”对话框,将其替换为另一个文件或文件夹。

删除
选择一个文件或文件夹,再通过使用“删除”按钮将其从列表中删除。

箭头按钮
选择一个文件或文件夹,再使用箭头按钮将它上移或下移以指定访问顺序。

“提供列类型建议”对话框 UI 参考

可以使用 “提供列类型建议” 对话框,根据文件内容抽样指定平面文件连接管理器中的列的数据类型和长度。

若要了解有关 Integration Services使用的数据类型的详细信息,请参阅 Integration Services 数据类型

建议列类型的对话框选项

行数
键入或选择算法使用的示例中的行数。

建议使用最小整数数据类型
清除此复选框可以略过评估。 选中此复选框之后,将为包含整型数字数据的列确定可能的最小整型数据类型。

建议使用最小的实型数据类型
清除此复选框可以略过评估。 选中此复选框之后,将确定包含实型数字数据的列是否可以使用较小的实型数据类型 DT_R4。

使用下列值标识布尔值列
键入要用作布尔值 True 和 False 的两个值。 两个值必须用逗号分隔,并且第一个值代表 True。

填充字符串列
选中此复选框,可以启用字符串填充。

填充百分比
对于字符数据类型的列,键入或选择列长度增加的百分比。 百分比必须为整数。

Integration Services 错误和消息引用