文档首页> MapReduce服务 MRS> API参考（吉隆坡区域）> API V2> SQL接口> 查询SQL结果
更新时间：2022-08-12 GMT+08:00
查看PDF

查询SQL结果

功能介绍

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

URI

  • URI格式

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

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

    名称

    是否必选

    说明

    project_id

    是

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

    cluster_id

    是

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

    sql_id

    是

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

请求消息

请求参数

无。

响应参数

表2 响应参数说明

参数名

参数类型

说明

id

String

SQL的执行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为空。

示例

  • 请求示例
    GET https://{endpoint}/v2/{project_id}/clusters/{cluster_id}/sql-execution/{sql_id}
  • 响应示例
    • 成功示例
      {
    "id":"20190909_011820_00151_xxxxx ", 
    "statement":"show tables",
    "status":”FINISHED”,
    "result_location":" obs://my_bucket/uuid_date/xxxx.csv",  
    "content":[
       ["t1"],["t2"],["t3"]   
      ] 
 }
    • 失败示例
      { 
  "error_code" : "MRS.0011", 
  "message" : "提交SQL到Executor上失败，集群ID为xxxx" 
}

状态码

状态码请参见状态码。

父主题： SQL接口