文档首页> MapReduce服务 MRS> API参考(阿布扎比区域)> API V2> SQL接口> 查询SQL结果
更新时间：2022-12-14 GMT+08:00
查看PDF

查询SQL结果

功能介绍

在MRS集群中查询一条SQL的执行结果。

URI

  • URI格式

    GET /v2/{project_id}/clusters/{cluster_id}/sql-execution/{sql_id}

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

    名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

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

    cluster_id

    是

    String

    集群ID。获取方法，请参见获取集群ID。

    sql_id

    是

    String

    SQL的执行ID，即提交SQL语句返回结果中的sql_id。

请求消息

请求参数

无。

响应参数

状态码： 200

表2 响应参数说明

参数名

参数类型

说明

id

String

SQL的执行ID。执行select、show和desc语句时才会生成ID，其他操作ID为空。

message

String

错误信息。

statement

String

执行的SQL语句。

status

String

SQL的执行状态。

  • QUEUED
  • WAITING_FOR_RESOURCES
  • PLANNING
  • STARTING
  • RUNNING
  • FINISHING
  • FINISHED
  • FAILED

result_location

String

SQL查询语句的最终结果归档路径。

说明：

只有select的语句才会将SQL的执行结果转储到result_location中。

content

Array

SQL的执行结果。

说明：

只有非select的语句才会在content中返回结果，如果SQL中没有结果，content为空。

状态码： 400

表3 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

查询SQL结果请求示例

GET https://{endpoint}/v2/{project_id}/clusters/{cluster_id}/sql-execution/{sql_id}

响应示例

状态码： 200

查询SQL结果成功

{
  "id" : "20190909_011820_00151_xxxxx",
  "statement" : "show tables",
  "status" : "FINISHED",
  "result_location" : "obs://my_bucket/uuid_date/xxxx.csv",
  "content" : [ [ "t1", null ], [ null, "t2" ], [ null, "t3" ] ]
}

状态码： 400

查询SQL结果失败

{
  "error_code" : "MRS.0011",
  "message" : "提交SQL到Executor上失败，集群ID为xxxx"
}

状态码

状态码请参见状态码。

错误码

请参见错误码。

父主题： SQL接口