Descrever os grupos de parâmetros de cluster do Amazon DocumentDB - Amazon DocumentDB
Descrevendo os detalhes de um grupo de parâmetros de clusterDeterminando um grupo de parâmetros de um clusterDeterminação de clusters e instâncias associados a um grupo de parâmetros de cluster

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Descrever os grupos de parâmetros de cluster do Amazon DocumentDB

Um grupo de parâmetros de cluster default é criado automaticamente quando você cria o primeiro cluster Amazon DocumentDB na nova região ou usa um novo mecanismo. Os clusters subsequentes, criados na mesma região e com a mesma versão do mecanismo, são criados com o grupo de parâmetros do cluster default.

Descrevendo os detalhes de um grupo de parâmetros de cluster do Amazon DocumentDB

Para descrever os detalhes de um determinado grupo de parâmetros de cluster, conclua as etapas a seguir usando o Console de gerenciamento da AWS ou o AWS Command Line Interface (AWS CLI).

Using the Console de gerenciamento da AWS

  1. Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.

  2. No painel de navegação, escolha Grupos de parâmetros.

    dica

    Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

  3. No painel Grupos de parâmetros de cluster, escolha o nome do grupo de parâmetros de cluster cujos detalhes deseja visualizar.

  4. A página resultante exibe os parâmetros do grupo de parâmetros, a atividade recente e as tags.

    • Em Parâmetros de cluster, é possível ver o nome do parâmetro, o valor atual, os valores permitidos, se o parâmetro é modificável, o tipo de aplicação, o tipo de dado e a descrição. É possível modificar parâmetros individuais selecionando o parâmetro e escolhendo Editar na seção Parâmetros de cluster. Para obter mais informações, consulte Modificando os parâmetros de cluster do Amazon DocumentDB.

    • Em Eventos recentes, é possível ver os eventos mais recentes para esse grupo de parâmetros. É possível filtrar esses eventos usando a barra de pesquisa nesta seção. Para obter mais informações, consulte Gerenciando eventos do Amazon DocumentDB.

    • Em Tags, você pode ver as tags nesse grupo de parâmetro do cluster. É possível adicionar ou remover tags escolhendo Editar na seção Tags. Para obter mais informações, consulte Marcação de recursos do Amazon DocumentDB.

Using the AWS CLI

Você pode usar o describe-db-cluster-parameter-groups AWS CLI comando para visualizar o Amazon Resource Name (ARN), a família, a descrição e o nome de um único grupo de parâmetros de cluster ou de todos os grupos de parâmetros de cluster que você tem para o Amazon DocumentDB. Você também pode usar o describe-db-cluster-parameters AWS CLI comando para visualizar os parâmetros e seus detalhes dentro de um único grupo de parâmetros do cluster.

  • --describe-db-cluster-parameter-groups — para ver uma lista de todos os grupos de parâmetros de cluster e seus detalhes.

    • --db-cluster-parameter-group-name — Opcional. O nome do grupo de parâmetro de cluster que você deseja descrever. Se esse parâmetro for omitido, todos os grupos de parâmetro de cluster serão descritos.

  • --describe-db-cluster-parameters — para listar todos os parâmetros em um grupo de parâmetros e seus valores.

    • --db-cluster-parameter-group name — obrigatório. O nome do grupo de parâmetro de cluster que você deseja descrever.

exemplo

O código a seguir lista até 100 grupos de parâmetros de cluster e seus ARNs, famílias, descrições e nomes.

aws docdb describe-db-cluster-parameter-groups

A saída dessa operação é semelhante ao seguinte (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"
              }
          ]
}
exemplo

O código a seguir lista o ARN, a família, a descrição e o nome do sample-parameter-group.

Para Linux, macOS ou 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

A saída dessa operação é semelhante ao seguinte (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"
              }
          ]
}
exemplo

O código a seguir lista os valores dos parâmetros no sample-parameter-group.

Para Linux, macOS ou 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

A saída dessa operação é semelhante ao seguinte (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"
         }
   ]
}

Determinando o grupo de parâmetros de um cluster do Amazon DocumentDB

Para determinar qual grupo de parâmetros está associado a um determinado cluster, conclua as etapas a seguir usando o Console de gerenciamento da AWS ou AWS CLI o.

Using the Console de gerenciamento da AWS

  1. Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.

  2. No painel de navegação à esquerda, escolha Clusters.

  3. Na lista de clusters, selecione o nome do cluster desejado.

  4. A página resultante exibe os detalhes do cluster selecionado. Role para baixo até Detalhes do cluster. Na parte inferior dessa seção, localize o nome do grupo de parâmetros sob Grupo de parâmetros de cluster.

    Captura de tela: como mostrar um grupo de parâmetros de um cluster.
Using the AWS CLI

O AWS CLI código a seguir determina qual grupo de parâmetros está governando o clustersample-cluster.

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

A saída dessa operação é semelhante ao seguinte (formato JSON).

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

Determinação de clusters e instâncias associados a um grupo de parâmetros de cluster do Amazon DocumentDB

Para determinar quantos clusters e instâncias estão associados a cada grupo de parâmetros, conclua as etapas a seguir usando AWS CLI o.

Using the AWS CLI

O AWS CLI código a seguir determina a quantos clusters e instâncias estão associadossample-parameter-group.

Para Linux, macOS ou 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
      }) | .[]'

A saída dessa operação é semelhante ao seguinte (formato JSON).

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