setUserWriteBlockMode

定义

setUserWriteBlockMode

6.0 版本中的新功能。

setUserWriteBlockMode命令会阻止和取消阻止对整个集群的写入。

在Cluster-to-Cluster Sync期间，mongosync（集群到集群同步工具）使用 setUserWriteBlockMode 命令阻止对目标集群的写入。 有关更多信息，请参阅 HTTP API 启动命令。

注意

具有 bypassWriteBlockingMode特权的用户和应用程序可以绕过该阻止并继续执行写入。

语法

该命令具有以下语法：

db.adminCommand(
   {
     setUserWriteBlockMode: 1,
     global: <boolean>
   }
)

命令字段

该命令接受以下字段：

必需的访问权限

要执行setUserWriteBlockMode命令，用户必须具有setUserWriteBlockMode特权。

例子

1. 启用用户写入阻止模式：

   db.adminCommand( {
      setUserWriteBlockMode: 1,
      global: true
   } )

2. 向collection添加一条记录：

   db.names.insertOne( { name: "George Washington Cable" } )

   服务器阻止写入，因为已启用用户写入阻止。

   示例输出：

   MongoServerError: User writes blocked

3. 禁用用户写入块模式：

   db.adminCommand( {
      setUserWriteBlockMode: 1,
      global: false
   } )

4. 向collection添加一条记录：

   db.names.insertOne( { name: "George Washington Cable" } )

   insertOne()方法可写入集合。 服务器允许写入，因为用户写入块已禁用。