GetSemanticJobLog - 查询语义任务运行日志-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

使用 RunSemanticJob 或 ListSemanticJobRuns 返回的 ExecutorJobId 查询执行日志。当前 POP 契约仅暴露任务与工作空间标识，返回默认日志片段。

接口说明

使用场景

读取某次语义任务运行的执行日志，用于观察执行过程和定位失败原因。

调用流程

通过 RunSemanticJob.Data.ExecutorJobId 或 ListSemanticJobRuns[].ExecutorJobId 指定运行。
使用对应任务的 ProjectId 调用本接口。
结合 GetSemanticJobDetail 返回的运行状态分析 Data 中的日志片段。

注意事项

日志用于诊断，不代表最终结果文件；结果产物请通过 DownloadSemanticResults 获取。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ExecutorJobId	string	是	执行器任务标识，使用 RunSemanticJob 响应的 Data.ExecutorJobId 或 ListSemanticJobRuns 记录中的 ExecutorJobId。	exec-job-demo
ProjectId	integer	是	任务所属 DataWorks 工作空间 ID，使用 CreateSemanticJob 响应或 ListSemanticJobs 列表项的 ProjectId。	100

请根据各请求字段的说明构造调用参数。

返回参数

名称	类型	描述	示例值
	object	查询执行日志的标准响应。Data 为执行器返回的日志片段列表。
RequestId	string	请求 ID。用于定位日志和排查问题。	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	请求是否成功
Data	array<object>	执行器返回的日志片段列表。当前 POP 契约未对外暴露 sqlIndex、offset，按接口默认行为返回日志片段。
	object	一个日志片段。
LogEnd	boolean	当前日志片段是否已读取到末尾；为 true 表示该片段没有更多后续内容。
LogContent	string	本次返回的原始日志文本。	semantic job started

响应字段含义和后续调用关系请参阅各字段说明。

示例

正常返回示例

JSON格式

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": true,
  "Data": [
    {
      "LogEnd": true,
      "LogContent": "semantic job started"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。