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()命令，如果力场为 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：

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

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

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

行为

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

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