Docs Home → MongoDB Manual

setUserWriteBlockMode

On this page本页内容

Definition

setUserWriteBlockMode

New in version 6.0.

The setUserWriteBlockMode command blocks and unblocks writes to the entire cluster.

During cluster-to-cluster sync, mongosync, the cluster-to-cluster synchronization tool, uses the setUserWriteBlockMode command to block writes on the destination cluster. For more information, see the HTTP API start command.

Note

Users and applications with the bypassWriteBlockingMode privilege can bypass the block and continue to perform writes.

Syntax

The command has the following syntax:

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

Command Fields

The command takes the following fields:

FieldTypeDescription
setUserWriteBlockModeintegerSet this field to 1.
globalbooleanBlocks writes on a cluster when set to true. To enable writes on a cluster, set global: false.

Required Access

To execute the setUserWriteBlockMode command, the user must have the setUserWriteBlockMode privilege.

Example

  1. Enable user write block mode:

    db.adminCommand( {
       setUserWriteBlockMode: 1,
       global: true
    } )
  2. Add a record to the collection:

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

    The server blocks the write because the user write block is enabled.

    Example Output:

    MongoServerError: User writes blocked
  3. Disable user write block mode:

    db.adminCommand( {
       setUserWriteBlockMode: 1,
       global: false
    } )
  4. Add a record to the collection:

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

    The insertOne() method writes to a collection. The server allows the write because the user write block is disabled.