执行脚本 - ExecuteScript

功能介绍

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

DLI SQL和Presto SQL不支持多语句场景。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

• URI格式

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

请求参数

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

响应参数

请求示例

执行脚本名称为dws_sql的脚本，脚本中参数tableVar的值为cities，脚本中参数time的值为2019-07-25。

POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/scripts/dws_sql/execute
{
    "params": {
        "tableVar": "cities",
        "time": "2019-07-25"
    }
}

响应示例

• 成功响应

  HTTP状态码 200

• 失败响应

  HTTP状态码 400

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

状态码

状态码请参见状态码。