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

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

功能介绍

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    DataArtsFabric:workspace:listSessionStatementRecords

    List

    workspace *

    • g:ResourceTag/<tag-key>

    • g:EnterpriseProjectId

    -

    DataArtsFabric:workspace:list

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业务接口

相关文档