文档首页/ 数据治理中心 DataArts Studio/ API参考/ 数据开发API（V1）/ 脚本开发API/ 修改脚本内容
更新时间：2023-11-30 GMT+08:00
查看PDF
分享

修改脚本内容

功能介绍

本接口用以修改脚本的配置项或者脚本内容。

  • 修改脚本时，需要指定待修改的脚本名称。
  • 脚本名称和脚本类型不支持修改。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

URI

  • URI格式

    PUT /v1/{project_id}/scripts/{script_name}

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

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

    项目编号，获取方法请参见项目ID和账号ID。

    script_name

    是

    String

    脚本名称。

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

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

参数名

是否必选

参数类型

说明

name

是

String

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

type

是

String

脚本类型，包含：

  • FlinkSQL
  • DLISQL
  • SparkSQL
  • HiveSQL
  • DWSSQL
  • RDSSQL
  • Shell
  • PRESTO
  • ClickHouseSQL
  • HetuEngineSQL
  • PYTHON
  • ImpalaSQL
  • SparkPython

content

是

String

脚本内容，最大支持4M。

directory

否

String

脚本所在目录路径。

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

connectionName

否

String

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

database

否

String

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

  • type为DLI SQL时，可以通过查看所有数据库接口获取数据库信息。
  • type为其他类型的时候，需要通过JDBC方式连上集群，查询数据库信息。默认值为空。

queueName

是

String

DLI资源队列名称，当type参数值为DLISQL时，才支持此参数。可以通过查询队列列表接口获取队列信息。默认值为空。

configuration

否

map <String,Object>

用户定义适用于此作业的配置参数，当type参数值为DLISQL时，才支持此参数。当前支持的配置项列表请参考 conf参数说明。默认值为空。

description

否

String

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

targetStatus

否

String

在开启审批开关后，需要填写该字段。表示创建脚本的目标状态，有三种状态：SAVED、SUBMITTED和PRODUCTION，分别表示脚本创建后是保存态，提交态，生产态。

  • 保存态表示脚本仅保存，无法调度运行，需要提交并审核通过后才能运行。
  • 提交态表示脚本保存后会自动提交，需要审核通过才能运行。
  • 生产态表示脚本跳过审批环节，创建后可以直接运行。注意：只有工作空间的管理员用户才能创建生产态的脚本。

    审批开关的配置请参见审批中心。

approvers

否

List<JobApprover>

在开启审批开关后，需要填写该字段，表示脚本审批人，参考表4。

审批开关的配置请参见审批中心。
表4 审批人属性说明

参数名

是否必选

参数类型

说明

approverName

是

String

审批人名称。

响应参数

无

请求示例

修改脚本名称为echoTimeShell的脚本内容，脚本类型为Shell，脚本内容为echo a，脚本关联的连接名称为con。 
PUT /v1/b384b9e9ab9b4ee8994c8633aabc9505/scripts/echoTimeShell
{
    "name": "echoTimeShell",
    "type": "Shell",
    "content": "echo a",
    "queueName": "default",
    "connectionName": "con"
}
开启审批开关的情况下，修改脚本内容。 
PUT /v1/b384b9e9ab9b4ee8994c8633aabc9505/scripts/echoTimeShell
{
    "name": "echoTimeShell",
    "type": "Shell",
    "content": "echo a",
    "queueName": "default",
    "connectionName": "con",
    "approvers": [
      {
        "approverName": "userName1"
      },
      {
        "approverName": "userName2"
      }
    ]
}

响应示例

  • 成功响应

    HTTP状态码 204

  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.6201",
    "error_msg":"The script does not exist."
}
父主题： 脚本开发API

相关文档