查询作业的输入输出表 - ListJobInputOutputTables
功能介绍
根据作业ID查询该作业解析的输入表和输出表,用于数据治理场景,判断作业是否可以下线。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v2/{project_id}/factory/task-table-references/{job_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID,获取方法请参见项目ID和账号ID。 |
| job_id | 是 | Long | 作业Id。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| io_type | 否 | String | 表类型筛选,可选值:作业和表的关系,0表示作业是读表,1表示作业写表,2表示全部(默认)。 |
| offset | 否 | Integer | 分页列表的页数,默认值为0。取值范围大于等于0。 |
| limit | 否 | Integer | 分页返回结果,指定每页最大记录数。范围[1,100] 默认值:20 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 否 | String | IAM Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值),使用Token认证时必选,最小长度:0,最大长度:4096。 |
| X-Project-Id | 否 | String | project_id,项目编号。获取方法请参见项目ID和账号ID, 多project场景采用AK/SK认证的接口请求,则该字段必选。 |
| Content-Type | 是 | String | 默认值:application/json;charset=UTF-8 可选,有Body体的情况下必选,没有Body体则无需填写和校验。 |
| workspace | 是 | String | 工作空间ID,获取方法请参见实例ID和工作空间ID。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| job_id | Long | 作业ID。 |
| job_name | String | 作业名称。 |
| table_count | Integer | 表总数。 |
| tables | Array of JobTableInfo objects | 表列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| db_type | String | 数据库类型,仅支持DLI,HIVE,SPARK。 |
| data_base | String | 数据库名称。 |
| table_name | String | 表名称。 |
| io_type | Integer | 作业和表的关系,0表示作业是读表,1表示作业写表。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误描述。 |
请求示例
查询作业ID为5625的输入表列表。
GET /v2/{project_id}/factory/task-table-references/5625?io_type=0 响应示例
状态码:200
查询成功,返回作业的输入输出表信息。
{
"job_id" : 5625,
"job_name" : "job_5441",
"table_count" : 2,
"tables" : [ {
"data_base" : "1_database",
"db_type" : "DLI",
"io_type" : 0,
"table_name" : "d_2026-01-21 18:44:16:660"
}, {
"data_base" : "1_database",
"db_type" : "DLI",
"io_type" : 0,
"table_name" : "b_20260121184416"
} ]
} 状态码:400
查询失败。
{
"error_code" : "DLF.5013",
"error_msg" : "The request param is invalid."
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功,返回作业的输入输出表信息。 |
| 400 | 查询失败。 |