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 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 AWS Management Console ou a AWS Command Line Interface (AWS CLI).

Using the AWS Management Console

  1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/emr/clusters.

  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

É possível usar o comando describe-db-cluster-parameter-groups AWS CLI para visualizar o nome do recurso da Amazon (ARN), a família, a descrição e o nome de um único grupo de parâmetros de cluster, ou todos os grupos de parâmetros de cluster para o Amazon DocumentDB. Também é possível usar o comando describe-db-cluster-parameters AWS CLI para exibir os parâmetros e seus detalhes em um único grupo de parâmetros de 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.

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"
              }
          ]
}

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"
              }
          ]
}

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 cluster específico, conclua as etapas a seguir usando AWS Management Console ou AWS CLI.

Using the AWS Management Console

  1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/emr/clusters.

  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 código de AWS CLI a seguir determina qual grupo de parâmetros está regendo o cluster sample-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"
       ]
]