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

查询实例节点会话

接口说明

查询实例节点会话。

约束说明

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

URI

  • URI格式

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

表1 路径参数

名称

类型

IN

是否必选

描述

project_id

string

path

是

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

node_id

string

path

是

节点ID。

  • 集群实例选择mongos节点。
  • 副本集实例选择Primary或者Secondary节点。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。
表3 Query参数

参数

参数类型

是否必选

描述

offset

Integer

否

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

limit

Integer

否

查询记录数。取值范围[1, 20]，默认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 的会话。

响应参数

表4 响应Body参数

参数

参数类型

是否必选

描述

total_count

Integer

是

总记录数。

sessions

Array of objects

是

具体信息。详情请参见表 QuerySessionResponse。
表5 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" 
  } ] 
}

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题： 连接管理