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

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

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

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

访问控制

如果部署强制执行身份验证/授权 ，则 dropConnections 命令需要对集群资源执行 dropConnections 操作。

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

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

示例，以下操作在admin数据库上创建一个用户定义的角色，并具有支持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。

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

行为

dropConnections 会自动忽略不包含远程计算机主机名和端口的 hostAndPort 元素。

例子

考虑一个副本集，其成员最近在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" : NumberLong(0)
   }
 },
 "operationTime" : Timestamp(1551375968, 1)
}

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

后退

dropDatabase

来年

dropIndexes