setDefaultRWConcern

Definição

setDefaultRWConcern

O comando administrativo setDefaultRWConcern define a configuração global de read ou write concern padrão para um conjunto de réplicas ou cluster fragmentado. setDefaultRWConcern deve ser executado no banco de dados admin .

• Para conjuntos de réplicas, emita o comando setDefaultRWConcern no primary mongod.

• Para clusters fragmentados, emita o setDefaultRWConcern em um mongos.

setDefaultRWConcern tem o seguinte formato:

db.adminCommand(
  {
    setDefaultRWConcern : 1,
    defaultReadConcern: { <read concern> },
    defaultWriteConcern: { <write concern> },
    writeConcern: { <write concern> },
    comment: <any>
  }
)

setDefaultRWConcern tem os seguintes campos:

Campo	Tipo	Descrição
setDefaultRWConcern	int	Defina como 1.
defaultReadConcern	object	Documento que contém a configuração global de read concern. Especifique um objeto de read concern válido. setDefaultRWConcern oferece suporte ao seguinte subconjunto de nível: "local" "available" "majority" Para cancelar o read concern padrão atualmente configurado, especifique um documento vazio {}. setDefaultRWConcern oferece suporte apenas à configuração levels read concern. Não é possível especificar nenhuma outra configuração de read concern no read concern padrão. Omita este documento para deixar inalterada o atual write concern global. Se omitido, setDefaultRWConcern deve especificar defaultWriteConcern.
defaultWriteConcern	object	Documento que contém a configuração de write concern padrão global. Para a configuração de write concern w , setDefaultRWConcern oferece suporte a todos os valores de write concern , exceto w : 0. Para a configuração de tempo limite de write concern , setDefaultRWConcern tem como padrão 0 se a configuração for omitida. As operações são bloqueadas até que o write concern solicitado seja atendido. Se estiver especificando um padrão global wtimeout, certifique-se de que o valor seja grande o suficiente para permitir que as operações de gravação atinjam o write concern solicitado. Para desmarcar o write concern configurado no momento, especifique um documento vazio {}. Omita este documento para deixar o atual write concern global inalterado. Se omitido, setDefaultRWConcern deve especificar defaultReadConcern.
Escreva preocupação	objeto	Opcional. Documento que especifica o write concern a ser usado pelo próprio comando setDefaultRWConcern . Se omitido, o setDefaultRWConcern usa o write concern padrão global definido anteriormente se houver um configurado.
comment	qualquer	Opcional. Um comentário fornecido pelo usuário para anexar a este comando. Depois de definido, esse comentário aparece junto com os registros desse comando nos seguintes locais: mensagens de log do mongod, no campo attr.command.cursor.comment. Saída do perfil do banco de dados, no campo command.comment. Saída de currentOp, no campo command.comment. Um comentário pode ser qualquer tipo BSON válido (string, inteiro, objeto, array etc).

setDefaultRWConcern retorna um objeto que contém o read ou write concern padrão global configurado no momento. Consulte getDefaultRWConcern para obter uma documentação mais completa sobre os campos retornados.

Comportamento

A partir do MongoDB 5.0, uma vez que o Cluster Wide Write Concern (CWWC) é definido por meio do comando setDefaultRWConcern , o write concern não pode ser desconfigurado.

O MongoDB só aplica o read ou write concern global padrão a operações que não especificam explicitamente um read ou write concern.

Se o MongoDB aplicar o read ou write concern padrão global a uma operação, essa operação se comportará como se esse read ou write concern fosse explicitamente especificado pelo cliente emissor.

Exemplo

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  }
})

{
  "defaultWriteConcern" : {
   "w" : 2
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultReadConcern" : { "level" : "majority" }
})

{
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultWriteConcern" : {
    "w" : 2
  },
  "defaultReadConcern" : { "level" : "majority" }
})

"defaultWriteConcern" : {
  "w" : 2
},
"defaultReadConcern" : {
  "level" : "majority"
}

{
  "defaultWriteConcern" : {
    "w" : "majority"
  },
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}

db.adminCommand({
  "setDefaultRWConcern" : 1,
  "defaultReadConcern" : {},
  "defaultWriteConcern" : {}
})

{
  "updateOpTime" : Timestamp(1586290895, 1),
  "updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
  "localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
  "ok" : 1,
  "$clusterTime" : { ... }
  "operationTime" : Timestamp(1586290925, 1)
}