View a markdown version of this page

Descripción de los grupos de parámetros de clúster de Amazon DocumentDB - Amazon DocumentDB
Descripción de los detalles de un grupo de parámetros de clústerDeterminación del grupo de parámetros de un clústerDeterminar los clústeres e instancias asociados a un grupo de parámetros de clúster

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

UN default El grupo de parámetros de clúster se crea automáticamente al crear el primer clúster de Amazon DocumentDB en un nuevo Región de AWS o están usando un motor nuevo. Los clústeres subsiguientes, que se crean en la misma región y tienen la misma versión de motor, se crean con el default grupo de parámetros de clúster.

Descripción de los detalles de un grupo de parámetros de clúster de Amazon DocumentDB

Para describir los detalles de un grupo de parámetros de clúster determinado, complete los pasos siguientes mediante el Consola de administración de AWS o el AWS Command Line Interface (AWS CLI).

Using the Consola de administración de AWS

  1. Inicie sesión en el Consola de administración de AWS y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

  2. En el panel de navegación, seleccione Grupos de parámetros.

    sugerencia

    Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (Menu button.) en la esquina superior izquierda de la página.

  3. En el panel Cluster parameter groups (Grupos de parámetros de clúster), seleccione el nombre del grupo de parámetros cuyos detalles desee ver.

  4. La página resultante muestra los parámetros del grupo de parámetros, la actividad reciente y las etiquetas.

    • En Cluster parameters (Parámetros de clúster), puede ver el nombre del parámetro, el valor actual, los valores permitidos, si el parámetro es modificable, su tipo de aplicación, tipo de datos y descripción. Puede modificar parámetros individuales seleccionando el parámetro y eligiendo Edit (Editar) en la sección Cluster parameters (Parámetros de clúster) . Para obtener más información, consulte Modificación de parámetros de clúster de Amazon DocumentDB.

    • En Recent events (Eventos recientes), puede ver los eventos más recientes de este grupo de parámetros. Puede filtrar estos eventos mediante la barra de búsqueda de esta sección. Para obtener más información, consulte Administración de eventos de Amazon DocumentDB.

    • En Tags (Etiquetas), puede ver las etiquetas que se encuentran en este grupo de parámetros de clúster. Puede agregar o quitar etiquetas seleccionando Edit (Editar) en la sección Tags (Etiquetas) . Para obtener más información, consulte Etiquetado de recursos de Amazon DocumentDB.

Using the AWS CLI

Puedes usar el describe-db-cluster-parameter-groups AWS CLI comando para ver el nombre del recurso de Amazon (ARN), la familia, la descripción y el nombre de un único grupo de parámetros de clúster o de todos los grupos de parámetros de clúster que tenga para Amazon DocumentDB. También puede utilizar el describe-db-cluster-parameters AWS CLI comando para ver los parámetros y sus detalles dentro de un único grupo de parámetros de clúster.

  • --describe-db-cluster-parameter-groups: para ver una lista de todos los grupos de parámetros de clúster y sus detalles.

    • --db-cluster-parameter-group-name: opcional. El nombre del grupo de parámetros de clúster que desea describir. Si se omite este parámetro, se describen todos los grupos de parámetros de clúster.

  • --describe-db-cluster-parameters: para obtener una lista de los parámetros de un grupo de parámetros, junto con sus valores.

    • --db-cluster-parameter-group name: obligatorio. El nombre del grupo de parámetros de clúster que desea describir.

ejemplo

El código siguiente enumera hasta 100 grupos de parámetros de clúster y su ARN, familia, descripción y nombre.

aws docdb describe-db-cluster-parameter-groups

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

{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Default cluster parameter group for docdb4.0",
                  "DBClusterParameterGroupName": "default.docdb4.0"
              },
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}
ejemplo

El código siguiente enumera el ARN, la familia, la descripción y el nombre de sample-parameter-group.

Para Linux, macOS o Unix:

aws docdb describe-db-cluster-parameter-groups \
          --db-cluster-parameter-group-name sample-parameter-group

Para Windows:

aws docdb describe-db-cluster-parameter-groups ^
          --db-cluster-parameter-group-name sample-parameter-group

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

{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}
ejemplo

El código siguiente enumera los valores de los parámetros de sample-parameter-group.

Para Linux, macOS o Unix:


aws docdb describe-db-cluster-parameters \
    --db-cluster-parameter-group-name sample-parameter-group

Para Windows:


aws docdb describe-db-cluster-parameters ^
    --db-cluster-parameter-group-name sample-parameter-group

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

{
   "Parameters": [
         {
            "ParameterName": "audit_logs",
            "ParameterValue": "disabled",
            "Description": "Enables auditing on cluster.",
            "Source": "system",
            "ApplyType": "dynamic",
            "DataType": "string",
            "AllowedValues": "enabled,disabled",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         },
         {
            "ParameterName": "change_stream_log_retention_duration",
            "ParameterValue": "17777",
            "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
            "Source": "user",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "3600-86400",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         }
   ]
}

Determinación del grupo de parámetros de un clúster de Amazon DocumentDB

Para determinar qué grupo de parámetros está asociado a un clúster concreto, complete los pasos siguientes con el Consola de administración de AWS o el AWS CLI.

Using the Consola de administración de AWS

  1. Inicia sesión en el Consola de administración de AWS y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

  2. En el panel de navegación izquierdo, elija Clusters (Clústeres).

  3. En la lista de clústeres, elija el nombre del clúster de su interés.

  4. La página resultante muestra los detalles del clúster seleccionado. Desplácese hacia abajo hasta Cluster details (Detalles del clúster). En la parte inferior de esa sección, busque el nombre del grupo de parámetros debajo del grupo de parámetros de clúster.

    Captura de pantalla que muestra un grupo de parámetros de un clúster.
Using the AWS CLI

Lo siguiente AWS CLI el código determina qué grupo de parámetros gobierna el clúster sample-cluster.

aws docdb describe-db-clusters \
      --db-cluster-identifier sample-cluster \
      --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'

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

[
       [
           "sample-cluster",
           "sample-parameter-group"
       ]
]

Determinar los clústeres e instancias asociados a un grupo de parámetros de clústeres de Amazon DocumentDB

Para determinar cuántos clústeres e instancias están asociados a cada grupo de parámetros, complete los pasos siguientes mediante el AWS CLI.

Using the AWS CLI

Lo siguiente AWS CLI el código determina a cuántos clústeres e instancias están asociados sample-parameter-group.

Para Linux, macOS o Unix:

aws docdb describe-db-clusters \
      --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
      --output json | \
      jq -r 'group_by(.[0]) | map({
         parameter_group_name: .[0][0],
         total_clusters: length,
         total_instances: map(.[2] | length) | add // 0
      }) | .[]'

Para Windows:

aws docdb describe-db-clusters ^
      --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
      --output json | ^
      jq -r 'group_by(.[0]) | map({
         parameter_group_name: .[0][0],
         total_clusters: length,
         total_instances: map(.[2] | length) | add // 0
      }) | .[]'

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

{
   "parameter_group_name": "sample-parameter-group",
   "total_clusters": 50,
   "total_instances": 150
}