Trabajo con los grupos de parámetros en una instancia de base de datos

Las instancias de base de datos utilizan grupos de parámetros de base de datos. En las secciones siguientes se describe cómo configurar y administrar los grupos de parámetros de instancia de base de datos.

Creación de un grupo de parámetros de base de datos

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

Se aplican las siguientes limitaciones al nombre del grupo de parámetros de base de datos:

• Debe tener de 1 a 255 letras, números o guiones.

  Los nombres de los grupos de parámetros predeterminados pueden incluir un punto, como default.mysql8.0. Sin embargo, los nombres de grupos de parámetros personalizados no pueden incluir un punto.

• El primer carácter debe ser una letra.

• El nombre no puede incluir dos guiones consecutivos ni finalizar con guion.

Consola

Para crear un grupo de parámetros 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.

4. Para Nombre del grupo de parámetros, escriba el nombre del nuevo grupo de parámetros de base de datos.

5. En Descripción, escriba una descripción del nuevo grupo de parámetros de base de datos.

6. En Tipo de motor, elija el motor de base de datos.

7. En Familia del grupo de parámetros, seleccione una familia de grupo de parámetros de base de datos.

8. En Tipo, elija Grupo de parámetros de base de datos.

9. Seleccione Create (Crear).

AWS CLI

Para crear un grupo de parámetros de base de datos, utilice el comando create-db-parameter-group de la AWS CLI. En el siguiente ejemplo se crea un grupo de parámetros de base de datos denominado mydbparametergroup para MySQL versión 8.0 con la descripción “My new parameter group”.

Incluya los siguientes parámetros obligatorios:

• --db-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-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family MySQL8.0 \
    --description "My new parameter group"

En Windows:

aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family MySQL8.0 ^
    --description "My new parameter group"

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

DBPARAMETERGROUP  mydbparametergroup  mysql8.0  My new parameter group

API de RDS

Para crear un grupo de parámetros de base de datos, utilice la operación CreateDBParameterGroup de la API de RDS.

Incluya los siguientes parámetros obligatorios:

• DBParameterGroupName

• DBParameterGroupFamily

• Description

Asociación de un grupo de parámetros de base de datos con una instancia de base de datos

Puede crear sus propios grupos de parámetros de base de datos con configuraciones personalizadas. Puede asociar un grupo de parámetros de base de datos con una instancia de base de datos mediante AWS Management Console, la AWS CLI, o la API de RDS. Puede hacerlo al crear o modificar una instancia de base de datos.

Para obtener información sobre la creación de un grupo de parámetros de base de datos, consulte Creación de un grupo de parámetros de base de datos. Para obtener información acerca de la creación de una instancia de base de datos, consulte Creación de una instancia de base de datos de Amazon RDS. Para obtener más información sobre la modificación de una instancia de base de datos, consulte Modificación de una instancia de base de datos de Amazon RDS.

nota

Al asociar un nuevo grupo de parámetros de base de datos con una instancia de base de datos, los parámetros estáticos y dinámicos modificados se aplican solo después de reiniciar la instancia de base de datos. Sin embargo, si modifica los parámetros dinámicos en el grupo de parámetros de base de datos después de asociarlos a la instancia de base de datos, dichos cambios se aplican inmediatamente sin reiniciar.

Consola

Para asociar un grupo de parámetros de base de datos con una instancia 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, elija Databases (Bases de datos) y, a continuación, seleccione la instancia de base de datos que desee modificar.

3. Elija Modify. Aparece la página Modify DB instance (Modificar instancia de base de datos).

4. Cambie la configuración del grupo de parámetros de base de datos.

5. Elija Continue y consulte el resumen de las modificaciones.

6. (Opcional) Seleccione Apply immediately (Aplicar inmediatamente) para aplicar los cambios inmediatamente. Si se selecciona esta opción, puede producirse una interrupción en algunos casos. Para obtener más información, consulte Configuración de programación de modificaciones.

7. En la página de confirmación, revise los cambios. Si son correctos, elija Modify DB instance (Modificar instancia de base de datos) para guardar los cambios.

   O bien, elija Back (Atrás) para editar los cambios o Cancel (Cancelar) para cancelarlos.

AWS CLI

Para asociar un grupo de parámetros de base de datos con una instancia de base de datos, utilice el comando modify-db-instance de AWS CLI con las siguientes opciones:

• --db-instance-identifier

• --db-parameter-group-name

En el ejemplo siguiente se asocia el mydbpg grupo de parámetros de base de datos con la database-1 instancia de base de datos. Los cambios se aplican inmediatamente mediante --apply-immediately. Utilícelo --no-apply-immediately para aplicar los cambios durante la siguiente ventana de mantenimiento. Para obtener más información, consulte Configuración de programación de modificaciones.

ejemplo

Para Linux, macOS o Unix:

aws rds modify-db-instance \
    --db-instance-identifier database-1 \
    --db-parameter-group-name mydbpg \
    --apply-immediately

En Windows:

aws rds modify-db-instance ^
    --db-instance-identifier database-1 ^
    --db-parameter-group-name mydbpg ^
    --apply-immediately

API de RDS

Para asociar un grupo de parámetros de base de datos con una instancia de base de datos, utilice la operación ModifyDBInstance de la API de RDS con los siguientes parámetros:

• DBInstanceName

• DBParameterGroupName

Modificación de parámetros de un grupo de parámetros de base de datos

Es posible modificar los valores de los parámetros de un grupo de parámetros de base de datos creado por el cliente; no es posible modificar los valores de los parámetros de un grupo de parámetros de base de datos predeterminado. Los cambios realizados en los parámetros de un grupo de parámetros de base de datos creado por el cliente se aplican a todas las instancias de bases de datos asociadas al grupo de parámetros de base de datos.

Los cambios en algunos parámetros se aplican a la instancia de base de datos inmediatamente sin necesidad de reiniciar. Los cambios en otros parámetros se aplican únicamente después de reiniciar la instancia de base de datos. La consola de RDS muestra el estado del grupo de parámetros de base de datos asociado a una instancia de base de datos en la pestaña Configuration (Configuración). Por ejemplo, podría darse por ejemplo que la instancia de base de datos no está utilizando los cambios más recientes del grupo de parámetros de base de datos asociado. De ser así, la consola de RDS muestra el grupo de parámetros de base de datos con el estado pending-reboot. Para aplicar los cambios de parámetros más recientes en esa instancia de base de datos, reinicie manualmente la instancia de base de datos.

Consola

Modificación de parámetros en un grupo de parámetros 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, elija el nombre del 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 desee 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.

AWS CLI

Para modificar un grupo de parámetros de base de datos, utilice el AWS CLI modify-db-parameter-group comando con las siguientes opciones requeridas:

• --db-parameter-group-name

• --parameters

En el siguiente ejemplo se modifican los valores de max_connections y max_allowed_packet en el grupo de parámetros de base de datos denominado mydbparametergroup.

ejemplo

Para Linux, macOS o Unix:

aws rds modify-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

En Windows:

aws rds modify-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

El comando produce un resultado similar al siguiente:

DBPARAMETERGROUP  mydbparametergroup

API de RDS

Para modificar un grupo de parámetros de base de datos, utilice la operación ModifyDBParameterGroup de la API de RDS con los siguientes parámetros requeridos:

• DBParameterGroupName

• Parameters

Restablecimiento de parámetros de un grupo de parámetros de base de datos a sus valores predeterminados

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

Cuando utiliza la consola, puede restablecer parámetros específicos a sus valores predeterminados. Sin embargo, no puede restablecer fácilmente todos los parámetros del grupo de parámetros de base de datos a la vez. Cuando utiliza la AWS CLI o la API de RDS, puede restablecer parámetros específicos a sus valores predeterminados. También puede restablecer fácilmente todos los parámetros del grupo de parámetros de base de datos a la vez.

Los cambios en algunos parámetros se aplican a la instancia de base de datos inmediatamente sin necesidad de reiniciar. Los cambios en otros parámetros se aplican únicamente después de reiniciar la instancia de base de datos. La consola de RDS muestra el estado del grupo de parámetros de base de datos asociado a una instancia de base de datos en la pestaña Configuration (Configuración). Por ejemplo, podría darse por ejemplo que la instancia de base de datos no está utilizando los cambios más recientes del grupo de parámetros de base de datos asociado. De ser así, la consola de RDS muestra el grupo de parámetros de base de datos con el estado pending-reboot. Para aplicar los cambios de parámetros más recientes en esa instancia de base de datos, reinicie manualmente la instancia de base de datos.

nota

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

Consola

Para restablecer los parámetros de un grupo de parámetros 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.

AWS CLI

Para restablecer algunos o todos los parámetros de un grupo de parámetros de base de datos, utilice el comando AWS CLI reset-db-parameter-group con la siguiente opción requerida: --db-parameter-group-name.

Para restablecer todos los parámetros del grupo de parámetros 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-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --reset-all-parameters

En Windows:

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

En el ejemplo siguiente se restablecen las opciones max_connections y max_allowed_packet a sus valores predeterminados en el grupo de parámetros de base de datos denominado mydbparametergroup.

ejemplo

Para Linux, macOS o Unix:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

En Windows:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

El comando produce un resultado similar al siguiente:

DBParameterGroupName  mydbparametergroup

API de RDS

Para restablecer los parámetros de un grupo de parámetros de base de datos a sus valores predeterminados, utilice el comando ResetDBParameterGroup API de RDS con el siguiente parámetro requerido: DBParameterGroupName.

Para restablecer todos los parámetros del grupo de parámetros 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 base de datos

Puede copiar los grupos de parámetros de base de datos personalizados que cree. Copiar un grupo de parámetros puede ser una solución práctica. Por ejemplo, podría darse cuando haya creado un grupo de parámetros de base de datos y desee incluir la mayoría de los parámetros y valores personalizados en un nuevo grupo de parámetros de base de datos. Puede copiar un grupo de parámetros de base de datos utilizando la AWS Management Console. También puede utilizar el comando AWS CLI copy-db-parameter-group o la operación CopyDBParameterGroup de la API de RDS.

Después de copiar un grupo de parámetros de base de datos, espere al menos 5 minutos antes de crear la primera instancia de base de datos que utilice ese grupo de parámetros de base de datos como grupo de parámetros predeterminado. Esto permite a Amazon RDS finalizar por completo la acción de copia antes de que se utilice el grupo de parámetros. Esto es especialmente importante para los parámetros que son críticos al crear la base de datos predeterminada de una instancia de base de datos. Un ejemplo es el conjunto de caracteres para la base de datos predeterminada definida por el parámetro character_set_database. Utilice la opción Parameter Groups (Grupos de parámetros) de la consola de Amazon RDS o el comando describe-db-parameters para comprobar que se ha creado el grupo de parámetros 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.

No puede copiar un grupo de parámetros de base de datos en una Cuenta de AWS o Región de AWS diferente.

Consola

Para copiar un grupo de parámetros 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.

AWS CLI

Para copiar un grupo de parámetros de base de datos, utilice el comando AWS CLI de copy-db-parameter-group con las siguientes opciones requeridas:

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

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

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

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

ejemplo

Para Linux, macOS o Unix:

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

En Windows:

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

API de RDS

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

• SourceDBParameterGroupIdentifier

• TargetDBParameterGroupIdentifier

• TargetDBParameterGroupDescription

Descripción de grupos de parámetros de base de datos

Es posible obtener un listado de los grupos de parámetros 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 una instancia 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.

Consola

Para obtener una lista de todos los grupos de parámetros 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 base de datos aparecen en una lista.

AWS CLI

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

ejemplo

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

aws rds describe-db-parameter-groups

El comando devuelve una respuesta similar a la siguiente:

DBPARAMETERGROUP  default.mysql8.0     mysql8.0  Default parameter group for MySQL8.0
DBPARAMETERGROUP  mydbparametergroup   mysql8.0  My new parameter group

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

Para Linux, macOS o Unix:

aws rds describe-db-parameter-groups \
    --db-parameter-group-name mydbparamgroup1

En Windows:

aws rds describe-db-parameter-groups ^
    --db-parameter-group-name mydbparamgroup1

El comando devuelve una respuesta similar a la siguiente:

DBPARAMETERGROUP  mydbparametergroup1  mysql8.0  My new parameter group

API de RDS

Para obtener la lista de todos los grupos de parámetros de base de datos de una cuenta de AWS, utilice la operación DescribeDBParameterGroups de la API de RDS.

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

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

Consola

Para ver los valores de los parámetros de un grupo de parámetros 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 base de datos aparecen en una lista.

3. Seleccione el nombre del grupo de parámetros para ver su lista de parámetros.

AWS CLI

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

• --db-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 base de datos denominado mydbparametergroup.

aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup

El comando devuelve una respuesta similar a la siguiente:

DBPARAMETER  Parameter Name            Parameter Value  Source           Data Type  Apply Type  Is Modifiable
DBPARAMETER  allow-suspicious-udfs                      engine-default   boolean    static      false
DBPARAMETER  auto_increment_increment                   engine-default   integer    dynamic     true
DBPARAMETER  auto_increment_offset                      engine-default   integer    dynamic     true
DBPARAMETER  binlog_cache_size         32768            system           integer    dynamic     true
DBPARAMETER  socket                    /tmp/mysql.sock  system           string     static      false

API de RDS

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

• DBParameterGroupName

Eliminación de un grupo de parámetros de base de datos

Puede eliminar un grupo de parámetros de base de datos mediante la AWS Management Console, la AWS CLI o la API de RDS. Un grupo de parámetros solo se puede eliminar si no está asociado a una instancia de base de datos.

Consola

Eliminación de un grupo de parámetros 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 base de datos aparecen en una lista.

3. Elija el nombre del grupo de parámetros que se va a eliminar.

4. Elija Acciones y, a continuación, elija Eliminar.

5. Revise los nombres de los grupos de parámetros y seleccione Eliminar.

AWS CLI

Para eliminar un grupo de parámetros de base de datos, utilice el comando delete-db-parameter-group de la AWS CLI con los siguientes parámetros obligatorios:

• --db-parameter-group-name

ejemplo

En el siguiente ejemplo, se elimina un grupo de parámetros de base de datos con el nombre mydbparametergroup.

aws rds delete-db-parameter-group --db-parameter-group-name mydbparametergroup

API de RDS

Para eliminar un grupo de parámetros de base de datos, utilice la API DeleteDBParameterGroup de RDS con los siguientes parámetros obligatorios.

• DBParameterGroupName