setClusterParameter
Nesta página
Definição
setClusterParameter
setClusterParameter
é um comando administrativo para modificar os valores dos parâmetros do cluster. Os parâmetros do cluster são parâmetros configuráveis que afetam todos os nós em um conjunto de réplicas ou cluster fragmentado.Você deve emitir o comando
setClusterParameter
contra o reconhecimento de data centeradmin
.O comando
setClusterParameter
está disponível somente em instalações gerenciadas. O comandosetClusterParameter
não está disponível no MongoDB Atlas.
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
db.adminCommand( { setClusterParameter: { <parameter>: <value> } } )
Para obter os parâmetros de cluster disponíveis, incluindo exemplos, consulte Parâmetros de cluster para uma implantação autogerenciada.
Comportamento
Você só pode executar
setClusterParameter
no reconhecimento de data centeradmin
. Se você executar o comando em qualquer outro reconhecimento de data center, o MongoDB retornará um erro.Você só pode executar
setClusterParameter
em um conjunto de réplicas primário ou em um cluster fragmentado.Você não pode executar
setClusterParameter
em uma implantação autônomo.setClusterParameter
aceita apenas um parâmetro de cada vez.
Controle de acessos
Quando a autenticação está habilitada, o setClusterParameter
só funciona quando autenticado como um usuário com um role que tem acesso à ação setClusterParameter
.
Persistência
As modificações de parâmetros feitas utilizando setClusterParameter
são persistentes em conjuntos de réplicas e clusters fragmentados. Isso garante que as modificações de parâmetros feitas com setClusterParameter
sobrevivam às reinicializações.
Stable API
Se utilizar a Stable API V1 com apiStrict definido como true
, não será possível utilizar setClusterParameter
para modificar os parâmetros do cluster.