setDefaultRWConcern

Conjuntos de réplicas

Problema setDefaultRWConcern em relação ao primário do conjunto de réplicas. O primário 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 uma writeConcern de w : "majority" para garantir que o comando retorne somente após as alterações propagarem para a maioria dos membros do conjunto de réplicas.

Clusters fragmentados

Emita o setDefaultRWConcern contra um mongos no cluster. O mongos mantém as configurações atualizadas no conjunto de réplicas do servidor de configuração (CSRS). Cada mongos emite periodicamente um getDefaultRWConcern no CSRS para atualizar sua cópia local das configurações globais. Um mongos usa 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 w : "majority" para garantir que o comando só retorne depois que as alterações tiverem se propagado para a maioria dos nós do 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 fragmentos individuais. Não é possível executar setDefaultRWConcern em um fragmento.

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 privilégio setDefaultRWConcern .

A função integrada clusterManager fornece os privilégios exigidos para executar o setDefaultRWConcern.

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.