Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
数据库命令
/
管理

killCursors

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 命令字段
  • 必需的访问权限
  • killCursors 和事务
  • 例子

定义

killCursors

终止集合的一个或多个指定游标。 MongoDB 驱动程序使用 killCursors命令作为客户端游标实现的一部分。

警告

应用程序通常不应直接运行killCursors命令。相反，让驾驶员自动处理游标管理。

必须针对要终止其游标的集合的数据库运行killCursors命令。

要运行killCursors，请使用 db.runCommand( { <command> } )方法。

兼容性

此命令可用于以下环境中托管的部署：

  • MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

注意

所有MongoDB Atlas集群都支持此命令。有关Atlas支持所有命令的信息，请参阅不支持的命令。

语法

该命令具有以下语法：

db.runCommand(
   {
     killCursors: <collection>,
     cursors: [ <cursor id1>, ... ], comment: <any>
   }
)

命令字段

该命令接受以下字段：

字段
类型
说明
killCursors
字符串
集合的名称。
cursors
阵列
要终止的游标的 ID。
comment
any

可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置：

注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

必需的访问权限

终止自身游标

无论用户是否具有killCursors权限，他们始终可以终止自己的游标。创建游标时，游标与用户相关联。

终止任何游标

如果用户具有killAnyCursor权限，则他们可以终止任何用户创建的游标。

Atlas所需访问权限

要查看哪些Atlas角色和权限授予killAnyCursor权限，请参阅Atlas文档中的内置角色和权限。

killCursors 和事务

不能将killCursors命令指定为ACID 事务中的第一个操作。

此外，如果在ACID 事务中运行killCursors命令，服务器会立即停止指定的游标。它不会等待ACID 事务提交。

例子

考虑对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
}

后退

getParameter

来年

killOp