展示 Session 详细状态

更新时间：2024-12-05 14:41:07

本文介绍了如何查看 ODP 上指定 Client Session 的详细内部状态。

操作步骤

sys 租户和用户租户可以通过 SHOW PROXYSESSION ATTRIBUTE 语句查看指定 Client Session 的详细内部状态，包括该 Client Session 上涉及的相关 Server Session。

通过 ODP 连接的方式连接 OceanBase 数据库。
```
obclient -h10.xx.xx.xx -uusername@obtenant#obdemo -P2883 -p****** -c -A oceanbase
```
有关更加详细的通过 ODP 连接方式连接数据库的操作指引，请参见通过 OBClient 连接数据库。

查看指定 Client Session 的详细内部状态。

SQL 语句如下：

SHOW PROXYSESSION ATTRIBUTE [id [like 'xxx']]

参数说明：

不指定 id 时，显示当前 Session 的详细状态(ODP 1.1.0 版本起开始支持)，支持模糊查询当前 Session 指定属性名称的 value (proxy 1.1.2 版本起开始支持)。
指定 id 时，显示指定 ID 对应 Client Session 的详细状态(ODP 1.1.0 版本起开始支持)，支持模糊查询指定属性名称的 value (ODP 1.1.2 版本起开始支持)。
id 既可以是 cs_id，也可以是 CONNECTION_ID，显示结果相同。

cs_id 为 ODP 内部标记的每个 Client 的 id 号，CONNECTION_ID 为整个 OceanBase 数据库标记的每个 Client 的 id 号。MySQL 模式下的 connection_id 通过 SELECT CONNECTION_ID(); 语句获取，Oracle 模式下的 connection_id 通过 SHOW FULL PROCESSLIST; 语句获取。
like 模糊匹配字段名称，支持 '%' 和 '_' 。

示例如下：

obclient> SHOW PROXYSESSION;
+--------------------+------+-----------------+--------+------+-----------------+------+-------------+-------------------+-------------------+---------+---------+
| proxy_sessid       | Id   | Cluster         | Tenant | User | Host            | db   | trans_count | svr_session_count | state             | tid     | pid     |
+--------------------+------+-----------------+--------+------+-----------------+------+-------------+-------------------+-------------------+---------+---------+
| 756006681247547396 |    2 | ob1.jianhua.sjh | sys    | root | 127.0.0.1:22540 | NULL |           0 |                 1 | MCS_ACTIVE_READER | 2230520 | 2230520 |
+--------------------+------+-----------------+--------+------+-----------------+------+-------------+-------------------+-------------------+---------+---------+
1 row in set

obclient> SHOW PROXYSESSION ATTRIBUTE;
+------------------------+---------------------+----------------+
| attribute_name         | value               | info           |
+------------------------+---------------------+----------------+
| proxy_sessid           | 756006681247547396  | cs common      |
| cs_id                  | 2                   | cs common      |
| cluster                | ob1.jianhua.sjh     | cs common      |
| tenant                 | sys                 | cs common      |
| user                   | root                | cs common      |
| host_ip                | 127.0.0.1           | cs common      |
| host_port              | 22540               | cs common      |
| db                     | NULL                | cs common      |
| total_trans_cnt        | 0                   | cs common      |
| svr_session_cnt        | 1                   | cs common      |
| active                 | true                | cs common      |
| read_state             | MCS_ACTIVE_READER   | cs common      |
| tid                    | 2230520             | cs common      |
| pid                    | 2230520             | cs common      |
| modified_time          | 1469435190244371115 | cs stat        |
| reported_time          | 1469435190244371115 | cs stat        |
| hot_sys_var_version    | 0                   | cs var version |
| sys_var_version        | 0                   | cs var version |
| user_var_version       | 0                   | cs var version |
| last_insert_id_version | 0                   | cs var version |
| db_name_version        | 0                   | cs var version |
| server_ip              | 10.xx.xx.xx         | last used ss   |
| server_port            | 13203               | last used ss   |
| server_sessid          | 2147549201          | last used ss   |
| ss_id                  | 4                   | last used ss   |
| state                  | MSS_KA_CLIENT_SLAVE | last used ss   |
| transact_count         | 2                   | last used ss   |
| server_trans_stat      | 0                   | last used ss   |
| hot_sys_var_version    | 0                   | last used ss   |
| sys_var_version        | 0                   | last used ss   |
| user_var_version       | 0                   | last used ss   |
| last_insert_id_version | 0                   | last used ss   |
| db_name_version        | 0                   | last used ss   |
+------------------------+---------------------+----------------+
33 rows in set

obclient> SHOW PROXYSESSION ATTRIBUTE 2 like '%id%';
+------------------------+--------------------+----------------+
| attribute_name         | value              | info           |
+------------------------+--------------------+----------------+
| proxy_sessid           | 756006681247547396 | cs common      |
| cs_id                  | 2                  | cs common      |
| tid                    | 2230520            | cs common      |
| pid                    | 2230520            | cs common      |
| last_insert_id_version | 0                  | cs var version |
| server_sessid          | 2147549201         | last used ss   |
| ss_id                  | 4                  | last used ss   |
| last_insert_id_version | 0                  | last used ss   |
+------------------------+--------------------+----------------+
8 rows in set

obclient> SHOW PROXYSESSION ATTRIBUTE 2147549201 like '%id%';
+------------------------+--------------------+----------------+
| attribute_name         | value              | info           |
+------------------------+--------------------+----------------+
| proxy_sessid           | 756006681247547396 | cs common      |
| cs_id                  | 2                  | cs common      |
| tid                    | 2230520            | cs common      |
| pid                    | 2230520            | cs common      |
| last_insert_id_version | 0                  | cs var version |
| server_sessid          | 2147549201         | last used ss   |
| ss_id                  | 4                  | last used ss   |
| last_insert_id_version | 0                  | last used ss   |
+------------------------+--------------------+----------------+
8 rows in set

各字段含义如下表所示：

字段	说明
attribute_name	属性名称
value	属性值
info	基本信息

常见的属性及其说明如下表所示：

字段	字段
proxy_sessid	OBProxy 的会话 ID 号
cluster	所属集群名
socket_fd	套接字描述符
tenant	租户
user	用户
host_ip	用户 IP
host_port	用户端口号
db	数据库
total_trans_cnt	传输事务的总数量
svr_session_cnt	会话总数量
active	是否存活
read_state	客户端会话的状态
tid	线程 ID
pid	进程 ID
modified_time	历史修改时间
reported_time	历史报告时间
hot_sys_var_version	热更新的系统变量版本
sys_var_version	系统变量版本
user_var_version	用户变量版本
last_insert_id_version	最后插入 ID 版本
db_name_version	数据库名的版本
server_ip	OBServer 的 IP 地址
server_port	OBServer 的端口号
server_sessid	OBServer 的会话 ID 号
ss_id	OBProxy 标记 Server Session的 ID 号