/ /

/ /

shutdown（数据库命令）

5.0 版本中的更改。

shutdown: shutdown 命令会清理所有数据库资源，然后终止进程。shutdown您必须针对管理员数据库发出命令。

兼容性

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

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

重要

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

语法

该命令具有以下语法：

db.adminCommand(
   {
     shutdown: 1,
     force: <boolean>
     timeoutSecs: <int>,
     comment: <any>
   }
)

命令字段

该命令使用以下字段：

字段	说明
shutdown	指定 `1` 。
force	可选。指定 `true` 以强制关闭 `mongod` 或 `mongos`。强制关闭会中断 `mongod` 或 `mongos` 上正在进行的任何操作，并可能导致意外行为。您可以使用 `force` 暂停和恢复正在进行的索引构建。 `shutdown`有关更多信息，请参阅有关副本集节点的。
timeoutSecs	可选。从 MongoDB 5.0 开始，`mongod` 和 `mongos` 进入静默期，以允许所有正在进行的数据库操作在关闭之前完成。如果一个 `mongod` 主节点收到关闭请求，则主节点：尝试降级到从节点。如果降级失败，并且：运行了 `shutdown` 或 `db.shutdownServer()` 命令，如果字段为 true，`mongod` 仅继续执行关闭步骤，或者 `SIGTERM` 信号已发送到 `mongod`，`mongod` 始终继续执行关闭步骤。进入静默期。结束所有剩余的数据库操作。关闭。对于 `mongod` 从节点或 `mongos` 关闭请求，在请求关闭之后进入静默期。静止期由以下各项指定： timeoutSecs字段（如果运行了 `shutdown`或`db.shutdownServer()` 命令），或者 `shutdownTimeoutMillisForSignaledShutdown` 服务器参数（如果 `SIGTERM` 信号已发送到 `mongod`），或者 `mongosShutdownTimeoutMillisForSignaledShutdown` 服务器参数（如果将 `SIGTERM` 信号发送到 `mongos`）。 `mongod` 或 `mongos` 关闭时，客户端无法新建相关连接。 timeoutSecs 指定一个时间段（以秒为单位）。默认为：从 MongoDB 5.0 开始为 15 秒。在 MongoDB 5.0 以前的版本中为 10 秒。 `mongod`使用 timeoutSecs，如下所示：如果当前节点是副本集的主节点 (primary node in`mongod` the replica set)节点，则会等待 timeoutSecs字段指定的秒数，让可选举节点赶上主节点，然后再降级主节点 (primary node in the replica set)节点。有关追赶时间的详细信息，请参阅复制延迟。如果当前节点在降级主节点 (primary node in`SECONDARY` the replica set)节点后处于状态，则 timeoutSecs 中指定的任何剩余时间将用于静默期，以便完成现有操作。新操作将发送到其他副本集节点。从MongoDB5.0 开始，`mongos` 使用 timeoutSecs 作为静默期，以允许完成现有操作。新操作将发送到其他`mongos` 节点。在 5.0 之前的MongoDB版本中， `mongos`会立即关闭且不使用 timeoutSecs 。
`comment`	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 `attr.command.cursor.comment` 字段中。 `command.comment` 字段中的数据库分析器输出。 `currentOp` 输出，在 `command.comment` 字段。注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

提示

db.shutdownServer()

行为

对于mongod 在自托管部署上使用身份验证启动shutdown 的，您必须通过经过身份验证的连接运行。有关详细信息，请参阅访问控制。

对于在自管理部署上mongod shutdown启动 但未进行身份验证的，您必须从连接到本地主机接口的客户端运行。示例，在与相同的托管上运行带有选项的mongosh --host "127.0.0.1"{mongod 。

`shutdown` （针对副本集节点）

如果副本集节点正在运行某些操作（例如索引构建），则 shutdown 将失败。您可以指定 force: true 来强制节点将索引构建进度保存到磁盘。mongod 在重新启动时会恢复索引构建，并从保存的检查点继续运行。

关闭副本集主节点、从节点或 `mongos`

从 MongoDB 5.0 开始，mongod 和 mongos 进入静默期，以允许所有正在进行的数据库操作在关闭之前完成。

如果一个 mongod 主节点收到关闭请求，则主节点：

尝试降级到从节点。
如果降级失败，并且：
- shutdown 或 db.shutdownServer() 命令已运行，仅当 mongod force 字段为 True 时，才会继续执行关闭步骤，或
- SIGTERM 信号已发送到 mongod，mongod 始终继续执行关闭步骤。
进入静默期。
结束所有剩余的数据库操作。
关闭。

对于 mongod 从节点或 mongos 关闭请求，在请求关闭之后进入静默期。

静止期由以下各项指定：

timeoutSecs 字段，如果运行的是 shutdown 或 db.shutdownServer() 命令，或
shutdownTimeoutMillisForSignaledShutdown 服务器参数（如果 SIGTERM 信号已发送到 mongod），或者
mongosShutdownTimeoutMillisForSignaledShutdown 服务器参数（如果将 SIGTERM 信号发送到 mongos）。

mongod 或 mongos 关闭时，客户端无法新建相关连接。

timeoutSecs指定了一个时间段（以秒为单位）。默认为：

从 MongoDB 5.0 开始为 15 秒。
在 MongoDB 5.0 以前的版本中为 10 秒。

mongod 按如下方式使用 timeoutSecs：

如果当前节点是副本集的主节点，则 mongod 会等待 timeoutSecs 字段指定的秒数，以便可选举节点跟上，然后再降级主节点。有关追赶时间的详情，请参阅复制延迟。
如果当前节点在退出主节点后处于SECONDARY状态，则 timeoutSecs 中指定的任何剩余时间将作为静默期，以允许完成现有操作。新操作将发送到其他副本集节点。

从 MongoDB 5.0 开始，mongos 使用 TimeoutSecs 作为静默期，这会允许现有操作完成。新操作将发送到其他 mongos 节点。在 MongoDB 5.0 以前的版本中，mongos 立即关闭并且不使用 timeoutSecs。

警告

强制关闭主节点可能会导致所有尚未复制到从节点的写入操作发生回滚。

访问控制

要在实施对自管理部署进行身份验证的 mongod 上运行 shutdown，经过身份验证的用户必须具有 shutdown权限。例如，具有内置角色 hostManager 的用户拥有适当权限。

示例

关闭 `mongod`

db.adminCommand({ "shutdown" : 1 })

强制关闭 `mongod`

db.adminCommand({ "shutdown" : 1, "force" : true })

关闭超时时间较长的主节点 `mongod`

db.adminCommand({ "shutdown" : 1, timeoutSecs: 60 })

后退

setUserWriteBlockMode

来年

诊断

兼容性

重要

语法

命令字段

提示

行为

shutdown （针对副本集节点）

关闭副本集主节点、从节点或 mongos

警告

访问控制

示例

关闭 mongod

强制关闭 mongod

关闭超时时间较长的主节点 mongod

`shutdown` （针对副本集节点）

关闭副本集主节点、从节点或 `mongos`

关闭 `mongod`

强制关闭 `mongod`

关闭超时时间较长的主节点 `mongod`