查询impala-profile树形目录

最近更新时间: 2026-09-17 00:05:46

1. 接口描述

接口请求域名： tbdsnew.api3.fincloud.tencent.cn。

在impala组件的查询管理的查询列表的详情入口，返回的是Profile列的目录统计数据

默认接口请求频率限制：20次/秒。

接口更新时间：2024-11-01 12:16:31。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeImpalaProfileTree
Version	是	否	String	公共参数，本接口取值：2019-01-03
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
InstanceId	是	否	String	集群Id 示例值： tbds-1vzudj86
ImpalaQueryId	是	否	String	impala作业Id 示例值： 0a4fd351ce2eac59:b74ab71900000000
StartTime	是	否	String	impala作业开始时间示例值： 2025-05-26 17:41:01.799

3. 输出参数

参数名称	类型	描述
ImpalaProfileTree	String	树形目录数据示例值： 1
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter.ImpalaQueryException	impala查询参数异常。
InternalError.ClickHouseQueryException	查询ClickHouse异常。
ResourceNotFound.ClusterNotFound	无法找到该实例。

5. 示例

示例1 【监控】查询impala profile树形目录

输入示例

POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: DescribeImpalaProfileTree
<公共请求参数>

{
  "InstanceId": "tbds-1vzudj86",
  "ImpalaQueryId": "0a4fd351ce2eac59:b74ab71900000000",
  "StartTime": "2025-05-26 17:41:01.799"
}

输出示例

{
  "Response": {
    "ImpalaProfileTree": "[{\"children\":[{\"node_id\":\"1_1\",\"node_name\":\"Plan\"},{\"node_id\":\"1_2\",\"node_name\":\"ExecSummary\"},{\"node_id\":\"1_3\",\"node_name\":\"Query Compilation\"},{\"node_id\":\"1_4\",\"node_name\":\"Query Timeline\"},{\"node_id\":\"1_5\",\"node_name\":\"Frontend\"}],\"node_id\":\"1\",\"node_name\":\"Summary\"},{\"node_id\":\"2\",\"node_name\":\"ImpalaServer\"},{\"children\":[{\"node_id\":\"3_1\",\"node_name\":\"Averaged Fragment F07\"},{\"children\":[{\"node_id\":\"3_2_1\",\"node_name\":\"tbds-172-16-0-117\"}],\"node_id\":\"3_2\",\"node_name\":\"Coordinator Fragment F07\"},{\"node_id\":\"3_3\",\"node_name\":\"Averaged Fragment F05 [80 instances]\"},{\"children\":[{\"node_id\":\"3_4_1\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_2\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_3\",\"node_name\":\"tbds-172-16-0-109\"},{\"node_id\":\"3_4_4\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_5\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_6\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_7\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_8\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_9\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_10\",\"node_name\":\"tbds-172-16-0-117\"},{\"node_id\":\"3_4_11\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_12\",\"node_name\":\"tbds-172-16-0-112\"},{\"node_id\":\"3_4_13\",\"node_name\":\"tbds-172-16-0-112\"}",
    "RequestId": "bfd57cdf-ee6d-45ff-bfc8-5aca998c5986"
  }
}