自动更新(更新/清理)

1. 概述

1.1 功能概述

通过为数据模型配置运行计划，系统将按照预设的时间周期自动执行数据刷新，实现定时、精准的数据同步。支持以下模式：

• 全量更新： 完整更新所有数据

• 增量更新： 仅同步新增/变更数据

• 更新操作： 定向更新或清理特定数据

本文重点讲解数据更新操作（更新/清理），全量更新与增量更新功能请参阅对应章节。

2.操作步骤

2.1 前提条件

1. 运行计划设置： 管理员已在系统后台配置好对应的运行计划模版。

2. 模型状态： 抽取模型目标表增量抽取属性已配置并已保存模型。

   type=info

   注意： 若需启用自动更新/清理功能，抽取模型的增量抽取属性必须配置为数据源原始表中的日期/日期时间类型自增字段（例如：create_time、order_date等）。如下图所示（以订单表为例），将增量抽取属性设置为订购日期字段：

   
   

2.2 操作步骤

步骤一：进入文档详情页面

1. 文档门户，单击「我的分析>数据模型」，选择抽取模型（这里以抽取模型Test为例），单击基本信息按钮进入文档详情。

   
   

步骤二：添加运行计划

1. 进入文档详情页面，选择运行计划，单击添加计划。

   
   

步骤三： 设置运行计划名称

1. 设置运行计划名称，不可为空。

   
   

步骤四：选择设置表为更新抽取模式

1. 勾选目标表，设置表名称后的抽取模式为更新（新加的模型表或未设置增量抽取模型的表重新抽取模型时默认为全量模式）。

   单击按钮开启属性面板，支持：

• 更新指定时间至今的数据

• 清理指定时间之前的数据

• 支持日期表达式快捷输入，可根据实际业务需求，灵活调整

  日期类型	表达式
  昨天	DateAdd(Day , -1 , getDate())
  本月	DateFromParts(Year(getDate()) , Month(getDate()) , 1)
  上月一日	DateFromParts(Year(DateAdd(Month , -1 , getDate())) , Month(DateAdd(Month , -1 , getDate())) , 1)
  一月前	DateAdd(Month , -1 , getDate())
  本季度	DateFromParts(Year(getdate()) , ((Month(getdate()) - 1) / 3) * 3 + 1 , 1)
  本年	DateFromParts(Year(getdate()) , 1 , 1)
  一年前	DateAdd(Year , -1 , getDate())

  
  

步骤五：设置执行方式

1. 执行方式有两种：执行一次和定时执行。

   
   

   执行方式说明：

   执行方式	功能说明
   执行一次	根据开始时间立即执行任务，运行结束后自动清理运行计划记录
   定时执行	基于预定义的运行计划模板或自定义模版，定时循环执行

步骤六：定时执行配置重复周期

1. 执行方式选择定时执行时，支持两种设置循环周期的方式：使用模板或自定义。两种模式需要根据系统管理员是否开启允许用户创建自定义运行计划来进行显示，未开启时用户仅能选择现有模板，开启后可自定义计划或使用模板。运行计划模版的创建请参考数据源/数据集/数据模型运行计划模板 。

   说明：

   配置状态	模板类型	示例图	说明
   未开启自定义计划功能	使用已有运行计划模版		在选择模板下拉列表中选择需要的模板，无需设置循环周期
   已开启自定义计划功能	使用已有运行计划模版		如勾选使用模板复选框，则无需设置循环周期，在模板下拉列表中选择需要的模板即可
   	自定义运行计划模版		如不勾选使用模板，则需自定义运行计划的循环周期。循环周期的定义方法与抽取模型运行计划模板一致，请参见模板中的介绍数据源/数据集/数据模型运行计划模板

   type=info

   提示：

   1）有关系统管理员如何开启允许用户创建自定义运行计划功能，请见门户外观设置中相关介绍。

   2）如果管理员在后台管理中开启了允许用户创建自定义运行计划功能，但是没有可用的模板，此处也将不显示使用模板复选框。

步骤七：配置消息通知方式

1. 默认只能使用邮件通知方式进行发送，如果想要使用应用消息通知，需使用系统管理员账号登录 Wyn ，依次单击「系统管理>系统设置>通知中心」，提前配置好需要的应用程序（详见通知中心设置）。

   
   

   
   

• 注意：

  • 如需使用邮件通知，请使用系统管理员账号登录 Wyn ，确认「系统管理>系统设置>通知中心」下的的邮件设置已成功配置，否则无法发送通知邮件。

步骤八： 创建计划

1. 抽取模型运行计划配置完成后，单击下方的创建计划按钮，完成创建。

   
   

2. 已添加的计划会在运行计划列表中列出，您可以通过单击右侧的，禁用、编辑、删除计划。

   
   

3. 运行计划会根据配置的时间自动执行。

2.3 成果展示

1. 如图展示将抽取模型的增量属性设为createdate字段，并参照步骤八配置运行计划（同时启用更新与清理功能）的实际效果。

   
   

3. 注意事项

1. 单次执行模式： 任务成功完成后将自动移除。

2. 异常处理机制： 执行失败时，系统将自动发送告警至预设邮箱/应用消息如果执行方式选择执行一次。

3. 模式切换： 已配置增量抽取的模型表，仍可在重新抽取或运行计划配置时切换为全量模式。

4. 限制说明： 模型中的自定义表不支持增量更新，且自定义字段不可作为增量抽取属性。