Menu Docs

setClusterParameter

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 center admin.

O comando setClusterParameter está disponível somente em instalações gerenciadas. O comando setClusterParameter não está disponível no MongoDB Atlas.

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

  • 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

Importante

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

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.

  • Você só pode executar setClusterParameter no reconhecimento de data center admin . 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.

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 .

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.

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.