文件输出

1 概述

1.1 版本

1.2 应用场景

• 用户希望将加工后的数据以文件形式分享给业务人员直接查看使用。
• 银行体系下，不允许直连数据库或开放接口，需要以文件形式下发数据给其他关联业务系统使用。
• 政企分享数据的过程中，需要将数据以文件形式留档。
• 对接部分大数据数据源时，需要 FDL 写数据文件，然后数据源通过读取文件的形式高速装载数据。
• 输出数据到自定义类型文件，单行单列的 XML/JSON 格式数据可直接原样输出为对应文件供后续的操作。

「文件输出」组件可满足上述场景。

1.3 功能简介

「文件输出」组件用于将流程中上游节点（如 DB 输入、数据集输入、Python 输入等）的处理结果，以指定格式文件的形式，输出并存储至OSS对象存储服务中。该组件支持灵活配置文件存储路径、格式与编码，是实现数据导出、备份、跨系统数据传输的关键工具。

2 前置准备

• 存储资源准备：已在阿里云开通 OSS 服务，创建用于存储输出文件的Bucket，并获取该 Bucket 的访问权限配置。
• 数据连接配置：已在系统中创建并测试通过OSS 数据连接（包含 Endpoint、AccessKey 等核心信息）。
• 上游数据就绪：流程中已配置上游数据输入节点（如 DB 输入），且该节点能正常输出待导出的数据集。
• 权限确认：拥有OSS Bucket 的写入权限。

3 功能说明

设置界面如下图：

主要包含文件目标、文件类型、对应类型的格式配置以及输出字段等配置。具体说明如下：

3.1 文件目标

文件输出的位置。可将文件输出到 OSS 中。
需要指定存放的OSS服务，下拉可选的服务为系统中添加的所有OSS，选择OSS后指定对应存放的bucket即可。
选择之后，可点击“测试连接”验证该服务是否能正常连接，若能正常使用，即可将文件输出到对应的服务地址下。

3.2 文件类型

支持数据输出为 CSV类型的文件。

3.3 返回配置

1）文件地址：选择文件输出目录，支持引用表达式，允许为空，为空是则存放到根目录。
2）文件名称：填写文件名称，支持引用表达式，文件名后缀支持自定义，可输入：txt、log、tsv等，不区分字母大小写。如下图所示：

3）列分隔符：支持的分隔符包括：英文逗号(,)、制表符(\t)、英文分号(;)、管道符(|)、空格( )。

根据指定的列分隔符，分隔数据为多列。
4)行分隔符：指定 CSV 文件中的行分隔符

• CR+LF（在 Windows 系统中使用）
• LF（在 Unix、Linux 等系统中使用）
• CR（在早期的 Mac OS 系统中使用）
  

5）文本限定符：用于标识数据值的开始和结束，以避免数据中包含的特殊字符干扰 CSV 文件的解析。支持的文本限定符如下：

6）编码：指定 CSV 文件编码。编码可选择 GBK、BIG5、ISO-8859-1、UTF-8、UTF-16、GB2312。

7）首行输出字段名：开启时，将字段名写入文件第一行；不开启时，则直接将数据写入文件第一行。

3.4 输出字段

选择上游结果需要输出的字段，默认全部字段均输出，指定字段后将仅输出对应字段的数据。

4 注意事项

1、路径与命名规范：文件地址建议按「业务模块 / 日期 /」的层级设计（如sms/backup/20260303/），便于文件分类管理与追溯；文件名称避免包含特殊字符（如 @、#、空格）。
2、数据连接有效性：确保 OSS 数据连接的 AccessKey 拥有写入权限，否则会导致文件输出失败。
3、大文件处理：若导出数据量过大，建议分批次输出，避免因单次导出数据过多导致流程执行超时。
4、格式兼容性：若下游系统对 CSV 格式有特殊要求（如使用制表符分隔），需提前调整「列分隔符」「文本限定符」等参数，避免数据解析异常。
5、编码一致性：统一使用 UTF-8 编码，避免因编码不匹配导致导出文件出现乱码，尤其是包含中文的业务数据。