查询SQL执行信息
功能介绍
查询SQL执行信息。
调用方法
请参见如何调用API。
URI
GET /v1/{project_id}/clusters/{cluster_id}/dms/queries/{query_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| cluster_id | 是 | String | 参数解释: 集群ID。获取方法请参见获取集群ID。 约束限制: 必须是有效的dws集群ID。 取值范围: 36位UUID。 默认取值: 不涉及。 |
| query_id | 是 | String | 参数解释: 查询ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| ctime | 否 | Long | 参数解释: 采集时间,时间戳。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 参数解释: 响应码。 取值范围: 不涉及。 |
| msg | String | 参数解释: 响应信息。 取值范围: 不涉及。 |
| data | ListQueriesDto object | 参数解释: 响应数据。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| virtual_cluster_id | Integer | 参数解释: 虚拟集群ID。 取值范围: 不涉及。 |
| ctime | Long | 参数解释: 采集时间。 取值范围: 不涉及。 |
| pid | String | 参数解释: 会话ID。 取值范围: 不涉及。 |
| inst_name | String | 参数解释: 实例名称。 取值范围: 不涉及。 |
| waiting | Boolean | 参数解释: 如果后台当前正等待锁则为true。 取值范围: 不涉及。 |
| enqueue | String | 参数解释: 资源状态。 取值范围: 不涉及。 |
| warning | String | 参数解释: 主要显示如下几类告警信息以及sql自诊断调优相关告警。 取值范围: 不涉及。 |
| query | String | 参数解释: 查询语句。 取值范围: 不涉及。 |
| lane | String | 参数解释: 快慢车道。 取值范围: fast:快车道。 slow:慢车道。 |
| db_name | String | 参数解释: 数据库名称。 取值范围: 不涉及。 |
| priority | String | 参数解释: 任务在资源池中的优先级。 取值范围: 1:最高。 2:高。 4:中。 8:低。 |
| query_id | String | 参数解释: 语句执行使用的内部查询ID。 取值范围: 不涉及。 |
| query_band | String | 参数解释: 用于标示作业类型,可通过guc参数query_band进行设置,默认为空字符串。 取值范围: 不涉及。 |
| job_name | String | 参数解释: 该值是从query_band的字段中取出来的,位置0。 取值范围: 不涉及。 |
| job_inst | String | 参数解释: 该值是从query_band的字段中取出来的,位置1。 取值范围: 不涉及。 |
| user_name | String | 参数解释: 连接到后端的用户名。 取值范围: 不涉及。 |
| application_name | String | 参数解释: 连接到后端的应用名。 取值范围: 不涉及。 |
| client_address | String | 参数解释: 连接到后端的客户端的IP地址。 取值范围: 不涉及。 |
| client_hostname | String | 参数解释: 客户端的主机名。 取值范围: 不涉及。 |
| client_port | String | 参数解释: 客户端用于与后端通讯的tcp端口号。 取值范围: 不涉及。 |
| start_time | Long | 参数解释: 语句执行的开始时间。 取值范围: 不涉及。 |
| block_time | Long | 参数解释: 语句执行前的阻塞时间,单位ms。 取值范围: 不涉及。 |
| duration | Long | 参数解释: 语句已经执行的时间,单位ms。 取值范围: 不涉及。 |
| estimate_total_time | Long | 参数解释: 语句执行预估总时间,单位ms。 取值范围: 不涉及。 |
| estimate_left_time | Long | 参数解释: 语句执行预估剩余时间,单位ms。 取值范围: 不涉及。 |
| resource_pool | String | 参数解释: 用户使用的资源池。 取值范围: 不涉及。 |
| control_group | String | 参数解释: 语句所使用的cgroup。 取值范围: 不涉及。 |
| min_peak_memory | Integer | 参数解释: 语句在所有dn上的最小内存峰值,单位mb。 取值范围: 不涉及。 |
| max_peak_memory | Integer | 参数解释: 语句在所有dn上的最大内存峰值,单位mb。 取值范围: 不涉及。 |
| average_peak_memory | Integer | 参数解释: 语句执行过程中的内存使用平均值,单位mb。 取值范围: 不涉及。 |
| memory_skew_percent | Integer | 参数解释: 语句在各dn间的内存使用倾斜率。 取值范围: 不涉及。 |
| estimate_memory | Integer | 参数解释: 语句预估使用内存,单位mb。 取值范围: 不涉及。 |
| spill_info | String | 参数解释: 语句在所有dn上的下盘信息。 取值范围: 不涉及。 |
| min_spill_size | Integer | 参数解释: 若发生下盘,所有dn上下盘的最小数据量 (单位mb) 默认为0。 取值范围: 不涉及。 |
| max_spill_size | Integer | 参数解释: 若发生下盘,所有dn上下盘的最大数据量 (单位mb) 默认为0。 取值范围: 不涉及。 |
| average_spill_size | Integer | 参数解释: 若发生下盘,所有dn上下盘的平均数据量 (单位mb) 默认为0。 取值范围: 不涉及。 |
| spill_skew_percent | Integer | 参数解释: 若发生下盘,dn间下盘倾斜率。 取值范围: 不涉及。 |
| min_dn_time | Long | 参数解释: 语句在所有dn上的最小执行时间,单位ms。 取值范围: 不涉及。 |
| max_dn_time | Long | 参数解释: 语句在所有dn上的最大执行时间,单位ms。 取值范围: 不涉及。 |
| average_dn_time | Long | 参数解释: 语句在所有dn上的平均执行时间,单位ms。 取值范围: 不涉及。 |
| dntime_skew_percent | Integer | 参数解释: 语句在各dn间的执行时间倾斜率。 取值范围: 不涉及。 |
| min_cpu_time | Long | 参数解释: 语句在所有dn上的最小cpu时间,单位ms。 取值范围: 不涉及。 |
| max_cpu_time | Long | 参数解释: 语句在所有dn上的最大cpu时间,单位ms。 取值范围: 不涉及。 |
| total_cpu_time | Long | 参数解释: 语句在所有dn上的cpu总时间,单位ms。 取值范围: 不涉及。 |
| cpu_skew_percent | Integer | 参数解释: 语句在各dn间的cpu时间倾斜率。 取值范围: 不涉及。 |
| average_peak_iops | Integer | 参数解释: 语句在所有dn上的每秒平均io峰值(列存单位是次/s,行存单位是万次/s)。 取值范围: 不涉及。 |
| iops_skew_percent | Integer | 参数解释: 语句在dn间的io倾斜率。 取值范围: 不涉及。 |
| max_peak_iops | Integer | 参数解释: 语句在所有dn上的每秒最大io峰值(列存单位是次/s,行存单位是万次/s)。 取值范围: 不涉及。 |
| min_peak_iops | Integer | 参数解释: 语句在所有dn上的每秒最小io峰值(列存单位是次/s,行存单位是万次/s)。 取值范围: 不涉及。 |
| query_plan | String | 参数解释: 查询计划。 取值范围: 不涉及。 |
| query_status | String | 参数解释: 当前查询语句的实时运行状态。 取值范围: active、idle、idle in transaction、idle in transaction(aborted)、fastpath function call、disabled。 |
| wlm_status | String | 参数解释: 当前查询语句在资源池上的运行状态。 取值范围: pending:待生效。 running:运行中。 finished:结束。 aborted:终止。 active:正常。 unknown:未知。 |
| wlm_attrib | String | 参数解释: 语句的属性。 取值范围: ordinary:普通。 simple:简单。 complicated:复杂。 internal:内部。 |
| system_query | Boolean | 参数解释: 是否系统查询。 取值范围: 不涉及。 |
| backend_start | Long | 参数解释: 该过程开始的时间,即当客户端连接服务器时。 取值范围: 不涉及。 |
| elapsed_time | Long | 参数解释: 到目前为止的执行时间。 取值范围: 不涉及。 |
| curr_xact_start | Long | 参数解释: 启动当前事务的时间,如果没有事务是活跃的,则为null。如果当前查询是首个事务,则这列等同于query_start列。 取值范围: 不涉及。 |
| state_change | Long | 参数解释: 上次状态改变的时间。 取值范围: 不涉及。 |
| query_start | Long | 参数解释: 语句执行的开始时间。 取值范围: 不涉及。 |
| query_elapsed_time | Long | 参数解释: 语句当前为止的实际执行时间。单位:秒。 取值范围: 不涉及。 |
请求示例
https://{Endpoint}/v1/{project_id}/clusters/{cluster_id}/dms/queries/{query_id}?ctime=1699062846000 响应示例
状态码:200
查询成功。
{
"code" : 0,
"msg" : "OK",
"data" : {
"ctime" : 1699062846000,
"pid" : "140535026615872",
"waiting" : false,
"duration" : 0,
"enqueue" : "",
"warning" : "",
"query" : "WLM fetch collect info from data nodes",
"lane" : "",
"priority" : null,
"virtual_cluster_id" : 0,
"inst_name" : "cn_5002",
"db_name" : "postgres",
"query_id" : "145522562959855061",
"query_band" : "",
"job_name" : "",
"job_inst" : "",
"user_name" : "Ruby",
"application_name" : "workload",
"client_address" : "",
"client_hostname" : "",
"client_port" : "",
"start_time" : 0,
"block_time" : 0,
"estimate_total_time" : 0,
"estimate_left_time" : 0,
"resource_pool" : "default_pool",
"control_group" : "",
"min_peak_memory" : 0,
"max_peak_memory" : 0,
"average_peak_memory" : 0,
"memory_skew_percent" : 0,
"estimate_memory" : 0,
"spill_info" : "",
"min_spill_size" : 0,
"max_spill_size" : 0,
"average_spill_size" : 0,
"spill_skew_percent" : 0,
"min_dn_time" : 0,
"max_dn_time" : 0,
"average_dn_time" : 0,
"dntime_skew_percent" : 0,
"min_cpu_time" : 0,
"max_cpu_time" : 0,
"total_cpu_time" : 0,
"cpu_skew_percent" : 0,
"average_peak_iops" : 0,
"iops_skew_percent" : 0,
"max_peak_iops" : 0,
"min_peak_iops" : 0,
"query_plan" : "",
"query_status" : "active",
"wlm_status" : "",
"wlm_attrib" : "",
"system_query" : false,
"backend_start" : 0,
"elapsed_time" : 0,
"curr_xact_start" : 0,
"state_change" : 0,
"query_start" : 0,
"query_elapsed_time" : 0
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功。 |
| 400 | 请求错误。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 404 | 找不到资源。 |
| 500 | 服务内部错误。 |
| 503 | 服务不可用。 |