Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Comandos de Administração

getDefaultRWConcern

Nesta página

  • Definição
  • Sintaxe
  • Campos de comando
  • Saída
  • Comportamento
  • Exemplo

Definição

getDefaultRWConcern

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

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

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
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:

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 preocupação de gravação.

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 preocupação de leitura 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

Veja também:

setDefaultRWConcern

Comportamento

Observação

Exige featureCompatibilityVersion 4.4+

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

Conjuntos de réplicas

Você pode emitir getDefaultRWConcern contra qualquer nó portador de dados do 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 fragmentos individuais. Não é possível executar getDefaultRWConcern em um fragmento.

Controle de acesso

Para conjuntos de réplicas ou clusters fragmentados que impõem Autenticação, getDefaultRWConcern exige que o usuário autenticado tenha a ação de privilégio getDefaultRWConcern.

As funções integradas clusterManager ou clusterMonitor fornecem os privilégios exigidos para executar getDefaultRWConcern.

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)
}
← getClusterParameter
Obter parâmetro →

Nesta página