文档首页> 数据治理中心 DataArts Studio> API参考（吉隆坡区域）> 数据开发API> 脚本开发API> 执行脚本
更新时间：2023-06-15 GMT+08:00
查看PDF

执行脚本

功能介绍

该接口用以执行指定脚本，支持执行DWS SQL、DLI SQL、RDS SQL、Flink SQL、、Hive SQL、Spark SQL、Presto SQL脚本。脚本每执行一次，生成一个脚本实例。执行脚本接口是一个异步命令，需要通过查询脚本实例执行结果获取执行状态和结果。

URI

  • URI格式

    POST /v1/{project_id}/scripts/{script_name}/execute

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

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

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

    script_name

    是

    String

    脚本名称。

请求消息

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

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

参数名

是否必选

参数类型

说明

params

否

Object

脚本参数Map<String,String>。如果脚本中定义了参数，通过params携带参数值。默认值为空。

脚本参数指的是脚本内容里的参数，如下所示：

响应消息

表4 参数说明

参数名

是否必选

参数类型

说明

instanceId

是

String

执行脚本的实例ID。在查询脚本实例执行结果使用instanceId获取执行结果。

示例

  • 请求
    POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/scripts/dws_sql/execute
    {
"params":{"tableVar":"citys",
"time":"2019-07-25"}
}
  • 成功响应

    HTTP状态码 200

    {
"instanceId": "a1ad-448a-9d56-4154193d49c5"
}
  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.6201",
    "error_msg":"The script does not exist."
}

状态码

状态码请参见状态码。

父主题： 脚本开发API