应启用整数类型强制映射:在REST_API数据源的「字段类型映射」中添加规则,指定字段名、目标类型为【long】并勾选“是否启用强转”;若原始响应已是42.0则需上游修改。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

火山引擎配置REST_API数据源时,JSON响应中本应为整数的字段被解析成浮点数(如42变成42.0),导致下游任务报类型不匹配错误。
确认API原始响应是否含小数点
用curl或Postman直接请求你的api url,观察原始返回体中目标字段值:如果已是42.0而非42,说明问题在源端,火山引擎无法修正——必须联系上游服务改返回格式。
若原始响应是42,但火山引擎任务日志里显示42.0,则进入下一步配置。
在数据源参数配置中启用整数类型强制映射
编辑已创建的rest_api数据源 → 进入「参数配置」区域 → 找到「字段类型映射」高级选项(默认折叠)→ 展开后点击「添加映射规则」。
填写以下内容:
字段名:输入JSON中该整数字段的精确key名(区分大小写,如user_id);
目标类型:下拉选择【long】;
是否启用强转:勾选。
注意:此映射仅对当前数据源下的所有任务生效,不会修改原始JSON结构。未配置映射的字段仍按默认规则推断(数字类默认为double)。
验证字段类型是否生效
步骤一:新建一个临时批式读取任务,数据源选刚配置好的rest_api源。
步骤二:在任务SQL中执行SELECT typeof(字段名) FROM 表名 LIMIT 1。
步骤三:运行任务,查看结果——若返回long而非double,说明映射成功。
若仍为double,请检查字段名拼写是否与JSON实际key完全一致,包括下划线、大小写、缩写等细节。











