DescribeProcessStatsComposition - 查询会话信息_云数据库 OceanBase 版(OceanBase)-阿里云帮助中心

该接口用于查询会话信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
oceanbase:DescribeProcessStatsComposition	get	*Instance `acs:oceanbase:{#regionId}:{#accountId}:instance/{#InstanceId}`	无	无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	OceanBase 集群 ID。	ob317v4uif****
UId	string	否	OceanBase 数据库用户标识符。	139*************
TenantId	string	否	租户 ID。	t33h8y08k****
SqlText	string	否	SQL 语句，支持 LIKE 查询，可以只指定 SQL 语句的部分子句。	SELECT ** FROM WHERE = ? AND = ? ORDER BY ** ASC
ClientIp	string	否	客户端 IP。	127...*
ServerIp	string	否	服务器 IP。	127...*
Users	string	否	数据库用户名。	["test_user"]
Status	string	否	会话状态。	ACTIVE

返回参数

名称	类型	描述	示例值
	object	请求的返回结果。
RequestId	string	请求 ID。	EE205C00-30E4-**-**-87E3A8A2AA0C
Data	object	返回结果。
TotalSessionCount	integer	总会话数量。	100
ActiveSessionCount	integer	活跃会话数。	60
IdleSessionCount	integer	SLEEP 状态会话数量。	30
AllProcessList	array<object>	所有会话详细信息。
AllProcessList	object
SqlText	string	SQL 文本。	select * from c1 where id = 100;
TenantId	string	租户 ID。	test_mysql
Database	string	数据库名称。	c1
User	string	该会话所属的用户。	test_user
ExecuteTime	long	根据是否执行命令：如果是在接收请求后且在返回客户端之前，表示从接收请求到当前时间的间隔如果是非接受请求情况下的状态, 表示当前状态的持续时间单位为秒。	5
CpuTime	long	当前命令执行 CPU 使用时间单位：s。说明该字段从 V3.2.4 BP5 版本开始引入	1
ServerIp	string	服务器 IP 地址。	xx.xx.xx.xx
ClientIp	string	客户端 IP。	xx.xx.xx.xx
SessionId	long	会话 ID。	322441****
ProxySessId	string	如果当前客户端是 ODP，则本列展示 ODP 的 Session ID。	7521015416********
Command	string	该会话正在执行的命令。	Query
Status	string	该会话当前的状态。	ACTIVE
SqlId	string	SQL ID。	45CCBDC7DEBDCDAXXXXAFC********
TraceId	string	Trace ID。	YB420XXX128-00062XXXX8313XXX1-X-X
PlanId	string	执行计划 ID。	1898
SessionStatistics	object	按照不同来源的会话统计。
UserStatistics	array<object>	按照用户维度的会话统计。
UserStatistics	object
MetricValue	string	用户名。	test_user
ActiveCount	long	活跃会话数量。	25
TotalCount	long	总数量。	30
Type	string	user。	user
SourceStatistics	array<object>	按照 Client 维度的会话统计。
SourceStatistics	object
MetricValue	string	用户客户端 IP。	xx.xx.xx.xx
ActiveCount	long	活跃会话数量。	25
TotalCount	long	总数量。	30
Type	string	client。	client
DataBaseStatistics	array<object>	按照数据库维度的会话统计。
DataBaseStatistics	object
MetricValue	string	数据库名。	test_database
ActiveCount	long	活跃会话数量。	25
TotalCount	long	总数量。	30
Type	string	database。	database
ObVersion	string	Ob 版本号	3.2.4

示例

正常返回示例

JSON格式

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": {
    "TotalSessionCount": 100,
    "ActiveSessionCount": 60,
    "IdleSessionCount": 30,
    "AllProcessList": [
      {
        "SqlText": "select * from c1 where id = 100;",
        "TenantId": "test_mysql",
        "Database": "c1",
        "User": "test_user",
        "ExecuteTime": 5,
        "CpuTime": 1,
        "ServerIp": "xx.xx.xx.xx",
        "ClientIp": "xx.xx.xx.xx",
        "SessionId": 0,
        "ProxySessId": "7521015416********",
        "Command": "Query",
        "Status": "ACTIVE",
        "SqlId": "45CCBDC7DEBDCDAXXXXAFC********",
        "TraceId": "YB420XXX128-00062XXXX8313XXX1-X-X",
        "PlanId": "1898"
      }
    ],
    "SessionStatistics": {
      "UserStatistics": [
        {
          "MetricValue": "test_user",
          "ActiveCount": 25,
          "TotalCount": 30,
          "Type": "user"
        }
      ],
      "SourceStatistics": [
        {
          "MetricValue": "xx.xx.xx.xx",
          "ActiveCount": 25,
          "TotalCount": 30,
          "Type": "client"
        }
      ],
      "DataBaseStatistics": [
        {
          "MetricValue": "test_database",
          "ActiveCount": 25,
          "TotalCount": 30,
          "Type": "database"
        }
      ]
    },
    "ObVersion": "3.2.4"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-05-27	OpenAPI 返回结构发生变更	查看变更详情