计算任务顶部注释

本文为您介绍如何自定义创建计算任务时的顶部注释。

各类计算引擎支持的计算任务类型

  • 支持编辑的SQL计算任务类型基于当前租户所使用的离线计算引擎。

  • FLINK_SQLFLINK_DATASTREAM类型与离线计算引擎无关,若当前租户已绑定实时计算引擎,即可进行编辑。

  • SHELL、PYTHON、VIRTUAL类型与计算引擎无关。

计算任务类型

计算引擎类型

MAX_COMPUTE_SQL

MaxCompute

SPARK_JAR_ON_MAX_COMPUTE

MaxCompute

MAX_COMPUTE_MR

MaxCompute

FLINK_SQL、FLINK_DATASTREAM

与离线计算引擎无关,需绑定实时计算引擎。

SHELL、PYTHON、VIRTUAL

与计算引擎无关。

操作步骤

  1. Dataphin首页的顶部菜单栏中,选择管理中心 > 规范设置

  2. 在左侧导航栏中选择研发规约 > 计算任务顶部注释

  3. 单击编辑,可自定义当前租户计算引擎支持的各个计算任务类型的代码顶部注释。各类型计算任务顶部注释的默认值详情请参见各类型计算任务顶部注释的默认值

    可使用的系统变量有:

    • ${author}:新建计算任务时,登录用户的用户名。

    • ${createTime}:新建计算任务时的时间,格式为yyyy-MM-dd HH:mm:ss

    • ${taskType}:新建计算任务时的任务类型,取值与新建菜单的任务类型名称一致。

    • ${dbType}:新建数据库SQL任务时,所选数据库的类型,取值与数据库类型下拉列表一致。

    • ${comment}:新建任务时的描述。

  4. 编辑完成后,单击保存

各类型计算任务顶部注释的默认值

SQL

  • 简体中文环境中默认值如下。

    —${taskType}
    --********************************************************************--
    --所属主题: 数据属于哪个数据域或业务场景下---如交易域、运营数据报表
    --功能描述: 数据记录的描述,如数据是什么、统计粒度等
    --创建者: ${author}
    --创建日期: ${createTime}
    --修改日期     修改人     修改内容
    --yyyymmdd     name     comment
    --********************************************************************--
  • 繁体中文、英文环境中默认值为空。

PYTHON

简体中文、繁体中文、英文环境中默认值均相同。

#!/usr/bin/env python
# -*- coding: utf-8 -*-
################################################
# Author: ${author}
# Created Time: ${createTime}
################################################
#===============================================

数据库SQL

  • 简体中文环境中默认值如下。

    —数据库SQL
    --********************************************************************--
    --所属主题: 数据属于哪个数据域或业务场景下---如交易域、运营数据报表
    --功能描述: 数据记录的描述,如数据是什么、统计粒度等
    --创建者: ${author}
    --创建日期: ${createTime}
    --修改日期     修改人     修改内容
    --yyyymmdd     name     comment
    --********************************************************************--
  • 繁体中文、英文环境中默认值为空。

FLINK_SQL

  • 简体中文环境中默认值如下。

    --Stream SQL
    --********************************************************************--
    --Author: ${author}
    --CreateTime: ${createTime}
    --Comment: ${comment}
    --********************************************************************--
  • 繁体中文、英文环境中默认值为空。

FLINK_DATASTREAM

  • 简体中文环境中默认值如下。

    --DataStream 
    --********************************************************************--
    --Author: ${author}
    --CreateTime: ${createTime}
    --Comment: ${comment}
    --********************************************************************--
  • 繁体中文、英文环境中默认值为空。

其他

SQL类、PYTHON、数据库SQL、FLINK_SQLFLINK_DATASTREAM类型外,其他计算任务类型的顶部注释值在简体中文、繁体中文、英文环境中均默认为空。