setUserWriteBlockMode

Definição

setUserWriteBlockMode

Novidades na versão 6.0.

O comando setUserWriteBlockMode bloqueia e desbloqueia gravações em todo o cluster.

Durante a sincronização de cluster para cluster, o mongosync, a ferramenta de sincronização de cluster para cluster, usa o comando setUserWriteBlockMode para bloquear gravações no cluster de destino. Para obter mais informações, consulte o comandoiniciar da API HTTP.

Observação

Usuários e aplicativos com o privilégio bypassWriteBlockingMode podem ignorar o bloqueio e continuar a executar gravações.

Sintaxe

O comando tem a seguinte sintaxe:

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

Campos de comando

O comando utiliza os seguintes campos:

Acesso obrigatório

Para executar o comando setUserWriteBlockMode , o usuário deve ter o privilégio do setUserWriteBlockMode .

Exemplo

1. Habilitar o modo de bloqueio de escrita do usuário:

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

2. Adicionar um registro à collection:

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

   O servidor bloqueia a gravação porque o bloqueio de escrita do usuário está habilitado.

   Exemplo de saída:

   MongoServerError: User writes blocked

3. Desativar o modo de bloqueio de escrita do usuário:

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

4. Adicionar um registro à collection:

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

   O método insertOne() escreve em uma collection. O servidor permite a gravação porque o bloco de gravação do usuário está desabilitado.