数据集配置
已发布的服务进行数据集配置后,通过执行定时调度或手工调度,即可将服务运行结果保存为数据集,后续无需再去调用API,可直接查询关系型数据库中的物理表获取结果。请注意,仅中“支持服务运行结果保存为数据集”为“是”的服务发布后才支持此项配置。
前提条件
已获取开发人员及以上权限用户的账号和密码。
配置数据集
- 登录LinkX-F系统首页。
- 选择,进入“聚合服务编排”页面。
- 单击目标服务“编码”链接,默认进入“服务定义”页签。
- 切换至“数据集配置”页签,配置数据集任务参数,如表1所示:
表1 配置参数说明 参数
说明
API请求信息
是否需要分页
必填。取值“是”或“否”,默认选“是”。
- 选“是”:需配置“分页字段”和“分页大小字段”。系统执行API时将触发分页执行逻辑,分页字段按规则自动累加,直至查询结果为空,建议配置每页查询条数为10条。
- 选“否”:则隐藏字段“分页字段”和“分页大小字段”。系统执行API时采用不分页模式。
分页字段
如果“是否需要分页”选“是”时,该字段才显示且为必填项,默认写入pageNumber。
分页大小字段
如果“是否需要分页”选“是”时,该字段才显示且为必填项,默认写入pageSize。
是否需要设置时间
非必填,如果选“是”则表示是增量集成数据,还需填写“开始时间字段”和“结束时间字段”。
开始时间字段
如果“是否需要设置时间”选“是”时,该字段为必填项。在下拉框中选择API的入参。
结束时间字段
如果“是否需要设置时间”选“是”时,该字段为必填项。在下拉框中选择API的入参。
请求参数
必填。支持新增、删除、修改请求参数或测试请求 。
目标端信息
数据源类型
保持默认,暂不支持修改。
数据源名称
必填,来源于中的数据。
Schema
必填,选择“数据源名称”后自动写入。
物理表
必填,用户手动填写,支持模糊匹配。
选择约束组
非必填,即所选物理表的主键约束字段;调度时如果所选约束字段的值在表中已存在,则更新数据,否则将插入数据。
配置Mapping信息:支持自动Mapping或手动新增Mapping信息。
说明:自动Mapping时源端与目标端自动写入字段名,不区分大小写。使用条件需满足源端字段名与目标端字段名一致。
API出参
非必填,取API出参。
数据集字段
必填,根据选择的物理表,下拉值被自动写入。
- 填写完后单击“保存”。
配置定时调度
- 登录LinkX-F系统首页。
- 选择,进入“聚合服务编排”页面。
- 您可参照以下任一方式进入定时调度配置页面:
- 单击目标服务“编码”链接,在弹出的详情页切换至“数据集配置”页签,在页面底部单击“定时调度”。
- 单击目标服务“操作”列处的“定时调度”。
- 配置定时调度参数,如表2所示:
表2 定时调度配置参数 参数
说明
调度周期
分为:分、时、天、周、月。
间隔时间
根据设置的调度周期选择间隔时间数值。
调度时间说明
执行频率说明。例如设置调度周期为分,间隔时间数值设置为5,代表每5分钟执行一次调度。
调度首次执行时间
必填,首次执行时间不能早于当前时间,确保调度计划能够正常运行。
调度截止执行时间
必填。截止执行时间不能早于首次执行时间,默认为空表示无限期。
数据起始时间
调用API时,系统将以该值作为起始时间,按照增量方式获取数据。
当表1中的“是否需要设置时间”为“是”时必填。
上次调度数据时间
上一次的调度数据时间。
- 配置完后单击“保存”,定时调度计划制定成功。
- 单击“启动”,启动定时调度。
定时调度启动后,“定时调度状态”自动更新为“已启动”。
- 已启动的定时调度支持暂停和停止,具体操作如下。
表3 暂停/停止定时调度 操作
说明
暂停定时调度
单击“暂停”,“定时调度状态”自动更新为“已暂停”。
已暂停的定时调度不可修改。如有需要,单击“启动”后继续执行原调度计划。
停止定时调度
单击“停止”,“定时调度状态”自动更新为“未启动”。
已停止的定时调度支持再次启动。
配置手工调度
- 登录LinkX-F系统首页。
- 选择,进入“聚合服务编排”页面。
- 您可参照以下任一方式进入手工调度配置页面:
- 单击目标服务“编码”链接,在弹出的详情页切换至“数据集配置”页签,在页面底部单击“手工调度”。
- 单击目标服务“操作”列处的“手工调度”。
- 根据页面提示操作启动手工调度,可能出现以下情况:
- 如果“需要设置时间”选“是”,在弹窗中设置“数据起止时间”后,单击“确定”立即执行。
- 如果“需要设置时间”选“否”,根据弹窗提示单击“确定”启动调度。
查看调度日志
系统会自动清理超过7天的调度日志,如果7天内没有调度记录,则会保留最后一天的调度日志。
- 登录LinkX-F系统首页。
- 选择,进入“聚合服务编排”页面。
- 您可参照以下任一方式进入调度日志页面:
- 单击目标服务“编码”链接,在弹出的详情页切换至“数据集配置”页签,单击“调度日志”。
- 单击目标服务后“操作”列处的“调度日志”。
- 在调度日志页面,您可以:
- 查询调度日志:在“条件筛选”处输入或选择常用查询条件,单击“搜索”。
- 查看失败原因:单击具体日志“调度执行状态”后的
,查看具体失败原因。