View a markdown version of this page

Descrizione dei gruppi di parametri del cluster Amazon DocumentDB - Amazon DocumentDB
Descrizione dei dettagli di un gruppo di parametri del clusterDeterminazione del gruppo di parametri di un clusterDeterminazione dei cluster e delle istanze associati a un gruppo di parametri del cluster

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Descrizione dei gruppi di parametri del cluster Amazon DocumentDB

Un gruppo di parametri del default cluster viene creato automaticamente quando si crea il primo cluster Amazon DocumentDB in una nuova regione o si utilizza un nuovo motore. I cluster successivi, creati nella stessa regione e con la stessa versione del motore, vengono creati con il default gruppo di parametri del cluster.

Descrizione dei dettagli di un gruppo di parametri del cluster Amazon DocumentDB

Per descrivere i dettagli di un determinato gruppo di parametri del cluster, completa i seguenti passaggi utilizzando Console di gestione AWS o il AWS Command Line Interface (AWS CLI).

Using the Console di gestione AWS

  1. Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.

  2. Nel riquadro di navigazione scegliere Parameter groups (Gruppi di parametri).

    Suggerimento

    Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (Hamburger menu icon with three horizontal lines.) nell'angolo in alto a sinistra della pagina.

  3. Nel riquadro Parameter groups (Gruppi di parametri), selezionare il gruppo di parametri del cluster di cui si desidera visualizzare i dettagli.

  4. La pagina risultante mostra i parametri, l'attività recente e i tag del gruppo di parametri.

    • In Cluster parameters (Parametri cluster) puoi vedere il nome, il valore corrente, i valori consentiti, il tipo di dati e la descrizione del parametro e specifica se il parametro è modificabile. Puoi modificare i singoli parametri selezionando il parametro e scegliendo Edit (Modifica) nella sezione Cluster parameters (Parametri cluster). Per ulteriori informazioni, consulta Modifica dei parametri del cluster Amazon DocumentDB.

    • In Recent events (Eventi recenti), puoi vedere gli eventi più recenti per questo gruppo di parametri. Puoi filtrare questi eventi utilizzando la barra di ricerca in questa sezione. Per ulteriori informazioni, consulta Gestione degli eventi di Amazon DocumentDB.

    • In Tags (Tag) puoi visualizzare i tag di questo gruppo di parametri del cluster. Puoi aggiungere o rimuovere i tag scegliendo Edit (Modifica) nella sezione Tags (Tag). Per ulteriori informazioni, consulta Etichettatura delle risorse di Amazon DocumentDB.

Using the AWS CLI

Puoi utilizzare il describe-db-cluster-parameter-groups AWS CLI comando per visualizzare Amazon Resource Name (ARN), famiglia, descrizione e nome di un singolo gruppo di parametri del cluster o di tutti i gruppi di parametri del cluster di cui disponi per Amazon DocumentDB. Puoi anche utilizzare il describe-db-cluster-parameters AWS CLI comando per visualizzare i parametri e i relativi dettagli all'interno di un singolo gruppo di parametri del cluster.

  • --describe-db-cluster-parameter-groups— Per visualizzare un elenco di tutti i gruppi di parametri del cluster e i relativi dettagli.

    • --db-cluster-parameter-group-name— Facoltativo. Il nome del gruppo di parametri del cluster da descrivere. Se questo parametro viene omesso, vengono descritti tutti i gruppi di parametri del cluster.

  • --describe-db-cluster-parameters— Per elencare tutti i parametri all'interno di un gruppo di parametri e i relativi valori.

    • --db-cluster-parameter-group name: obbligatorio. Il nome del gruppo di parametri del cluster da descrivere.

Esempio

Il codice seguente elenca fino a 100 gruppi di parametri del cluster con relativi ARN, famiglia, descrizione e nome.

aws docdb describe-db-cluster-parameter-groups

L'aspetto dell'output di questa operazione è simile al seguente (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"
              }
          ]
}
Esempio

Il codice seguente elenca l'ARN, la famiglia, la descrizione e il nome per sample-parameter-group.

Per Linux, macOS o Unix:

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

Per Windows:

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

L'aspetto dell'output di questa operazione è simile al seguente (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"
              }
          ]
}
Esempio

Il codice seguente elenca i valori dei parametri in sample-parameter-group.

Per Linux, macOS o Unix:


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

Per Windows:


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

L'aspetto dell'output di questa operazione è simile al seguente (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"
         }
   ]
}

Determinazione del gruppo di parametri di un cluster Amazon DocumentDB

Per determinare quale gruppo di parametri è associato a un particolare cluster, completa i passaggi seguenti utilizzando Console di gestione AWS o il AWS CLI.

Using the Console di gestione AWS

  1. Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.

  2. Nel pannello di navigazione a sinistra, seleziona Cluster.

  3. Dall'elenco dei cluster seleziona il nome del cluster desiderato.

  4. La pagina risultante mostra i dettagli del cluster selezionato. Scorri verso il basso fino a Cluster details (Dettagli del cluster). Nella parte inferiore della sezione, individua il nome del gruppo di parametri sotto Cluster parameter group (Gruppo di parametri del cluster).

    Screenshot: visualizzazione del gruppo di parametri di un cluster.
Using the AWS CLI

Il AWS CLI codice seguente determina quale gruppo di parametri governa il cluster. sample-cluster

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

L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).

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

Determinazione di cluster e istanze associati a un gruppo di parametri del cluster Amazon DocumentDB

Per determinare il numero di cluster e istanze associati a ciascun gruppo di parametri, completa i passaggi seguenti utilizzando. AWS CLI

Using the AWS CLI

Il AWS CLI codice seguente determina a quanti cluster e istanze sono associati. sample-parameter-group

Per 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
      }) | .[]'

Per 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
      }) | .[]'

L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).

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