flushRouterConfig（数据库命令）

定义

flushRouterConfig

flushRouterConfig分片集群的缓存路由表标记为过时，导致请求路由表的下一个操作刷新缓存。路由表缓存的管理通常由集群自动处理。您应该只需要在特定实例中手动运行flushRouterConfig 命令，如注意事项中所示。

兼容性

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

• MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

flushRouterConfig在mongos 和mongod 实例上都可用，并具有以下事务语法：

• 在集合命名空间参数中传递时，刷新指定集合的缓存：

  db.adminCommand(
     {
       flushRouterConfig: "<db.collection>"
     }
  )

• 在数据库命名空间参数中传递时，刷新指定数据库及其所有collection的缓存：

  db.adminCommand(
     {
       flushRouterConfig: "<db>"
     }
  )

• 在不带参数运行或传入非字符串标量值（例如 1 ）：

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

访问控制

flushRouterConfig 命令需要对 cluster资源执行 flushRouterConfig权限动作。

具有以下角色的用户也可以执行此权限操作：

• clusterManager

• hostManager

Considerations

一般情况下，分片集群的路由表会作为正常操作的一部分，根据需要自动刷新。但是，在运行命令 之前，您应手动发出命令flushRouterConfig db.collection.getShardDistribution()。这可确保该命令返回最新信息。