Trabajo con grupos de parámetros de clúster de base de datos para clústeres de base de datos Multi-AZ - Amazon Relational Database Service

Trabajo con grupos de parámetros de clúster de base de datos para clústeres de base de datos Multi-AZ

Los clústeres de base de datos Multi-AZ utilizan grupos de parámetros de clúster de base de datos. En las secciones siguientes se describe la configuración y administración de los grupos de parámetros de clúster de base de datos.

Creación de un grupo de parámetros de clúster de base de datos

Puede crear un nuevo grupo de parámetros de clúster de base de datos mediante la AWS Management Console, la AWS CLI o la API de RDS.

Después de crear un grupo de parámetros de clústeres de base de datos, espere al menos 5 minutos antes de crear un cluster de base de datos que utilice ese grupo de parámetros de clúster de base de datos. Esto permite a Amazon RDS crear por completo el grupo de parámetros antes de que lo utilice el nuevo clúster de base de datos. Puede utilizar la página Parameter Groups (Grupos de parámetros) de la consola de Amazon RDS o el comando describe-db-cluster-parameters para comprobar que se ha creado el grupo de parámetros de clúster de base de datos.

Para crear un grupo de parámetros de clúster de base de datos
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

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

  3. Elija Create parameter group.

    Aparece la ventana Create parameter group (Crear grupo de parámetros).

  4. En la lista Parameter group family (Familia de grupos de parámetros), seleccione una familia de grupos de parámetros de base de datos.

  5. En la lista Type (Tipo), seleccione DB Cluster Parameter Group (Grupo de parámetros de clúster de base de datos).

  6. En el cuadro Group name (Nombre de grupo), escriba el nombre del nuevo grupo de parámetros de clúster de base de datos.

  7. En el cuadro Description (Descripción), escriba una descripción para el nuevo grupo de parámetros de clúster de base de datos.

  8. Seleccione Create (Crear OpsItem).

Para crear un grupo de parámetros de clúster de base de datos, use el comando AWS CLI de create-db-cluster-parameter-group.

En el siguiente ejemplo, se crea un grupo de parámetros de clúster de base de datos denominado mydbclusterparametergroup para la versión 8.0 de RDS for MySQL con la descripción “My new cluster parameter group” (Mi grupo de parámetros de clúster nuevo).

Incluya los siguientes parámetros obligatorios:

  • --db-cluster-parameter-group-name

  • --db-parameter-group-family

  • --description

Para mostrar todas las familias de grupos de parámetros disponibles, use el siguiente comando:

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
nota

La salida contiene duplicados.

ejemplo

Para Linux, macOS o Unix:

aws rds create-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --db-parameter-group-family mysql8.0 \ --description "My new cluster parameter group"

Para Windows:

aws rds create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --db-parameter-group-family mysql8.0 ^ --description "My new cluster parameter group"

El resultado de este comando debería ser similar al siguiente:

{ "DBClusterParameterGroup": { "DBClusterParameterGroupName": "mydbclusterparametergroup", "DBParameterGroupFamily": "mysql8.0", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2" } }

Para crear un grupo de parámetros de clúster de base de datos, use la acción CreateDBClusterParameterGroup de la API de RDS.

Incluya los siguientes parámetros obligatorios:

  • DBClusterParameterGroupName

  • DBParameterGroupFamily

  • Description

Modificación de parámetros de un grupo de parámetros de clúster de base de datos

Es posible modificar parámetros de un grupo de parámetros de clúster de base de datos creado por el cliente. No puede cambiar los valores de parámetros de un grupo de parámetros de clúster de base de datos predeterminado. Los cambios realizados en los parámetros de un grupo de parámetros de clúster de base de datos creado por el cliente se aplican a todas las instancias de clústeres de bases de datos asociados al grupo de parámetros de clúster de base de datos.

Para modificar un grupo de parámetros de clúster de base de datos
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

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

  3. En la lista, seleccione el grupo de parámetros que desea modificar.

  4. En Parameter group actions (Acciones de grupos de parámetros), seleccione Edit (Editar).

  5. Cambie los valores de los parámetros que desea modificar. Puede desplazarse por los parámetros utilizando las teclas de flecha de la parte superior derecha del cuadro de diálogo.

    No puede cambiar los valores de un grupo de parámetros predeterminado.

  6. Elija Save changes.

  7. Reinicie la instancia de base de datos principal en el clúster para aplicar los cambios a todas las instancias de base de datos del clúster.

Para modificar un grupo de parámetros de clúster de base de datos, utilice el comando modify-db-cluster-parameter-group de AWS CLI con los siguientes parámetros obligatorios:

  • --db-cluster-parameter-group-name

  • --parameters

En el siguiente ejemplo se modifican los valores de server_audit_logging y server_audit_logs_upload en el grupo de parámetros de clúster de base de datos denominado mydbclusterparametergroup.

ejemplo

Para Linux, macOS o Unix:

aws rds modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Para Windows:

aws rds modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

El comando produce un resultado similar al siguiente:

DBCLUSTERPARAMETERGROUP mydbclusterparametergroup

Para modificar un grupo de parámetros de clúster de base de datos, utilice el comando ModifyDBClusterParameterGroup de la API de RDS con los siguientes parámetros obligatorios:

  • DBClusterParameterGroupName

  • Parameters

Restablecimiento de parámetros de un grupo de parámetros de clúster de base de datos

Puede restablecer los parámetros a sus valores predeterminados en un grupo de parámetros de clúster de base de datos creado por el cliente. Los cambios realizados en los parámetros de un grupo de parámetros de clúster de base de datos creado por el cliente se aplican a todas las instancias de clústeres de bases de datos asociados al grupo de parámetros de clúster de base de datos.

nota

En un grupo de parámetros de clúster de base de datos predeterminado, los parámetros siempre se establecen en sus valores predeterminados.

Para restablecer los parámetros de un grupo de parámetros de clúster de base de datos a sus valores predeterminados
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

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

  3. En la lista, elija el grupo de parámetros.

  4. En Parameter group actions (Acciones de grupos de parámetros), seleccione Edit (Editar).

  5. Elija los parámetros que desea restablecer a sus valores predeterminados. Puede desplazarse por los parámetros utilizando las teclas de flecha de la parte superior derecha del cuadro de diálogo.

    No puede restablecer los valores de un grupo de parámetros predeterminado.

  6. Elija Restablecer y, a continuación, confirme seleccionando Restablecer parámetros.

  7. Reinicie la instancia de base de datos principal en el clúster de base de datos para aplicar los cambios a todas las instancias de base de datos del clúster de base de datos.

Para restablecer los parámetros de un grupo de parámetros de clúster de base de datos a sus valores predeterminados, utilice el comando reset-db-cluster-parameter-group de AWS CLI con la siguiente opción requerida: --db-cluster-parameter-group-name.

Para restablecer todos los parámetros del grupo de parámetros de clúster de base de datos, especifique la opción --reset-all-parameters. Para restablecer parámetros específicos, especifique la opción --parameters.

En el ejemplo siguiente se restablecen todos los parámetros del grupo de parámetros DB denominado mydbparametergroup a sus valores predeterminados.

ejemplo

Para Linux, macOS o Unix:

aws rds reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbparametergroup \ --reset-all-parameters

Para Windows:

aws rds reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbparametergroup ^ --reset-all-parameters

En el siguiente ejemplo se modifican los valores de server_audit_logging y server_audit_logs_upload en el grupo de parámetros de clúster de base de datos denominado mydbclusterparametergroup.

ejemplo

Para Linux, macOS o Unix:

aws rds reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \ "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"

Para Windows:

aws rds reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

El comando produce un resultado similar al siguiente:

DBClusterParameterGroupName mydbclusterparametergroup

Para restablecer los parámetros de un grupo de parámetros de clúster de base de datos a sus valores predeterminados, utilice el comando API de RDS ResetDBClusterParameterGroup con el siguiente parámetro requerido: DBClusterParameterGroupName.

Para restablecer todos los parámetros del grupo de parámetros de clúster de base de datos, defina el parámetro ResetAllParameters en true. Para restablecer parámetros específicos, especifique el parámetro Parameters.

Copia de un grupo de parámetros de clúster de base de datos

Puede copiar los grupos de parámetros de clúster de base de datos personalizados que cree. Copiar un grupo de parámetros es una solución conveniente cuando ya se ha creado un grupo de parámetros de clúster de base de datos y se desea incluir la mayoría de los parámetros y valores personalizados de ese grupo en un nuevo grupo de parámetros de clúster de base de datos. Puede copiar un grupo de parámetros de clúster de base de datos mediante el comando copy-db-cluster-parameter-group de la AWS CLI o la operación CopyDBClusterParameterGroup de la API de RDS.

Después de copiar un grupo de parámetros de clústeres de base de datos, espere al menos 5 minutos antes de crear un cluster de base de datos que utilice ese grupo de parámetros de clúster de base de datos. Esto permite a Amazon RDS copiar por completo el grupo de parámetros antes de que lo utilice el nuevo clúster de base de datos. Puede utilizar la página Parameter Groups (Grupos de parámetros) de la consola de Amazon RDS o el comando describe-db-cluster-parameters para comprobar que se ha creado el grupo de parámetros de clúster de base de datos.

nota

No es posible copiar un grupo de parámetros predeterminado. Sin embargo, puede crear un grupo de parámetros que se base en uno predeterminado.

Para copiar un grupo de parámetros de clúster de base de datos
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

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

  3. En la lista, seleccione el grupo de parámetros personalizado que desea copiar.

  4. En Parameter group actions (Acciones de grupos de parámetros), seleccione Copy (Copiar).

  5. En New DB parameter group identifier (Nuevo identificador de grupo de parámetros de base de datos), escriba el nombre del nuevo grupo de parámetros.

  6. En Description (Descripción), escriba una descripción para el nuevo grupo de parámetros.

  7. Elija Copy.

Para copiar un grupo de parámetros de clúster de base de datos, utilice el comando copy-db-cluster-parameter-group de AWS CLI con los siguientes parámetros obligatorios:

  • --source-db-cluster-parameter-group-identifier

  • --target-db-cluster-parameter-group-identifier

  • --target-db-cluster-parameter-group-description

En el siguiente ejemplo se crea un nuevo grupo de parámetros de clúster de base de datos denominado mygroup2 que es una copia del grupo de parámetros de clúster de base de datos mygroup1.

ejemplo

Para Linux, macOS o Unix:

aws rds copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier mygroup1 \ --target-db-cluster-parameter-group-identifier mygroup2 \ --target-db-cluster-parameter-group-description "DB parameter group 2"

Para Windows:

aws rds copy-db-cluster-parameter-group ^ --source-db-cluster-parameter-group-identifier mygroup1 ^ --target-db-cluster-parameter-group-identifier mygroup2 ^ --target-db-cluster-parameter-group-description "DB parameter group 2"

Para copiar un grupo de parámetros de clúster de base de datos, utilice la operación CopyDBClusterParameterGroup de la API de RDS con los siguientes parámetros obligatorios:

  • SourceDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupDescription

Descripción de grupos de parámetros de clúster de base de datos

Es posible obtener un listado de los grupos de parámetros de clúster de base de datos que se han creado para una cuenta de AWS.

nota

Los grupos de parámetros predeterminados se crean automáticamente a partir de una plantilla de parámetros predeterminados cuando se crea un clúster de base de datos para un motor y una versión de base de datos específicos. Estos grupos de parámetros predeterminados contienen los valores preferidos para los parámetros y no se pueden modificar. Los valores de los parámetros se pueden modificar cuando se crea un grupo de parámetros personalizado.

Para obtener una lista de todos los grupos de parámetros de clúster de base de datos de una cuenta de AWS
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

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

    Los grupos de parámetros de clúster de base de datos aparecen en la lista con <guilabel>Grupo de parámetros de clúster de base de datos para Tipo.

Para obtener la lista de todos los grupos de parámetros de clúster de base de datos para una cuenta de AWS, utilice el comando describe-db-cluster-parameter-groups de AWS CLI.

ejemplo

En el siguiente ejemplo, se obtiene la lista de todos los grupos de parámetros de clúster de base de datos disponibles en una cuenta de AWS.

aws rds describe-db-cluster-parameter-groups

En el siguiente ejemplo se describe el grupo de parámetros mydbclusterparametergroup.

Para Linux, macOS o Unix:

aws rds describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name mydbclusterparametergroup

Para Windows:

aws rds describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name mydbclusterparametergroup

El comando devuelve una respuesta similar a la siguiente:

{ "DBClusterParameterGroups": [ { "DBClusterParameterGroupName": "mydbclusterparametergroup2", "DBParameterGroupFamily": "mysql8.0", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup" } ] }

Para obtener la lista de todos los grupos de parámetros de clúster de base de datos de una cuenta de AWS, utilice la acción DescribeDBClusterParameterGroups de la API de RDS.

Visualización de los valores de los parámetros de un grupo de parámetros de clúster de base de datos

Es posible obtener una lista de todos los parámetros de un grupo de parámetros de clúster de base de datos y sus valores.

Para ver los valores de los parámetros de un grupo de parámetros de clúster de base de datos
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.

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

    Los grupos de parámetros de clúster de base de datos aparecen en la lista con Grupo de parámetros de clúster de base de datos para Tipo.

  3. Seleccione el nombre del grupo de parámetros de clúster de base de datos para ver su lista de parámetros.

Para ver los valores de los parámetros de un grupo de parámetros de clúster de base de datos, utilice el comando describe-db-cluster-parameters de AWS CLI con el siguiente parámetro obligatorio.

  • --db-cluster-parameter-group-name

ejemplo

En el siguiente ejemplo se obtiene la lista de los parámetros y los valores de los parámetros de un grupo de parámetros de clúster de base de datos denominado mydbparametergroup, en formato JSON.

El comando devuelve una respuesta similar a la siguiente:

aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
{ "Parameters": [ { "ParameterName": "activate_all_roles_on_login", "ParameterValue": "0", "Description": "Automatically set all granted roles as active after the user has authenticated successfully.", "Source": "engine-default", "ApplyType": "dynamic", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": true, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, { "ParameterName": "allow-suspicious-udfs", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, ...

Para ver los valores de los parámetros de un grupo de parámetros de clúster de base de datos, utilice el comando DescribeDBClusterParameters de la API de RDS con el siguiente parámetro obligatorio.

  • DBClusterParameterGroupName