Modificando grupos de parâmetros de cluster do Amazon DocumentDB

Esta seção explica como modificar um grupo de parâmetros personalizado do Amazon DocumentDB. No Amazon DocumentDB, você não pode modificar um grupo de parâmetros de cluster default ao criar pela primeira vez um cluster com a nova versão do mecanismo em uma nova região. Se o cluster do Amazon DocumentDB estiver usando o grupo de parâmetros de cluster padrão e você desejar modificar um valor, primeiro será necessário criar um novo grupo de parâmetros, ou copiar um grupo de parâmetros existente, para então modificá-lo e, em seguida, aplicar o grupo de parâmetros modificado ao seu cluster.

Conclua as etapas a seguir para modificar um grupo personalizado de parâmetros de cluster. As ações de modificação podem demorar um pouco para se propagar. Aguarde até que o grupo de parâmetros de cluster modificado esteja disponível antes de anexá-lo ao seu cluster. É possível usar o AWS Management Console ou a operação AWS CLI describe-db-cluster-parameters para verificar se o grupo de parâmetros de cluster foi modificado. Para obter mais informações, consulte Descrevendo grupos de parâmetros de cluster.

Using the AWS Management Console

Siga estas etapas para modificar um grupo de parâmetros do Amazon DocumentDB personalizado. Não é possível modificar um grupo de parâmetros default. Se você deseja modificar um valor no grupo de parâmetros default, você pode copiar o grupo de parâmetros de cluster padrão, modificá-lo e aplicá-lo ao cluster. Para obter mais informações sobre como aplicar grupos de parâmetros ao cluster, consulte Modificação de um cluster do Amazon DocumentDB.

Para modificar um grupos de parâmetros de cluster personalizado

1. Faça login no AWS Management Console 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. Na lista de grupos de parâmetro, escolha o nome do grupo de parâmetro que deseja modificar.

   dica

   Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu () no canto superior esquerdo da página.

3. Para cada parâmetro no grupo de parâmetro que desejar modificar, faça o seguinte:

   1. Localize o parâmetro que deseja modificar e verifique se ele é modificável e se está listado como true na coluna Modificável.

   2. Se for modificável, selecione o parâmetro e escolha Editar no canto superior direito da página do console.

   3. Na caixa de diálogo Modificar <parameter-name>, faça as alterações que deseja. Depois disso, escolha Modificar parâmetro de cluster ou Cancelar para descartar as alterações.

Using the AWS CLI

É possível modificar o ParameterValue, a Description ou o ApplyMethod de qualquer parâmetro modificável em um grupo de parâmetros de cluster personalizado do Amazon DocumentDB usando a AWS CLI. Não é possível fazer modificações diretamente em um grupo de parâmetros de cluster.

Para modificar os parâmetros de um grupo de parâmetros de cluster personalizado, use a operação modify-db-cluster-parameter-group com os parâmetros a seguir.

• --db-cluster-parameter-group-name — obrigatório. O nome do grupos de parâmetros de cluster que está modificando.

• --parameters — obrigatório. Os parâmetros que você está modificando. Para obter uma lista dos parâmetros que se aplicam a todas as instâncias em um cluster do Amazon DocumentDB, consulte Referência de parâmetros de cluster do Amazon DocumentDB. Cada entrada de parâmetro deve incluir o seguinte:

  • ParameterName — O nome do parâmetro que você está modificando.

  • ParameterValue — o novo valor para esse parâmetro.

  • ApplyMethod — como você deseja aplicar as alterações nesse parâmetro. Os valores permitidos são immediate e pending-reboot.

    nota

    Os parâmetros com ApplyType de static devem ter um ApplyMethod de pending-reboot.

exemplo - Modificando o valor de um parâmetro

Neste exemplo, você lista os valores de parâmetro de sample-parameter-group e modifica o parâmetro tls. Em seguida, após esperar 5 minutos, você listará novamente os valores dos parâmetros do sample-parameter-group para vê-los alterados.

1. Liste os parâmetros e os valores do sample-parameter-group.

   Para Linux, macOS ou Unix:

   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group

   Para Windows:

   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group

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

   {
          "Parameters": [
              {
                  "Source": "system",
                  "ApplyType": "static",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "tls",
                  "IsModifiable": true,
                  "Description": "Config to enable/disable TLS"
              },
              {
                  "Source": "user",
                  "ApplyType": "dynamic",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "ttl_monitor",
                  "IsModifiable": true,
                  "Description": "Enables TTL Monitoring"
              }
          ]
   }

2. Modifique o parâmetro tls para que seu valor seja disabled.

   Não é possível modificar o ApplyMethod porque o ApplyType é static.

   Para Linux, macOS ou Unix:

   aws docdb modify-db-cluster-parameter-group \
          --db-cluster-parameter-group-name sample-parameter-group \
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

   Para Windows:

   aws docdb modify-db-cluster-parameter-group ^
          --db-cluster-parameter-group-name sample-parameter-group ^
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

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

   {
          "DBClusterParameterGroupName": "sample-parameter-group"
      }

3. Aguarde pelo menos 5 minutos.

4. Liste os valores de parâmetros de sample-parameter-group para verificar se o parâmetro tls foi modificado.

   Para Linux, macOS ou Unix:

   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group

   Para Windows:

   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group

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

   {
          "Parameters": [
              {
                  "ParameterValue": "false",
                  "ParameterName": "enable_audit_logs",
                  "ApplyType": "dynamic",
                  "DataType": "string",
                  "Description": "Enables auditing on cluster.",
                  "AllowedValues": "true,false",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              },
              {
                  "ParameterValue": "disabled",
                  "ParameterName": "tls",
                  "ApplyType": "static",
                  "DataType": "string",
                  "Description": "Config to enable/disable TLS",
                  "AllowedValues": "disabled,enabled",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              }
          ]
   }