文档首页/ 数据湖探索 DLI/ 用户指南/ 使用DLI提交SQL作业/ 创建并管理SQL作业模板/ 创建SQL作业模板
更新时间：2024-09-27 GMT+08:00
查看PDF
分享

创建SQL作业模板

为了便捷快速的执行SQL操作，DLI支持定制模板或将正在使用的SQL语句保存为模板。保存模板后，不需编写SQL语句，可通过模板直接执行SQL操作。

SQL模板包括样例模板和自定义模板。当前系统默认的样例模板包括22条标准的TPC-H查询语句，可以满足用户大部分的TPC-H需求场景测试，TPC-H样例说明请参考DLI预置的SQL模板中TPC-H样例数据说明。

在“SQL模板”页面右上角，单击“设置”可以选择是否按照分组展示模板。

如果选择“按分组展示”，有以下三种展示方式：展开第一个分组、全部展开、全部收起。

创建SQL作业模板

创建模板的操作入口有两个，分别在“作业模板”和“SQL编辑器”页面。

  • 在“作业模板”页面创建模板。
    1. 在管理控制台左侧，单击“作业模板”>“SQL模板”。
    2. 在“SQL模板”页面，单击右上角“创建模板”。

      输入模板名称、语句和描述信息，详细参数介绍请参见表1。

      图1 创建模板
      表1 参数说明

      参数名称

      描述

      名称

      模板名称。

      • 模板名称只能包含数字、英文字母和下划线，但不能是纯数字，不能以下划线开头，且不能为空。
      • 输入长度不能超过50个字符。

      语句

      需要保存为模板的SQL语句。

      描述

      该模板的相应描述。

      分组设置
      • 已有分组
      • 创建新分组
      • 不分组

      分组名称

      “分组设置”选择“已有分组”或者“创建新分组”时，需要填写分组名称。
    3. 单击“确定”，完成模板创建。
  • 在“SQL编辑器”页面创建模板。
    1. 在管理控制台左侧，单击“SQL编辑器”。
    2. 单击SQL作业编辑窗口右上方的“更多”，选择“设为模板”，可将编辑窗口中的SQL语句设置为模板。

      输入模板名称、语句和描述信息，详细介绍请参见表1。

    3. 单击“确定”，完成模板创建。

使用模板提交SQL作业

执行模板操作步骤如下：
  1. 在管理控制台左侧，单击“作业模板”>“SQL模板”。
  2. 在“SQL模板”页面，勾选相应的模板，单击“操作”列的“执行”，将跳转至“SQL编辑器”页面，并在SQL作业编辑窗口中自动输入对应的SQL语句。
  3. 在SQL作业编辑窗口右上方，单击“执行”运行SQL语句，执行结束后，可以在SQL作业编辑窗口下方区域中查看执行结果。

查找SQL作业模板

在“SQL模板”页面，可在右上方搜索框中输入模板名称关键字，查找与之匹配的模板。

修改SQL作业模板

修改模板仅支持对自定义模板进行操作，具体步骤如下：

  1. 在“SQL模板”页面，单击“自定义模板”，选中需修改的模板，单击“操作”列的“修改”。
  2. 在弹出的“修改模板”对话框中，根据需要修改模板的名称、语句和描述。
  3. 单击“确定”，保存修改结果。

删除模板

在“SQL模板”页面，单击“自定义模板”，勾选一个或多个待删除的模板，单击“删除”，可删除选中的模板。