setDefaultRWConcern (comando de banco de dados)

Conjuntos de réplicas

Emita no setDefaultRWConcern conjunto de réplicas primary. O primary replica as novas configurações padrão globais para os nós restantes do conjunto de réplicas. Os secundários que ainda não replicaram as configurações padrão globais atualizadas continuam usando sua cópia "obsoleta" local dos padrões.

Emita o comando setDefaultRWConcern com um writeConcern de para garantir que o comando retorne somente após as alterações propagarem para a maioria dos nós do conjunto de w : "majority" réplicas.

Clusters fragmentados

EmitasetDefaultRWConcerncontra ummongosno cluster. Omongosmantém as configurações atualizadas no conjunto de réplicas do servidor de configuração (CSRS). Cadamongosemite periodicamente umgetDefaultRWConcernno CSRS para atualizar sua cópia local das configurações globais. Ummongosusa sua cópia local "obsoleta" dos padrões globais durante o período de tempo entre as atualizações.

Emita o comando setDefaultRWConcern com um writeConcern de para garantir que o comando retorne somente após as alterações propagarem para a maioria dos nós do w : "majority" CSRS.

Quando um aplicativo emite uma operação no mongos sem especificar explicitamente uma configuração de read ou write concern, o mongos aplica a configuração padrão global correspondente.

As configurações padrão globais não se propagam para os shards individuais. Você não pode executar em um setDefaultRWConcern shard.

Controle de acesso

Para conjuntos de réplicas ou clusters fragmentados que forçam autenticação em sistemas autogerenciados, setDefaultRWConcern exige que o usuário autenticado tenha a ação de setDefaultRWConcern privilégio.

O role integrado do fornece os privilégios exigidos para clusterManager executar setDefaultRWConcern o.

Definir write concern padrão global

A seguinte operação define o write concern global para o seguinte:

• w: 2

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

A operação retorna um documento semelhante ao seguinte:

{
  "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)
}

Definir read concern padrão global

A operação a seguir define o read concern global como "majority":

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

A operação retorna um documento semelhante ao seguinte:

{
  "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)
}

Definir read and write concern padrão global

A operação a seguir define o read ou write concern padrão global para o seguinte:

• w: 2 Escreva preocupação

• level: "majority" read concern.

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

A operação retorna um documento semelhante ao seguinte:

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

Desconfigurar read e write concern padrão global

Você pode:

• Desconfigure o read concern padrão global.

• Desconfigure apenas o write concern padrão global se você ainda não o tiver definido.

Por exemplo, suponha que o read concern padrão global esteja configurado para level: "majority". Para desconfigurar o read concern padrão global, use um documento vazio {}:

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

A operação retorna um documento que indica que a operação foi bem-sucedida:

{
   defaultReadConcern: { level: 'local' },
   defaultWriteConcern: { w: 2, wtimeout: 0 },
   updateOpTime: Timestamp({ t: 1656696934, i: 1 }),
   updateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   defaultWriteConcernSource: 'global',
   defaultReadConcernSource: 'implicit',
   localUpdateWallClockTime: ISODate("2022-07-01T17:35:40.578Z"),
   ok: 1,
   '$clusterTime': {
      ...
   },
   operationTime: Timestamp({ t: 1656632593, i: 1 })
}

Você só pode desconfigurar a definição do write concern padrão global se ainda não o tiver definido.

Para desconfigurar o write concern padrão global, use um documento vazio {}:

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

Se o write concern padrão global:

• For desconfigurado, a operação foi bem-sucedida.

• Já estiver configurado, a operação retorna o seguinte erro.

MongoServerError: The global default write concern cannot be unset
once it is set.