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
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-familymysql8.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-familymysql8.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
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-identifiermygroup2
\ --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-identifiermygroup2
^ --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