更新时间:2024-11-28 GMT+08:00

查询实例节点会话

接口说明

查询实例节点会话。

约束说明

支持3.4及以上版本的社区版实例。

URI

  • URI格式

    GET https://{Endpoint}/v3/{project_id}/nodes/{node_id}/sessions

  • URI样例

    https://ap-southeast-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/nodes/520c58ba00a3497e97ce0b9604874dd6no02/sessions

请求参数

参数说明

表1 请求参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

从IAM服务获取的用户Token。请参考认证鉴权

project_id

string

path

租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。

node_id

string

path

节点ID。

  • 集群实例支持选择mongos、shard、config中的任意节点。
  • 副本集实例选择Primary或者Secondary节点。
表2 Query参数

参数

参数类型

是否必选

描述

offset

Integer

索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

limit

Integer

查询记录数。取值范围[1, 100],默认10(表示返回10条数据)。

plan_summary

String

执行计划描述。取空值表示查询plan_summary为空的会话。也可指定执行计划,例如:COLLSCAN IXSCAN FETCH SORT LIMIT SKIP COUNT COUNT_SCAN TEXT PROJECTION

type

String

操作类型。取空值表示查询type为空的会话。也可指定操作类型,例如:none update insert query command getmore remove killcursors

namespace

String

命名空间。取空值表示查询namespace为空的会话,也可根据当前业务进行指定。

cost_time

Integer

运行时间,单位为us。取空值表示查询cost_time为空的会话,也可根据当前业务需要进行配置,表示查询超出cost_time 的会话。

响应参数

  • 参数说明
    表3 响应Body参数

    参数

    参数类型

    是否必选

    描述

    total_count

    Integer

    总记录数。

    sessions

    Array of objects

    具体信息。详情请参见表 QuerySessionResponse

    表4 session字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    会话ID。

    active

    Boolean

    当前会话是否活跃。取值为“true”,表示活跃。取值为“false”,表示不活跃。

    operation

    String

    操作。

    type

    String

    操作类型。

    cost_time

    String

    运行时间,单位为us。

    plan_summary

    String

    执行计划描述。

    host

    String

    主机。

    client

    String

    客户端地址。

    description

    String

    连接描述。

    namespace

    String

    命名空间。

响应示例

{ 
  "total_count" : 1, 
  "sessions" : [ { 
    "id" : "shard_1:7201646", 
    "active" : true, 
    "operation" : "{\"getMore\":4.9473050217983027E18,\"collection\":\"$cmd.aggregate\",\"batchSize\":101.0,\"lsid\":{\"id\":{\"$binary\":{\"base64\":\"9FhcBFVeTzafCH8BUZrLjQ\\=\\=\",\"subType\":\"03\"}},\"uid\":{\"$binary\":{\"base64\":\"O0CMtIVItQN4IsEOsJdrPL8s7jv5xwh5a/A5Qfvs2A8\\=\",\"subType\":\"00\"}}},\"$clusterTime\":{\"clusterTime\":{\"$timestamp\":{\"t\":1.614047961E9,\"i\":1.0}},\"signature\":{\"hash\":{\"$binary\":{\"base64\":\"HxUWu68VyfvQFivWjHQDdJj/3YQ\\=\",\"subType\":\"00\"}},\"keyId\":6.9312672235666801E18}},\"$client\":{\"driver\":{\"name\":\"PyMongo\",\"version\":\"3.6.1\"},\"os\":{\"type\":\"Linux\",\"name\":\"Linux\",\"architecture\":\"x86_64\",\"version\":\"4.18.0-147.5.1.0.h269.eulerosv2r9.x86_64\"},\"platform\":\"CPython 3.7.4.final.0\",\"mongos\":{\"host\":\"host-172-16-61-110:8635\",\"client\":\"127.0.0.1:33420\",\"version\":\"4.0.3\"}},\"$configServerState\":{\"opTime\":{\"ts\":{\"$timestamp\":{\"t\":1.614047961E9,\"i\":1.0}},\"t\":2.0}},\"$db\":\"admin\"}", 
    "type" : "getmore", 
    "cost_time" : "25", 
    "plan_summary" : "COLLSCAN", 
    "host" : "host-172-16-27-182:8635", 
    "client" : "172.16.41.233:50700", 
    "description" : "conn20", 
    "namespace" : "admin.$cmd.aggregate" 
  } ] 
}

SDK

单击文档数据库服务 DDS SDK,下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码

错误码

详情请参见错误码