dropConnections（数据库命令）

定义

dropConnections: dropConnections命令删除mongod /mongos 实例到指定主机的传出连接。dropConnections 必须针对admin 数据库运行。

兼容性

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

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令的语法如下：

db.adminCommand(
   {
     dropConnections: 1,
     hostAndPort : [ "host1:port1", "host2:port2", ... ],
     comment: <any>
   }
)

命令字段

该命令需要以下字段：

字段	类型	说明
`hostAndPort`	阵列	每个数组元素代表远程计算机的主机名和端口。
`comment`	any	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 `attr.command.cursor.comment` 字段中。 `command.comment` 字段中的数据库分析器输出。 `currentOp` 输出，在 `command.comment` 字段。注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

访问控制

If the deployment enforces authentication/authorization, the dropConnections command requires the dropConnections action on the cluster resource.

在admin数据库中创建用户定义的角色，其中privilege数组包含以下文档：

{ "resource" : { "cluster" : true } }, "actions" : [ "dropConnections" ] }

使用db.createUser()在admin数据库上创建具有自定义角色的用户。

or
使用db.grantRolesToUser()将角色授予admin数据库中的现有用户。

For example, the following operation creates a user-defined role on the admin database with the privileges to support dropConnections:

db.getSiblingDB("admin").createRole(
  {
    "role" : "dropConnectionsRole",
    "privileges" : [
      {
        "resource" : { "cluster" : true },
        "actions" : [ "dropConnections" ]
      }
    ],
    "roles" : []
  }
)

将自定义角色分配给admin数据库中的用户：

db.getSiblingDB("admin").createUser(
  {
    "user" : "dropConnectionsUser",
    "pwd" : "replaceThisWithASecurePassword",
    "roles" : [ "dropConnectionsRole" ]
  }
)

创建的用户可以执行dropConnections 。

有关用户创建的更多示例，请参阅在自托管部署上创建用户。有关向现有数据库用户添加权限的教程，请参阅修改现有用户的访问权限。

行为

dropConnectionshostAndPort静默忽略不包含远程计算机主机名和端口的元素。

例子

考虑一个副本集，其成员最近在oldhost.example.com:27017 中删除。对每个活动的副本集节点运行以下dropConnections 命令，可确保没有指向oldhost.example.com:27017 的剩余传出连接：

db.adminCommand(
  {
    "dropConnections" : 1,
    "hostAndPort" : [
      "oldhost.example.com:27017"
    ]
  }
)

该命令返回类似以下的输出：

{
 "ok" : 1,
 "$clusterTime" : {
   "clusterTime" : Timestamp(1551375968, 1),
   "signature" : {
     "hash" : BinData(0,"AAAAAAAAAAAAAAAAAAAAAAAAAAA="),
     "keyId" : Long(0)
   }
 },
 "operationTime" : Timestamp(1551375968, 1)
}

您可以使用命令确认mongod 或mongos connPoolStats连接池的状态。