文档首页/ 数智融合计算服务 DataArtsFabric/ API参考/ API/ SQL业务接口/ 获取指定Session下的SQL执行记录
更新时间：2025-09-15 GMT+08:00
查看PDF
分享

获取指定Session下的SQL执行记录

功能介绍

查询指定Session下的SQL执行记录

URI

GET /v1/workspaces/{workspace_id}/sessions/{session_id}/statements

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

是

String

参数解释：工作空间的ID。

约束限制：不涉及。

取值范围：长度为[1,36]的字母、数字、中划线(-)的组合。

默认取值：不涉及。

session_id

是

String

参数解释：SessionId的ID。

约束限制：不涉及。

取值范围：长度为[1,36]的字母、数字、中划线(-)的组合。

默认取值：不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释：指定每一页返回的最大条目数。

约束限制：不涉及。

取值范围：[1,100]。

默认取值：10。

offset

否

Integer

参数解释：偏移量，表示从此偏移量开始查询。

约束限制：不涉及。

取值范围：[0,1000000000]。

默认取值：0。

statement_id

否

String

参数解释：statement id。

约束限制：不涉及。

取值范围：长度为[1,64]的字母、数字、中划线(-)和下划线(_)的组合。

默认取值：不涉及。

status

否

String

参数解释：状态过滤，支持一种状态查询，默认查询所有。

约束限制：不涉及。

取值范围：可选值有：

CANCELED、FAILED、SUCCESSFUL、RUNNING、SUBMITTED、ERROR

默认取值：不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

参数解释：租户token。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

records

Array of records objects

参数解释：查询结果。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

total

Integer

参数解释：记录总数。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。
表5 records

参数

参数类型

描述

statement_id

String

参数解释：statement id。

约束限制：不涉及。

取值范围：长度为[1,64]的字母、数字、中划线(-)和下划线(_)的组合。

默认取值：不涉及。

statement_content

String

参数解释：查询语句内容。

约束限制：不涉及。

取值范围：长度为[0-2147483647]的字符串。

默认取值：不涉及。

create_time

String

参数解释：查询语句创建时间。

约束限制：不涉及。

取值范围：不涉及

默认取值：不涉及。

status

String

参数解释：查询状态。

约束限制：不涉及。

取值范围：CANCELED、FAILED、SUCCESSFUL、RUNNING、SUBMITTED、ERROR

默认取值：不涉及。

user_name

String

参数解释：用户名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

约束限制：不涉及。

取值范围：长度[8,36]。

默认取值：不涉及。

error_msg

String

参数解释：错误描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

solution_msg

String

参数解释：解决方案描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

约束限制：不涉及。

取值范围：长度[8,36]。

默认取值：不涉及。

error_msg

String

参数解释：错误描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

solution_msg

String

参数解释：解决方案描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

约束限制：不涉及。

取值范围：长度[8,36]。

默认取值：不涉及。

error_msg

String

参数解释：错误描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

solution_msg

String

参数解释：解决方案描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

状态码：408

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

约束限制：不涉及。

取值范围：长度[8,36]。

默认取值：不涉及。

error_msg

String

参数解释：错误描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

solution_msg

String

参数解释：解决方案描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

状态码：500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：错误码。

约束限制：不涉及。

取值范围：长度[8,36]。

默认取值：不涉及。

error_msg

String

参数解释：错误描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

solution_msg

String

参数解释：解决方案描述。

约束限制：不涉及。

取值范围：长度[2,4096]。

默认取值：不涉及。

请求示例

查询sql执行历史记录，返回值为sql执行的sql，开始时间，状态等。

GET https://endpoint/v1/workspaces/{workspace_id}/sessions/{session_id}/statements

{ }

响应示例

状态码：200

获取Session下的SQL查询响应体

{
  "records" : [ {
    "statement_id" : "4272****02409",
    "statement_content" : "select 1",
    "create_time" : "2025-07-22T08:44:00.000+00:00",
    "status" : "FAILED",
    "user_name" : "example"
  }, {
    "statement_id" : "ba5e****78fd",
    "statement_content" : "select 1",
    "create_time" : "2025-07-22T08:43:58.000+00:00",
    "status" : "SUCCESSFUL",
    "user_name" : "example"
  } ],
  "total" : 2
}

状态码：400

BadRequest

{
  "error_code" : "common.01000001",
  "error_msg" : "failed to read http request, please check your input, code: 400, reason: Type mismatch., cause: TypeMismatchException"
}

状态码：401

Unauthorized

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}

状态码：403

Forbidden

{
  "error" : {
    "code" : "403",
    "message" : "X-Auth-Token is invalid in the request",
    "title" : "Forbidden"
  },
  "error_code" : 403,
  "error_msg" : "X-Auth-Token is invalid in the request",
  "title" : "Forbidden"
}

状态码：404

NotFound

{
  "error_code" : "common.01000001",
  "error_msg" : "response status exception, code: 404"
}

状态码：408

Request Time-out

{
  "error_code" : "common.00000408",
  "error_msg" : "timeout exception occurred"
}

状态码：500

InternalServerError

{
  "error_code" : "common.00000500",
  "error_msg" : "internal error"
}

状态码

状态码

描述

200

获取Session下的SQL查询响应体

400

BadRequest

401

Unauthorized

403

Forbidden

404

NotFound

408

Request Time-out

500

InternalServerError

错误码

请参见错误码。

父主题： SQL业务接口