对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

db.shutdownServer()(mongosh方法)

在版本5.0中进行了更改。

db.shutdownServer()

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

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

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

该方法采用以下字段:

字段
说明

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

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

可选。

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

如果一个 mongod 主节点收到关闭请求,则主节点:

  1. 尝试降级到从节点。

    如果降级失败,并且:

  2. 进入静默期。

  3. 结束所有剩余的数据库操作。

  4. 关闭。

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

静止期由以下各项指定:

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

timeoutSecs 指定一个时间段(以秒为单位)。默认为:

  • 从 MongoDB 5.0 开始为 15 秒。

  • 在 MongoDB 5.0 以前的版本中为 10 秒。

mongod 使用 timeoutSecs,如下所示:

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

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

此方法可用于以下环境中托管的部署:

重要

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

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

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

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

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

如果一个 mongod 主节点收到关闭请求,则主节点:

  1. 尝试降级到从节点。

    如果降级失败,并且:

  2. 进入静默期。

  3. 结束所有剩余的数据库操作。

  4. 关闭。

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

静止期由以下各项指定:

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

timeoutSecs 指定一个时间段(以秒为单位)。默认为:

  • 从 MongoDB 5.0 开始为 15 秒。

  • 在 MongoDB 5.0 以前的版本中为 10 秒。

mongod 使用 timeoutSecs,如下所示:

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

警告

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

要在 mongod 上运行db.shutdownServer() 以对自托管部署实施身份验证,经过身份验证的用户必须具有db.shutdownServer()权限。示例,具有内置角色hostManager 的用户就拥有相应的权限。

db.getSiblingDB("admin").shutdownServer()
db.getSiblingDB("admin").shutdownServer({ "force" : true })
db.getSiblingDB("admin").shutdownServer({ "timeoutSecs": 60 })
给本页内容打分