更新时间:2023-06-15 GMT+08:00

创建脚本

功能介绍

创建一个新脚本,当前支持的脚本类型有DLI SQL、Flink SQL、RDS SQL、Spark SQL、Hive SQL、DWS SQL、Shell和Presto。

URI

  • URI格式

    POST /v1/{project_id}/scripts

  • 参数说明
    表1 URI参数说明

    参数名

    是否必选

    参数类型

    说明

    project_id

    String

    项目编号,获取方法请参见项目ID和帐号ID

请求消息

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

String

工作空间id。

  • 如果不设置该参数,默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据,需要带上该消息头。
表3 Script参数说明

参数名

是否必选

参数类型

说明

name

String

脚本名称,只能包含五种字符:英文字母、数字、中文、中划线和点号,且长度小于等于128个字符。脚本名称不能重复。

type

String

脚本类型,包含:

  • FlinkSQL
  • DLISQL
  • SparkSQL
  • HiveSQL
  • DWSSQL
  • RDSSQL
  • Shell
  • PRESTO

content

String

脚本内容,最大支持64KB。

directory

String

脚本所在目录路径。

通过DataArts Studio管理控制台 > 数据开发,左侧列表选择数据开发 > 脚本开发。在脚本的目录树上,可以查看到当前已经创建的目录,默认在根目录/。

connectionName

String

脚本关联的连接名称。当type参数值为DLISQL、SparkSQL、HiveSQL、DWSSQL、Shell、PRESTO其中之一时,这个参数是必选的。用户可以通过查询连接列表接口获取当前系统中已经存在的连接。默认值为空。

database

String

执行SQL语句所关联的数据库,当type参数值为DLISQL、SparkSQL、HiveSQL、DWSSQL、PRESTO其中之一时,才支持此参数。

  • type为DLI SQL时,可以通过《数据湖探索 API参考》的“查询所有数据库”接口获取数据库信息。
  • type为其他类型的时候,需要通过JDBC方式连上集群,查询数据库信息。默认值为空。

queueName

String

DLI资源队列名称,当type参数值为DLI SQL时,才支持此参数。可以通过《数据湖探索 API参考》的“查询队列列表接口”获取队列信息。默认值为空。

configuration

map <String,Object>

用户定义适用于此作业的配置参数,当type参数值为DLI SQL时,才支持此参数。当前支持的配置项列表请参考《数据湖探索 API参考》的“提交SQL作业接口”的conf参数说明。默认值为空。

description

String

描述,长度不能超过255个字符。

响应消息

示例

创建一个脚本。

  • 请求
    POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/scripts
    {
    "name":"echoTimeShell",
    "type":"Shell",
    "content":"echo a",
    "connectionName":"con"
    }
  • 成功响应

    HTTP状态码 204

  • 失败响应

    HTTP状态码 400

    {
        "error_code":"DLF.6247",
        "error_msg":"The script type is not specified."
    }

状态码

状态码请参见状态码