Modificación de parámetros de clúster de Amazon DocumentDB - Amazon DocumentDB

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Modificación de parámetros de clúster de Amazon DocumentDB

En Amazon DocumentDB, los grupos de parámetros de clúster constan de parámetros que se aplican a todas las instancias que cree en el clúster. En los grupos de parámetros de clúster personalizados, puede modificar un valor de parámetro en cualquier momento o restablecer todos los valores de parámetro a sus valores predeterminados para los grupos de parámetros que cree. En esta sección se describe cómo ver los parámetros que conforman un grupo de parámetros de clúster de Amazon DocumentDB y sus valores, y cómo cambiar o actualizar estos valores.

Los parámetros pueden ser dinámicos o estáticos. Cuando se modifica un parámetro dinámico y se guarda el grupo de parámetros de clúster, el cambio se aplica inmediatamente, sea cual sea el estado de Apply Immediately. Cuando se cambia un parámetro estático y se guarda el grupo de parámetros de clúster, el cambio de parámetros solo tiene efecto después de reiniciar manualmente la instancia.

Visualización de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB

Puede ver los parámetros de un clúster de Amazon DocumentDB y sus valores mediante la AWS Management Console o la AWS CLI.

Using the AWS Management Console
Para ver los detalles de un grupo de parámetros de clúster
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

  2. En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).

    sugerencia

    Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.

  3. En el panel Parameter groups (Grupos de parámetros), seleccione el nombre del grupo de parámetros de clúster cuyos detalles desee ver.

  4. La página resultante muestra los siguientes valores para cada parámetro: el nombre del parámetro, el valor actual, los valores permitidos, si el parámetro es modificable, el tipo de aplicación, el tipo de datos y la descripción.

    Captura de pantalla: Nombres y valores de parámetros.
Using the AWS CLI

Para ver los parámetros de un grupo de parámetros de un clúster y sus valores, utilice la operación describe-db-cluster-parameters con los siguientes parámetros.

  • --db-cluster-parameter-group-name: obligatorio. El nombre del grupo de parámetros de clúster para el que desea obtener una lista detallada de parámetros.

  • --source: opcional. Si se especifica, devuelve solo los parámetros de un origen específico. Los orígenes de parámetros pueden ser engine-default, system o user.

El siguiente código de ejemplo muestra los parámetros, junto con sus valores, del grupo de parámetros custom3-6-param-grp. Para obtener más información sobre el grupo de parámetros, omita la línea --query. Para obtener más información sobre todos los grupos de parámetros, omita la línea --db-cluster-parameter-group-name.

Para Linux, macOS o Unix:

aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp \ --query 'Parameters[*].[ParameterName,ParameterValue]'

Para Windows:

aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name custom3-6-param-grp ^ --query 'Parameters[*].[ParameterName,ParameterValue]'

La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

[ [ "audit_logs", "disabled" ], [ "tls", "enabled" ], [ "ttl_monitor", "enabled" ] ]

Modificación de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB

Puede modificar los parámetros de un grupo de parámetros utilizando la AWS Management Console o la AWS CLI.

Using the AWS Management Console
Para actualizar los parámetros de un grupo de parámetros de clúster
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

  2. En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).

    sugerencia

    Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.

  3. En el panel Parameter groups (Grupos de parámetros), elija el grupo de parámetros del clúster cuyos parámetros desea actualizar.

  4. La página resultante muestra los parámetros y sus detalles correspondientes para este grupo de parámetros de clúster. Seleccione un parámetro para actualizar.

  5. En la parte superior derecha de la página, elija Edit (Editar) para cambiar el valor del parámetro. Para obtener más información sobre los tipos de parámetros de clúster, consulte Referencia de parámetros de clúster de Amazon DocumentDB.

  6. Realice el cambio y, a continuación, elija Modify cluster parameter (Modificar parámetro de clúster) para guardar los cambios. Para descartar los cambios, selecciona Cancel (Cancelar).

Using the AWS CLI

Para modificar los parámetros de un grupo de parámetros de clúster, utilice la operación modify-db-cluster-parameter-group con los siguientes parámetros.

  • --db-cluster-parameter-group-name: obligatorio. El nombre del grupo de parámetros de clúster que va a modificar.

  • --parameters: obligatorio. El parámetro o los parámetros que va a modificar. Cada entrada de parámetro debe incluir lo siguiente:

    • ParameterName: el nombre del grupo de parámetros de clúster que va a modificar.

    • ParameterValue: el valor nuevo de este parámetro de clúster.

    • ApplyMethod: cómo desea que se apliquen los cambios a este parámetro. Los valores permitidos son immediate y pending-reboot.

      nota

      Los parámetros con el ApplyType de static deben tener un ApplyMethod de pending-reboot.

Para cambiar los valores de los parámetros de un grupo de parámetros de clúster (AWS CLI)

En el siguiente ejemplo se cambia el nombre del parámetro tls.

  1. Muestre los parámetros y sus valores de sample-parameter-group

    Para Linux, macOS o 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

    La salida de esta operación será similar a lo que se indica a continuación (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 el parámetro tls para que su valor sea disabled. No se puede modificar ApplyMethod ya que ApplyType es static.

    Para Linux, macOS o 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"

    La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

    { "DBClusterParameterGroupName": "sample-parameter-group" }
  3. Espere al menos 5 minutos.

  4. Muestre los valores de parámetro de sample-parameter-group.

    Para Linux, macOS o 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

    La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

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