文档首页/ 文档数据库服务 DDS/ API参考/ API v3（推荐）/ 连接管理/ 查询实例节点会话
更新时间：2024-10-31 GMT+08:00
查看PDF
分享

查询实例节点会话

接口说明

查询实例节点会话。

约束说明

支持版本为3.4、4.0、4.2、4.4和5.0的社区版实例。

调试

您可以在API Explorer中调试该接口。

URI

  • URI格式

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

  • URI样例

    https://dds.cn-north-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文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题： 连接管理

相关文档