---
title: "SHOW PROXYPS - 数据库代理  V4.3.3 | OceanBase 文档中心"
description: SHOW PROXYPS 描述 该语句用于展示 prepare-statement（PS）协议使用场景中 PS 缓存信息。 权限要求 普通用户仅能查询属于同一用户的 PS 缓存信息。例如配置 cs_id 进行查询时，只有 cs_id 对应的客户端会话与当前用户属于同一用户时，查询才被允许执行。 对于 sys 租户和 …
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*nSAhQbrBXKwAAAAAAAAAAAAADiGDAQ/original) 数据库代理 V 4.3.3

# SHOW PROXYPS

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

[编辑](https://github.com/oceanbase/oceanbase-proxy-doc/edit/V4.3.3/zh-CN/660.odp-command/20.odp-proprietary-commands/400.show/1000.show-proxyps.md)  

## 描述

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

## 权限要求

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

## 语法

```sql
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 查询

  ```sql
  SHOW PROXYPS 1 like '%select%';

  ```

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

  `SHOW PROXYPS` 命令输出如下：

  ```shell
  +-------+--------------+-------------+-------+---------+-------------+--------------+-----------+--------------+
  | 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 和租户查询

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

  ```

  输出如下：

  ```

### 字段介绍

| 列名 | 含义 |
| --- | --- |
| 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 数量。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线