setUserWriteBlockMode
Definição
setUserWriteBlockMode
Novidades na versão 6.0.
O comando
setUserWriteBlockMode
bloqueia e desbloqueia gravações em todo o cluster.Durante Cluster-to-Cluster Sync, o
mongosync
, a ferramenta de sincronização de cluster para cluster, usa o comandosetUserWriteBlockMode
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 realizando gravações.
Sintaxe
O comando tem a seguinte sintaxe:
db.adminCommand( { setUserWriteBlockMode: 1, global: <boolean> } )
Campos de comando
O comando utiliza os seguintes campos:
Campo | Tipo | Descrição |
---|---|---|
setUserWriteBlockMode | inteiro | Defina este campo como 1 . |
global | booleano | Bloqueia gravações em um cluster quando definido como true . Para habilitar gravações em um cluster, defina global: false . |
Acesso necessário
Para executar o comando setUserWriteBlockMode
, o usuário deve ter o privilégio do setUserWriteBlockMode
.
Exemplo
Habilitar o modo de bloqueio de escrita do usuário:
db.adminCommand( { setUserWriteBlockMode: 1, global: true } ) 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 Desativar o modo de bloqueio de escrita do usuário:
db.adminCommand( { setUserWriteBlockMode: 1, global: false } ) 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.