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

db.shutdownServer()(mongosh方法)

在版本5.0中进行了更改。

db.shutdownServer()

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

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

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

该方法采用以下字段:

字段
说明

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

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

可选。

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

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

  1. 尝试降级到从节点。

    如果降级失败,并且:

    • 运行了 shutdowndb.shutdownServer() 命令,如果字段为 true,则 mongod 仅继续执行关闭步骤,或者

    • SIGTERM 信号已发送到 mongodmongod 始终继续执行关闭步骤。

  2. 进入静默期。

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

  4. 关闭。

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

静止期由以下各项指定:

mongodmongos 关闭时,客户端无法新建相关连接。

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

  • 从 MongoDB 5.0 开始为 15 秒。

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

mongod 按如下方式使用 timeoutSecs

  • 如果当前节点是副本集的主节点,则 mongod 会等待 timeoutSecs 字段指定的秒数,以便可选举节点跟上,然后再降级主节点。有关追赶时间的详情,请参阅复制延迟。

  • 如果当前节点在退出主节点后处于SECONDARY状态,则 timeoutSecs 中指定的任何剩余时间将作为静默期,以允许完成现有操作。新操作将发送到其他副本集节点。

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

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

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

重要

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

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

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

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

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

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

  1. 尝试降级到从节点。

    如果降级失败,并且:

    • 运行了 shutdowndb.shutdownServer() 命令,如果字段为 true,则 mongod 仅继续执行关闭步骤,或者

    • SIGTERM 信号已发送到 mongodmongod 始终继续执行关闭步骤。

  2. 进入静默期。

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

  4. 关闭。

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

静止期由以下各项指定:

mongodmongos 关闭时,客户端无法新建相关连接。

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

  • 从 MongoDB 5.0 开始为 15 秒。

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

mongod 按如下方式使用 timeoutSecs

  • 如果当前节点是副本集的主节点,则 mongod 会等待 timeoutSecs 字段指定的秒数,以便可选举节点跟上,然后再降级主节点。有关追赶时间的详情,请参阅复制延迟。

  • 如果当前节点在退出主节点后处于SECONDARY状态,则 timeoutSecs 中指定的任何剩余时间将作为静默期,以允许完成现有操作。新操作将发送到其他副本集节点。

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

警告

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

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

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