Creación de grupos de parámetros de clúster de Amazon DocumentDB - Amazon DocumentDB

Creación de grupos de parámetros de clúster de Amazon DocumentDB

Los grupos de parámetros de clúster predeterminados como default.docdb5.0, default.docdb4.0 o default.docdb3.6, se crean al crear un clúster con una nueva versión del motor y en una nueva región. Los clústeres siguientes que se creen en esta región y tengan la misma versión de motor heredan el grupo de parámetros de clúster default. Una vez creados, los grupos de parámetros default no se pueden eliminar ni cambiar de nombre. Puede modificar el comportamiento del motor de las instancias de clúster creando un grupo de parámetros personalizado con los valores de parámetros preferidos y adjuntándolo a su clúster de Amazon DocumentDB.

El siguiente procedimiento le guía a través de la creación de un grupo de parámetros de clúster personalizado. A continuación, puede modificar los parámetros dentro de ese grupo de parámetros.

nota

Después de crear un grupo de parámetros de clúster, debe esperar al menos 5 minutos antes de usar ese grupo de parámetros en concreto. Esto permite a create finalizar por completo la acción Amazon DocumentDB antes de que el grupo de parámetros de clúster se use para un nuevo clúster. Puede utilizar la AWS Management Console o la operación describe-db-cluster-parameter-groups de la AWS CLI para verificar que el grupo de parámetros de clúster se haya creado. Para obtener más información, consulte Descripción de los grupos de parámetros de clúster de Amazon DocumentDB.

Using the AWS Management Console
Creación de un grupo de parámetros de clúster
  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

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

    sugerencia

    Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (Hamburger menu icon with three horizontal lines.) en la esquina superior izquierda de la página.

  3. En el panel Cluster parameter groups (Grupos de parámetros del clúster), elija Create (Crear).

  4. En el panel Create cluster parameter group (Crear grupo de parámetros de clúster) escriba lo siguiente:

    1. Nombre del grupo: escriba un nombre para el grupo de parámetros de clúster. Por ejemplo, sample-parameter-group. Los grupos de parámetros de clúster tienen las siguientes restricciones de denominación:

      • La longitud es de [1-255] caracteres alfanuméricos.

      • El primer carácter debe ser una letra.

      • No puede terminar por un guion ni contener dos guiones consecutivos.

    2. Descripción: proporcione una descripción para este grupo de parámetros de clúster.

  5. Para crear el grupo de parámetros de clúster, elija Create (Crear). Para cancelar la operación, elija Cancel (Cancelar).

  6. Después de seleccionar Create (Crear), aparece el siguiente texto en la parte superior de la página para comprobar que el grupo de parámetros de clúster se ha creado correctamente:

    Successfully created cluster parameter group 'sample-parameter-group'.
Using the AWS CLI

Para crear un nuevo grupo de parámetros de clúster para clústeres de Amazon DocumentDB 4.0, utilice la operación create-db-cluster-parameter-group de la AWS CLI con los siguientes parámetros:

  • --db-cluster-parameter-group-name: el nombre del grupo de parámetros de clúster de base de datos. Por ejemplo, sample-parameter-group.

  • --db-cluster-parameter-group-family: la familia de grupos de parámetros de clúster que se utiliza como plantilla para el grupo de parámetros de clúster personalizado. Actualmente, tiene que ser docdb4.0.

  • --description: la descripción proporcionada por el usuario para este grupo de parámetros de clúster. El siguiente ejemplo utiliza “Custom docdb4.0 parameter group”.

Para Linux, macOS o Unix:

aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --db-parameter-group-family docdb4.0 \ --description "Custom docdb4.0 parameter group"

Para Windows:

aws docdb create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --db-parameter-group-family docdb4.0 ^ --description "Custom docdb4.0 parameter group"

La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

{ "DBClusterParameterGroup": { "DBClusterParameterGroupName": "sample-parameter-group", "DBParameterGroupFamily": "docdb4.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupArn": "sample-parameter-group-arn" } }