字段配置

1 概述

1.1 版本

1.2 应用场景

如果只是对数据进行格式转换、空值使用特定值进行填充等操作，可以使用【字段配置】组件实现。

1.3 业务场景

数据库字段标准化：将业务字段映射到标准字段，确保数据储存与展示的一致性，如：在业务规则尚未明确的阶段，通过配置字段快速搭建表单，将“客户编号”重命名为“客户ID”，“订单日期”字符串转为日期类型。

1.4 功能简介

【字段配置】可对上一个节点数据源字段进行重命名、数据类型转换、缺省值设置等操作。

2 功能说明

【字段配置】设置包括：配置和数据预览。

“配置”tab支持的功能包括：字段配置和数据预览。

1、字段配置

连接上游节点后，若上游节点有输出字段，则此处会自动列出所有的输出字段，用户可按需对输出字段的字段名称变更、数据类型转换、缺省值的配置。如下图：

• 字段名称变更后，最终输出的字段名称将更改为修改后的名称；
• 字段类型设置转换时，执行时原始字段数据将根据设置的字段类型转换为对应的值进行显示；
• 缺省值配置仅对字段的值为空或空字符串时，统一填充为设置的缺省值。

当数据类型转换为“Date”时，可配置日期格式，支持四种格式：yyyy-MM-dd 、yyyy-MM-dd HH:mm:ss、yyyyMMdd、yyyyMMddHHmmss，最终数据将按照对应的日期格式进行显示。

比如：上图，将“订购日期”和“发货日期”字段由“timestamp”类型更改为“Date”，并将日期格式设置为“yyyy-MM-dd”.

2、数据预览

字段配置好后，点击“数据预览”，将根据设置对原数据进行对应的处理显示最终的处理结果，如下图：

设计时只采样 1000 条数据进行计算，避免数据量过大导致服务器压力大，实际运行时会根据实际条数来进行计算。
若取数异常，将显示错误信息，协助用户快速定位出错原因并修正。

3 字段类型转换限制

字段类型进行转换时，有些类型之间是不允许转换的，最终执行会报错，具体规则如下：

• 所有字段类型都支持转为String类型;
• 仅String类型支持转为Binary类型;
• 仅String（true/false）、Int(0/1)和Long(0/1)类型支持转为Boolean类型;
• 仅String和long类型支持转为Date类型;
• Binary、Date类型不支持转为Double类型、Float类型、Integer类型和Decimal类型；
• String、Binary和Date类型的数值范围要在-128-127，才支持转为Byte类型；
• Binary类型不支持转为Long类型；
• String类型转为数值类型时，如果String非纯数值，也不支持转换。