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