SHOW PROXYPS - 数据库代理 V4.3.3 | OceanBase 文档中心

SHOW PROXYPS

更新时间：2026-04-14 09:41:03

描述

该语句用于展示 prepare-statement（PS）协议使用场景中 PS 缓存信息。

权限要求

普通用户仅能查询属于同一用户的 PS 缓存信息。例如配置 cs_id 进行查询时，只有 cs_id 对应的客户端会话与当前用户属于同一用户时，查询才被允许执行。
对于 sys 租户和 root@proxysys 用户，可查看任意用户的 PS 缓存信息。

语法

SHOW PROXYPS [cs_id] [like "sql"] [tenant like "tenant_name"] [DETAIL];

参数解释

参数	描述
SHOW PROXYPS	展示 PS 缓存信息。sys 租户或 root@proxysys 用户直接执行 `SHOW PROXYPS;`，表示展示全部 PS 缓存信息。普通用户直接执行 `SHOW PROXYPS;`，仅展示当前用户正在使用的 PS 缓存信息。
cs_id	可选项，通过 cs_id 查询 PS 缓存信息。cs_id 为 ODP 内标记每个 Client Session 的 ID 号，可以通过 `SHOW PROCESSLIST;` 或者 `SHOW PROXYSESSION;` 命令查询，输出中的 `Id` 即为 cs_id。
like "sql"	可选项，通过 SQL 查询 PS 缓存信息。支持配置 `_` 模糊查找单个字符、`%` 模糊查找多个字符。
tenant like "tenant_name"	可选项，通过租户名查询 PS 缓存信息。支持配置 `_` 模糊查找单个字符、`%` 模糊查找多个字符。
DETAIL	可选项，控制是否显示 PS 语句的 SQL 和解析结果。

示例

指定 cd_id 和 SQL 查询

SHOW PROXYPS 1 like '%select%';

此处以 cs_id 为 1 举例，实际环境中可执行 SHOW PROCESSLIST; 或者 SHOW PROXYSESSION; 命令查询，输出中的 Id 即为 cs_id。

SHOW PROXYPS 命令输出如下：

+-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+
| cs_id | cluster_name | tanant_name | ps_id | ps_name | prepare_sql | parse_result | used_mem  | used_session |
+-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+
| 1     | obcluster    | mysql       |  -1   | PS1     | NULL        | NULL         | 10533     |  1           |
+-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+

指定 SQL 和租户查询

SHOW PROXYPS like '%select%' tenant like '%mysql%';

输出如下：

+-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+
| cs_id | cluster_name | tanant_name | ps_id | ps_name | prepare_sql | parse_result | used_mem  | used_session |
+-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+
| 1     | obcluster    | mysql       |  -1   | PS1     | NULL        | NULL         | 10533     |  1           |
+-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+

字段介绍

列名	含义
cs_id	PS 缓存对应的客户端会话 ID。只有当 `SHOW PROXYPS` 命令指定了 `cs_id` 或者租户名才存在实际值，否则输出 `-1`。
cluster_name	PS 缓存对应的集群名，只有当 `SHOW PROXYPS` 命令指定了 `cs_id` 或者租户名才存在实际值，否则输出为空。
tenant_name	PS 缓存对应的租户名，只有当 `SHOW PROXYPS` 命令指定了 `cs_id` 或者租户名才存在实际值，否则输出为空。
ps_id	PS 缓存对应的 PS ID，只有当 `SHOW PROXYPS` 命令指定了 `cs_id` 或者租户名，并且是二进制协议的 PS 语句时，该字段才有实际值。
ps_name	PS 缓存对应的 ps name，只有当 `SHOW PROXYPS` 命令指定了 `cs_id` 或者租户名，并且是文本协议的 PS 语句时，该字段才有实际值。
prepare_sql	PS 缓存对应的 PS SQL，当 `SHOW PROXYPS` 存在 `detail` 字段时，该字段才有值。
parse_result	PS 缓存对应的 PS SQL 解析结果，当 `SHOW PROXYPS` 存在 `detail` 字段时，该字段才有值。
used_mem	PS 缓存使用的内存值。
used_session	PS 缓存被同时使用的 Session 数量。