db.shutdownServer()

在此页面上

行为

访问控制
举例

5.0 版本中的更改。

db.shutdownServer()

安全彻底地关闭当前的mongod 或mongos 进程。您必须对db.shutdownServer() 管理员数据库发出操作。

db.shutdownServer() 采用以下语法：

db.shutdownServer({
  force: <boolean>,
  timeoutSecs: <int>
})

该方法采用以下字段：

字段	说明
force	可选。指定 `true` 以强制关闭 `mongod` 或 `mongos`。强制关闭会中断 `mongod` 或 `mongos` 上正在进行的任何操作，并可能导致意外行为。您可以使用 `force` 暂停和恢复正在进行的索引构建。有关更多信息，请参阅 `db.shutdownServer()` 副本集节点。
timeoutSecs	可选。从 MongoDB 5.0 开始，`mongod` 和 `mongos` 进入静默期，以允许所有正在进行的数据库操作在关闭之前完成。如果一个 `mongod` 主节点收到关闭请求，则主节点：尝试降级到从节点。如果降级失败，并且：运行了`shutdown`或`db.shutdownServer()`命令， `mongod`仅在力场为 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。

字段

说明

force

可选。指定 true 以强制关闭 mongod 或 mongos。强制关闭会中断 mongod 或 mongos 上正在进行的任何操作，并可能导致意外行为。

您可以使用 force 暂停和恢复正在进行的索引构建。有关更多信息，请参阅 db.shutdownServer() 副本集节点。

timeoutSecs

可选。

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

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

尝试降级到从节点。
如果降级失败，并且：
- 运行了shutdown或db.shutdownServer()命令， mongod仅在力场为 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。

该操作为 shutdown 命令提供一个包装器。

行为

对于通过身份验证启动的 mongod，您必须通过经过身份验证的连接运行 db.shutdownServer()。有关详细信息，请参阅访问控制。

对于在没有身份验证的情况下启动的 mongod，必须从连接到 localhost 接口的客户端运行 db.shutdownServer()。例如，在与 mongod 相同的主机上运行 mongosh 并指定 --host "127.0.0.1" 选项。