Trabajo con los grupos de parámetros de base de datos - Amazon Relational Database Service

Trabajo con los grupos de parámetros 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.

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.

    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 Parameter Group (Grupo de parámetros de base de datos).

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

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

  8. Seleccione Create (Crear).

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"

Para 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

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 parámetros dinámicos en el grupo de parámetros de base de datos recién asociado, dichos cambios se aplican inmediatamente sin reiniciar.

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.

  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 Uso de la configuración de aplicación inmediata.

  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.

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 Uso de la configuración de aplicación inmediata.

ejemplo

Para Linux, macOS o Unix:

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

Para Windows:

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

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, si la instancia de base de datos no está utilizando los cambios más recientes del grupo de parámetros de base de datos que tiene asociado, 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.


				Escenario de cambios de parámetros pendientes de reinicio

Para modificar 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 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.

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"

Para 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

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, pero 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 y puede restablecer 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, si la instancia de base de datos no está utilizando los cambios más recientes del grupo de parámetros de base de datos que tiene asociado, 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.


				Escenario de cambios de parámetros pendientes de reinicio
nota

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

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

Para 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"

Para 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

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 es una solución conveniente cuando ya se ha creado un grupo de parámetros 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 base de datos. Puede copiar un grupo de parámetros de base de datos mediante la AWS Management Console, el comando copy-db-parameter-group de la AWS CLI 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.

Actualmente, no puede copiar un grupo de parámetros en una región de AWS diferente.

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.

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"

Para 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"

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.

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.

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

Para 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

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.

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.

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

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