查询实时会话

project_id

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

参数解释：

实例ID，此参数是用户创建实例的唯一标识。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为36个字符。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

语言。

约束限制：

不涉及。

取值范围：

• zh-cn
• en-us

默认取值：

en-us。

node_id

是

String

参数解释：

节点ID。

约束限制：

仅支持包含有CN或DN（主、备）组件的节点。

取值范围：

不涉及。

默认取值：

不涉及。

component_id

是

String

参数解释：

组件ID。

约束限制：

仅支持包含有CN或DN（主、备）组件ID，且需要是node_id参数上的组件。

取值范围：

不涉及。

默认取值：

不涉及。

query_info

否

Object

参数解释：

获取实时会话筛选条件。

详情请参见表4。

约束限制：

不涉及。

is_statistic_open

否

String

是否开启事务数、回滚次数、SQL数统计，参数不下发时默认开启，取值范围：

• true
• false

limit

否

Integer

查询返回结果的最大数量，取值范围1-200。

order_by

否

String

查询结果的排序字段，如果is_statistic_open为false，不能使用trans_num、rollback_num、sql_num这三个字段排序，取值范围：

• sessionid
• unique_sql_id
• pid
• datname
• client_addr
• usename
• waiting
• node_name
• block_sessionid
• wait_event
• state
• query_runtime
• exec_time
• backend_start
• xact_start
• query_start
• application_name
• trans_num
• rollback_num
• sql_num

order

否

String

排序字段的排序顺序，当order_by字段没下发时，这个字段的取值没有意义，取值范围：

• desc
• asc

database_name

否

String

参数解释：

数据库名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

client_ip

否

String

参数解释：

客户端IP。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

user_name

否

String

参数解释：

用户名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

wait

否

String

是否筛选查询阻塞事件，取值：

• f
• t

session_id

否

String

会话ID。

state

否

String

会话状态。

wait_event

否

String

等待事件。

exec_time

否

String

会话建立时长。

query_runtime

否

String

语句执行时长。

unique_sql_id

否

String

归一化SQL ID。

sessions

Object

参数解释：

数据库实例的实时会话列表。

详情请参见表6。

session_id

String

参数解释：

会话ID。

取值范围：

不涉及。

pid

String

参数解释：

线程ID。

取值范围：

不涉及。

unique_sql_id

String

参数解释：

SQL ID。

取值范围：

不涉及。

database_name

String

参数解释：

数据库。

取值范围：

不涉及。

client_ip

String

参数解释：

客户端IP。

取值范围：

不涉及。

user_name

String

参数解释：

用户名。

取值范围：

不涉及。

wait

String

参数解释：

是否等待。

取值范围：

不涉及。

block_session

String

参数解释：

阻塞会话。

取值范围：

不涉及。

wait_event

String

参数解释：

等待事件。

取值范围：

不涉及。

state

String

参数解释：

状态。

取值范围：

不涉及。

query_runtime

String

参数解释：

语句执行时长。

取值范围：

不涉及。

query

String

参数解释：

SQL文本。

取值范围：

不涉及。

back_end_start

Long

参数解释：

会话开始时间。

取值范围：

不涉及。

transaction_start

Long

参数解释：

事务开始时间。

取值范围：

不涉及。

query_start

Long

参数解释：

语句开始时间。

取值范围：

不涉及。

application_name

String

参数解释：

应用名称。

取值范围：

不涉及。

exec_time

String

参数解释：

会话建立时长（单位：秒）。

取值范围：

不涉及。

trans_num

String

参数解释：

事务数。

取值范围：

不涉及。

rollback_num

String

参数解释：

回滚次数。

取值范围：

不涉及。

sql_num

String

参数解释：

SQL数。

取值范围：

不涉及。