调度配置是配置节点在调度过程中的调度规则及依赖关系。本文为您介绍如何进行代码任务的调度配置。

前提条件

已完成代码任务的创建，详情请参见新建离线计算任务。

背景信息

  • 系统仅支持周期性节点的代码任务进行调度配置。
  • 依赖关系是两个或多个节点之间的语义连接关系，同时上游节点的状态将影响其他下游节点的运行状态。
  • 配置了依赖关系的节点调度规则为：首先，上游节点运行完成后，才能调度下游节点。其次，根据节点设定的调度时间判断是否执行调度。
  • 当您在设定的调度时间之前提交的调度配置，会在设定的调度时间之后生效。而在设定的调度时间之后配置的依赖关系，只能间隔一天再生成实例。

操作步骤

  1. 登录Dataphin控制台。
  2. 在Dataphin控制台页面，选择工作区地域后，单击进入Dataphin>>。
  3. 在Dataphin首页，单击顶部菜单栏的研发。
  4. 可选：在数据开发页面，单击项目名称后的test图标，选择数据开发的项目空间（Dev或Basic项目）。
    如果您当前访问的是Dev或Basic项目，且项目空间为您的数据开发空间，则不需要选择项目空间。
  5. 进入离线计算任务的调度配置页面。
    1. 在数据开发页面，单击数据处理。
    2. 在左侧导航栏中，单击ceg图标。
    3. 在离线计算任务页面，单击需要配置调度参数的代码任务。
    4. 可选：解锁代码。
      • 如果代码任务已被您自己锁定，则不需要解锁代码。
      • 如果代码任务已被他人锁定，则需要单击代码编写页面右上角的图标，解锁代码。
    5. 在该代码任务的代码编写页面，单击顶部的调度配置。
  6. 在调度配置页面，配置调度参数。
    1. 配置基本信息区域参数。
      系统自动生成的节点名称、节点ID、节点类型、负责人，不支持修改。fagag
      参数 描述
      描述 填写对调度配置的简单描述。
      优先级 您可以选择节点调度任务执行的优先级，优先级包括：
      • 最低优先级。
      • 低优先级。
      • 中等优先级。
      • 高优先级。
      • 最高优先级。
      参数配置 节点参数配置是对代码中所用参数的具体赋值。您可以单击节点参数配置说明，查看Dataphin调度系统支持配置节从而支持节点调度时，参数值以变量替换执行点的时间参数及配置原则，进行配置参数。
    2. 配置调度配置区域参数。
      fagaga
      参数 描述
      时间属性 选择时间属性。时间属性包括：
      • 正常调度：按照调度周期的时间配置调度，并正常执行，通常任务默认选中该项。
      • 空跑调度：按照调度周期的时间配置调度，但都是空跑执行，即一调度到该任务便直接返回成功，没有真正的执行任务。
      • 暂停调度：暂停调度后，会按照下面的调度周期时间配置调度，但是一旦调度到该任务会直接返回失败，不会执行。通常用于某个任务暂时不用执行，但后面还会继续使用的场景。
      调度周期 调度周期可选择日、周、 月、小时、分钟：
      • 日调度，即调度任务每天自动运行一次。新建周期任务时，系统默认的时间周期为每天0点运行一次。您可以根据需要，单击图标，指定运行的时间点。
      • 周调度，即调度任务每周的特定几天，在特定时间点自动运行一次。如果在没有被指定的日期时，为保证下游实例正常运行，系统会生成实例后直接设置为运行成功，而不会真正执行任何逻辑，也不会占用资源。
        例如，每周一、周二两天生成的实例会正常的调度执行，而周三、周四、周五、周六以及周日5天都是生成实例后直接设置为运行成功。gaga
      • 月调度，即调度任务在每月的特定几天，在特定时间点自动运行一次。如果在没有被指定的日期时，为保证下游实例正常运行，系统会每天生成实例后直接设置为运行成功，而不会真正执行任何逻辑，也不会占用资源。
        例如，调度系统会自动为任务生成实例并运行。每月7日生成的实例会正常的调度执行，其它日期每天都是生成实例并直接设为运行成功。gaga
      • 小时调度，即每天指定的时间段内，调度任务按间隔时间数的时间间隔运行一次。或选择指定的时间点，调度系统会自动为任务生成实例并运行。
        例如，每天00:00~23:59的时间段内，每隔1小时会自动调度一次，因此调度系统会自动为任务生成实例并运行。gaaga
      • 分钟调度，即每天指定的时间段内，调度任务按间隔时间数的时间间隔运行一次。
        例如，每天00:00~23:59的时间段内，每隔5分钟会自动调度一次，因此调度系统会自动为任务生成实例并运行。gagaga
      依赖上周期 根据业务场景分析是否需要选中依赖上周期。如果您选中了，则需要选择依赖上个调度周期的节点：
      • 如果您选择了当前，则表示依赖当前节点的上个调度周期。
      • 如果您选择了自定义，则需在输入框中输入依赖上周期节点的名称关键字进行搜索节点。
    3. 配置依赖关系区域参数。
      faga
      参数 描述
      开始解析 当节点的任务类型为SQL时，您可以单击开始解析，系统会解析代码中的表，并查找到与该表名相同的输出名称。输出名称所在的节点作为当前节点的上游依赖。
      如果代码中引用项目变量或不指定项目，则系统默认解析为生产项目名，以保证生成调度的稳定性。例如，开发项目名称为onedata_dev：
      • 如果代码里指定select * from s_order，则调度解析依赖为onedata.s_order。
      • 如果代码里指定select * from ${onedata}.s_order，则调度解析依赖为onedata.s_order。
      • 如果代码里指定select * from onedata.s_order，则调度解析依赖为onedata.s_order。
      • 如果代码里指定select * from onedata_dev.s_order，则调度解析依赖为onedata_dev.s_order。
      上游依赖 通过执行如下操作，完成添加该节点任务调度时依赖的上游节点：
      1. 单击新建上游依赖。
      2. 在新建上游依赖对话框中，您可以通过以下两种方式搜索依赖节点：
        • 输入所依赖节点的输出名称的关键字进行搜索节点。
        • 输入virtual搜索虚拟节点（每个租户或企业在初始化时都会有一个根节点）。
        说明 节点的输出名称是全局唯一的，且不区分大小写。
      3. 单击确定新增。
      同时您还可以单击操作列下的fagaga图标，删除已添加的依赖节点。
      当前节点 通过执行如下操作，设置当前节点的输出名称，根据需要您可以设置多个输出名称，供其他节点依赖使用：
      1. 单击新增。
      2. 在新增当前节点输出对话框中，填写输出名称。输出名称的命名规则请尽量统一，一般命名规则为生成项目名.表名且不区分大小写，以标识本节点产出的表，同时其他节点更好地选择调度依赖关系。

        例如，开发项目名称为onedata_dev，建议将输出名称设置为onedata.s_order。如果您将输出名称设置为onedata_dev.s_order，则仅限代码select * from onedata_dev.s_order能解析出上游依赖节点。

      3. 单击确定新增。
      同时您还可以对当前节点已添加的输出名称执行如下操作：
      • 单击操作列下的fagaga图标，删除已添加的输出名称。
      • 单击操作列下的图标，查看下游节点。
  7. 完成调度参数配置后，单击确定，完成代码任务的调度配置。