killCursors
定义
killCursors
终止集合的一个或多个指定游标。 MongoDB 驱动程序使用
killCursors
命令作为客户端游标实现的一部分。注意
一般来说,应用程序不应直接使用
killCursors
命令。必须针对要终止其游标的集合的数据库运行
killCursors
命令。要运行killCursors,请使用
db.runCommand( { <command> } )
方法。
兼容性
此命令可用于以下环境中托管的部署:
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
注意
所有 MongoDB Atlas 集群都支持此命令。有关所有命令的信息,请参阅不支持的命令。
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
该命令具有以下语法:
db.runCommand( { killCursors: <collection>, cursors: [ <cursor id1>, ... ], comment: <any> } )
命令字段
该命令接受以下字段:
字段 | 类型 | 说明 |
---|---|---|
killCursors | 字符串 | 集合的名称。 |
cursors | 阵列 | 要终止的游标的 ID。 |
comment | any | 可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:
注释可以是任何有效的 BSON 类型(字符串、整型、对象、数组等)。 |
必需的访问权限
终止自身游标
无论用户是否具有killCursors
的特权,用户始终可以终止自己的游标。 创建游标时,游标与用户相关联。
终止任何游标
如果用户拥有killAnyCursor
权限,则该用户可以终止任何游标,甚至是其他用户创建的游标。
killCursors
和事务
您不能将killCursors
指定为事务中的第一个操作。
例子
考虑对collection执行以下find
test.restaurants
操作:
use test db.runCommand( { find: "restaurants", filter: { stars: 5 }, projection: { name: 1, rating: 1, address: 1 }, sort: { name: 1 }, batchSize: 5 } )
返回以下内容:
{ "waitedMS" : NumberLong(0), "cursor" : { "firstBatch" : [ { "_id" : ObjectId("57506d63f578028074723dfd"), "name" : "Cakes and more" }, { "_id" : ObjectId("57506d63f578028074723e0b"), "name" : "Pies and things" }, { "_id" : ObjectId("57506d63f578028074723e1d"), "name" : "Ice Cream Parlour" }, { "_id" : ObjectId("57506d63f578028074723e65"), "name" : "Cream Puffs" }, { "_id" : ObjectId("57506d63f578028074723e66"), "name" : "Cakes and Rolls" } ], "id" : NumberLong("18314637080"), "ns" : "test.restaurants" }, "ok" : 1 }
要终止此游标,请使用killCursors
命令。
use test db.runCommand( { killCursors: "restaurants", cursors: [ NumberLong("18314637080") ] } )
killCursors
返回以下操作详细信息:
{ "cursorsKilled" : [ NumberLong("18314637080") ], "cursorsNotFound" : [ ], "cursorsAlive" : [ ], "cursorsUnknown" : [ ], "ok" : 1 }