/ /

/ /

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	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

アクセス制御

配置で認証/認可 dropConnections が強制される場合、dropConnections コマンドにはクラスターリソースに対するアクションが必要です。

privilege配列に次のドキュメントが含まれるadminデータベースにユーザー定義ロールを作成します。

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

db.createUser()を使用して、 adminデータベースにカスタムロールを持つユーザーを作成します。
or
db.grantRolesToUser()を使用して、 adminデータベース上の既存のユーザーにロールを付与します。

たとえば、次の操作では、 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" : Long(0)
   }
 },
 "operationTime" : Timestamp(1551375968, 1)
}

コマンドを使用して、mongod またはmongos connPoolStatsの接続プールのステータスを確認できます。

戻る

dropDatabase

dropIndexes