db.adminCommand（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 数据库方法 > db.adminCommand（）

在本页面

定义
行为
响应
例子

定义¶

db.adminCommand（命令）¶

提供帮助程序以对数据库运行指定的数据库命令admin。

参数	类型	描述
`command`	文件或字串	甲数据库命令，无论是在指定的文件形式或作为字符串。如果指定为字符串，则该命令不能包含任何参数。

行为¶

db.adminCommandadmin 不管数据库运行在哪个数据库上下文中，都对数据库运行命令。以下命令是等效的：

复制

db.getSiblingDB("admin").runCommand(<command>)

db.adminCommand(<command>)

有关可用管理数据库命令的列表，请参见“ 管理命令”。

注意

对于mongod或mongos与一起运行 authorization，授权用户必须具有适当的特权才能运行数据库命令。有关安全要求的更多信息，请参见该命令的参考文档。

响应¶

该方法返回包含以下字段的响应文档：

领域	描述
特定于命令的结果字段
`ok`	一个数字，指示命令是成功（`1`）还是失败（`0`）。
`operationTime`	执行的操作的逻辑时间，在MongoDB中用oplog条目中的时间戳表示。仅适用于副本集和分片群集如果该命令未生成操作日志条目，例如读取操作，则该操作不会超前逻辑时钟。在这种情况下，`operationTime`返回：对于阅读的关注`"local"`，是oplog中最新条目的时间戳。出于阅读关注`"majority"`和 `"linearizable"`，操作`majority-acknowledged` 日志中最新条目的时间戳。对于与因果关系一致的会话相关的操作，MongoDB驱动程序将使用此时间自动设置读取操作和afterClusterTime。 3.6版的新功能。
`$clusterTime`	返回签名的群集时间的文档。群集时间是用于对操作进行排序的逻辑时间。仅适用于副本集和分片群集。仅限内部使用。该文档包含以下字段： `clusterTime`：成员的已知最高群集时间的时间戳。 `signature`：一个文档，其中包含集群时间的哈希值和用于签署集群时间的密钥的ID。 3.6版的新功能。

例子¶

killOp ¶

以下示例使用该db.adminCommand() 方法执行killOp命令以终止操作。是管理命令，必须针对数据库运行。opid 724killOpadmin

复制

db.adminCommand( { "killOp": 1, "op": 724 } )

renameCollection ¶

以下示例用于db.adminCommand()执行renameCollection管理数据库命令，以将数据库中的orders集合重命名test为 orders-2016。

复制

db.adminCommand(
  {
     renameCollection: "test.orders",
     to: "test.orders-2016"
  }
)

的createUser ¶

下面的示例使用该db.adminCommand()方法创建一个在数据库上bruce具有该dbOwner角色的用户admin。

小费

从mongoShell的4.2版本开始，您可以将该passwordPrompt()方法与各种用户身份验证/管理方法/命令结合使用，以提示输入密码，而不是直接在方法/命令调用中指定密码。但是，您仍然可以像在早期版本的mongoShell中一样直接指定密码。

复制

db.adminCommand(
  {
    createUser: "bruce",
    pwd: passwordPrompt(),  // or <cleartext password>
    roles: [
      { role: "dbOwner", db: "admin" }
    ]
  }
)