Redefinindo grupos de parâmetros de cluster do Amazon DocumentDB - Amazon DocumentDB

Redefinindo grupos de parâmetros de cluster do Amazon DocumentDB

É possível redefinir alguns ou todos os valores de parâmetro de um grupo de parâmetros de cluster do Amazon DocumentDB usando Console de gerenciamento da AWS ou AWS Command Line Interface (AWS CLI) para redefinir o grupo de parâmetros de cluster.

Using the Console de gerenciamento da AWS

Siga estas etapas para redefinir alguns ou todos os valores de parâmetros de um grupo de parâmetros de cluster para seus valores padrão.

Como redefinir os valores de parâmetros de um grupo de parâmetros de cluster

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/emr/clusters.

  2. No painel de navegação, no lado esquerdo do console, selecione Grupos de parâmetros.

  3. No painel Grupos de parâmetros de cluster, escolha o nome do grupo de parâmetros de cluster que deseja redefinir.

  4. Escolha Ações e Redefinir para redefinir esse grupo de parâmetros.

  5. Na página Confirmação de redefinição do grupo de parâmetros de cluster resultante, confirme se você deseja redefinir todos os parâmetros de cluster para esse grupo de parâmetros para seus padrões. Depois disso, escolha Redefinir para redefinir o grupo de parâmetros. Também é possível escolher Cancelar para cancelar as alterações.

Using the AWS CLI

Para redefinir alguns ou todos os valores de parâmetro do grupos de parâmetros de cluster para seus valores padrão, use a operação reset-db-cluster-parameter-group com os parâmetros a seguir.

  • --db-cluster-parameter-group-name — Obrigatório. O nome do grupo de parâmetro de cluster a ser redefinido.

  • --parameters — Opcional. Uma lista de ParameterName e ApplyMethod no grupo de parâmetro de cluster para redefinir para seus valores padrão. Os parâmetros estáticos devem ser definidos como pending-reboot para entrar em vigor na próxima reinicialização da instância ou na solicitação reboot-db-instance. É necessário chamar reboot-db-instance para cada instância no cluster cujo parâmetro estático atualizado desejar aplicar.

    Esse parâmetro e --reset-all-parameters são mutuamente exclusivos: você pode usar um, mas não ambos.

  • --reset-all-parameters ou --no-reset-all-parameters — opcional. Especifica se é necessário redefinir todos os parâmetros (--reset-all-parameters) ou apenas alguns dos parâmetros (--no-reset-all-parameters) para seus valores padrão. O parâmetro --reset-all-parameters e --parameters são mutuamente exclusivos: você pode usar um, mas não ambos.

    Quando você redefinir o grupo inteiro, os parâmetros dinâmicos serão atualizados imediatamente. Os parâmetros estáticos são definidos como pending-reboot para entrarem em vigor na próxima reinicialização da instância, ou na solicitação reboot-db-instance. É necessário chamar reboot-db-instance para cada instância no cluster na qual deseja que o parâmetro estático atualizado seja aplicado.

Exemplo 1: redefinindo todos os parâmetros para seus valores padrão

O código a seguir redefine todos os parâmetros no grupos de parâmetros de cluster sample-parameter-group para seus valores padrão.

Para Linux, macOS ou Unix:

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --reset-all-parameters

Para Windows:

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --reset-all-parameters
Exemplo 2: redefinindo os parâmetros especificados para seus valores padrão

O código a seguir redefine o parâmetro tls no grupo de parâmetro de cluster sample-parameter-group para seu valor padrão.

Para Linux, macOS ou Unix:

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --no-reset-all-parameters \
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

Para Windows:

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --no-reset-all-parameters ^
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

A saída dessa operação é semelhante ao seguinte (formato JSON).

{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }
Reiniciando uma instância de cluster

Antes que o valor de um parâmetro estático seja alterado, a instância do cluster deve ser reiniciada. Reinicie cada instância no cluster a qual deseje que o parâmetro estático atualizado seja aplicado.

Para Linux, macOS ou Unix:

aws docdb reboot-db-instance \
       --db-instance-identifier sample-cluster-instance

Para Windows:

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-cluster-instance