getDefaultRWConcern (comando de banco de dados)

Definição

getDefaultRWConcern

O comando administrativo recupera as configurações globais padrão de read ou preocupação de gravação getDefaultRWConcern .

Para clusters fragmentados, emita o getDefaultRWConcern em mongos um.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O comando tem o seguinte formato:

db.adminCommand(
   {
     getDefaultRWConcern: 1 ,
     inMemory: <boolean>,
     comment: <any>
   }
)

Campos de comando

O comando tem os seguintes campos:

Campo	Tipo	Descrição
getDefaultRWConcern	int	Defina como `1`.
inMemory	booleano	Opcional. Defina como `true` para retornar a cópia em cache na memória das configurações globais padrão de read ou write concern. A instância usa a cópia na memória ao aplicar os padrões globais a uma operação. Defina como `false` para retornar a cópia em disco da read ou write concern padrão global. O padrão é `false`.
`comment`	any	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).

Saída

A saída pode incluir os seguintes campos:

Campo	Tipo	Descrição
defaultWriteConcern	`object`	A configuração padrão global da write concern. Se a implantação não tiver configurações globais de preocupação de gravação padrão, esse campo estará ausente da saída `getDefaultRWConcern`.
defaultReadConcern	`object`	A configuração da read concern padrão global. Se a implantação não tiver configurações globais de preocupação de leitura padrão, esse campo estará ausente da saída `getDefaultRWConcern`.
defaultWriteConcernSource	String	A origem da write concern padrão. Por padrão, o valor é `"implicit"`. Após definir a write concern padrão com `setDefaultRWConcern`, o valor se torna `"global"`.
defaultReadConcernSource	String	A origem da read concern padrão. Por padrão, o valor é `"implicit"`. Depois de definir a read concern padrão com `setDefaultRWConcern`, o valor se torna `"global"`.
updateOpTime	Timestamp	O carimbo de data e hora da operação de quando houve a última mudança nas configurações padrão globais de read ou write concern. Presente se um padrão já tiver sido definido para o cluster.
updateWallClockTime	Data	A data do wall clock em que um administrador definiu pela última vez a read ou write concern padrão global. Este valor é informativo e não deve ser usado para comparações de recenticidade.
localUpdateWallClockTime	Data	A data do wall clock em que o `mongod` ou `mongos` atualizou pela última vez sua cópia local das configurações padrão globais de read e write concern. Este valor é informativo e não deve ser usado para comparações de recenticidade.

Dica

setDefaultRWConcern

Comportamento

Observação

Exige featureCompatibilityVersion 4.4+

Cada no conjunto de mongod réplicas ou cluster fragmentado deve ter featureCompatibilityVersion configurado para pelo menos 4.4 para usar. Se você getDefaultRWConcern fizer o downgrade do featureCompatibilityVersion do seu sistema 4.4 de 4.2 para, todos os padrões da read e preocupação de gravação em todo mongos o cluster serão perdidos, mas as instâncias do poderão continuar aplicando os padrões por até 30 segundos.

Conjuntos de réplicas

Você pode emitir contra qualquer membro portador de dados do getDefaultRWConcern conjunto de réplicas (ou seja, não contra um árbitro).

Um secundário pode retornar uma versão "obsoleta" das configurações padrão globais se ainda não tiver replicado as alterações mais recentes do primário.

Clusters fragmentados

Emita setDefaultRWConcern contra um mongos no cluster.

Cada mongos atualiza periodicamente sua cópia local das configurações padrão globais. Um mongos pode retornar uma versão "obsoleta" das configurações padrão globais se ainda não tiver atualizado sua cópia local após uma atualização recente conforme as configurações padrão globais ou se tiver buscado suas configurações de um servidor de configuração secundário com atraso.

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

Controle de acesso

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

As roles embutidas de clusterManager ou fornecem os clusterMonitor getDefaultRWConcern privilégios exigidos para executar.

Exemplo

A operação a seguir recupera as read e write concerns padrão globais configuradas para o mongod.

db.adminCommand({
  "getDefaultRWConcern": 1
})

A operação gera uma saída semelhante ao seguinte:

{
  "defaultWriteConcern" : {
    "w" : "majority"
  },
  "defaultReadConcern" : {
    "level" : "majority"
  },
  "defaultWriteConcernSource" : "global",
  "defaultReadConcernSource" : "global",
  "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)
}

Voltar

getClusterParameter

getParameter