Creación de un grupo de parámetros de clúster de base de datos Modificación de parámetros de un grupo de parámetros de clúster de base de datos Restablecimiento de parámetros de un grupo de parámetros de clúster de base de datos Copia de un grupo de parámetros de clúster de base de datos Descripción de grupos de parámetros de clúster de base de datos Visualización de los valores de los parámetros de un grupo de parámetros de clúster de base de datos Eliminación de un grupo de parámetros de clúster

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.

Temas

Creación de un grupo de parámetros de clúster de base de datos
Modificación de parámetros de un grupo de parámetros de clúster de base de datos
Restablecimiento de parámetros de un grupo de parámetros de clúster de base de datos
Copia de un grupo de parámetros de clúster de base de datos
Descripción de grupos de parámetros de clúster de base de datos
Visualización de los valores de los parámetros de un grupo de parámetros de clúster de base de datos
Eliminación de un grupo de parámetros de clúster

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.

Se aplican las siguientes limitaciones al nombre del grupo de parámetros de clústeres 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.aurora-mysql5.7. 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.

Para crear un grupo de parámetros de clúster de base de datos

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).
Elija Create parameter group.

Aparece la ventana Create parameter group (Crear grupo de parámetros).
En la lista Parameter group family (Familia de grupos de parámetros), seleccione una familia de grupos de parámetros de base de datos.
En la lista Tipo, seleccione Grupo de parámetros de clúster de base de datos.
En el cuadro Group name (Nombre de grupo), escriba el nombre del nuevo grupo de parámetros de clúster de base de datos.
En el cuadro Description (Descripción), escriba una descripción para el nuevo grupo de parámetros de clúster de base de datos.
Seleccione Create (Crear).

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"

En 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

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).
En la lista, seleccione el grupo de parámetros que desea modificar.
En Parameter group actions (Acciones de grupos de parámetros), seleccione Edit (Editar).
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.
Elija Save changes.
Reinicie la instancia de base de datos principal (de escritura) en el clúster para aplicar los cambios.
A continuación, reinicie las instancias de base de datos de lectura para aplicarles los cambios.

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"

En 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

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).
En la lista, elija el grupo de parámetros.
En Parameter group actions (Acciones de grupos de parámetros), seleccione Edit (Editar).
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.
Elija Restablecer y, a continuación, confirme seleccionando Restablecer parámetros.
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

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

En 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.

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

Para copiar un grupo de parámetros de clúster de base de datos

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).
En la lista, seleccione el grupo de parámetros personalizado que desea copiar.
En Parameter group actions (Acciones de grupos de parámetros), seleccione Copy (Copiar).
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.
En Description (Descripción), escriba una descripción para el nuevo grupo de parámetros.
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"

En 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

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
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

En 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

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
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.
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

En algunos casos, no se muestran los valores permitidos para un parámetro. Estos son siempre parámetros en los que el origen es el predeterminado del motor de base de datos.

Para ver los valores de estos parámetros, puede ejecutar las siguientes instrucciones SQL:

MySQL:


-- Show the value of a particular parameter
mysql$ SHOW VARIABLES LIKE '%parameter_name%';

-- Show the values of all parameters
mysql$ SHOW VARIABLES;

PostgreSQL:


-- Show the value of a particular parameter
postgresql=> SHOW parameter_name;

-- Show the values of all parameters
postgresql=> SHOW ALL;

Eliminación de un grupo de parámetros de clúster

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

Para eliminar grupos de parámetros

Inicie sesión en la AWS Management Console y abra la consola de Amazon RDS en https://console.aws.amazon.com/rds/.
En el panel de navegación, seleccione Parameter groups (Grupos de parámetros).

Los grupos de parámetros aparecen en una lista.
Elija el nombre del grupo de parámetros de clúster de base de datos que se va a eliminar.
Elija Acciones y, a continuación, elija Eliminar.
Revise los nombres de los grupos de parámetros y seleccione Eliminar.

Para eliminar un grupo de parámetros de clúster de base de datos, utilice el comando delete-db-cluster-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 clúster de base de datos con el nombre mydbparametergroup.


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

Para eliminar un grupo de parámetros de clúster de base de datos, utilice el comando DeleteDBClusterParameterGroup de la API de RDS con los siguientes parámetros obligatorios.

DBParameterGroupName

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Trabajo con los grupos de parámetros de base de datos

Comparación de grupos de parámetros de la base de datos