Modifica dei parametri del cluster Amazon DocumentDB

In Amazon DocumentDB, i gruppi di parametri del cluster sono costituiti da parametri che si applicano a tutte le istanze create nel cluster. Per i gruppi di parametri del cluster personalizzati, puoi modificare un valore di parametro in qualsiasi momento o reimpostare tutti i valori dei parametri sulle impostazioni predefinite per i gruppi di parametri creati. Questa sezione descrive come visualizzare i parametri che costituiscono un gruppo di parametri del cluster Amazon DocumentDB e i relativi valori e come modificare o aggiornare questi valori.

I parametri possono essere dinamici o statici. Quando modifichi un parametro dinamico e salvi il gruppo di parametri del cluster, la modifica viene applicata immediatamente, indipendentemente dall'impostazione Apply Immediately. Quando modifichi un parametro statico e salvi il gruppo di parametri del cluster, la modifica del parametro viene applicata solo dopo che avrai riavviato manualmente le istanze.

Visualizzazione dei parametri di un gruppo di parametri del cluster Amazon DocumentDB

Puoi visualizzare i parametri di un cluster Amazon DocumentDB e i relativi valori utilizzando o. AWS Management Console AWS CLI

Using the AWS Management Console

Per visualizzare i dettagli di un gruppo di parametri del cluster

1. Accedi a e apri AWS Management Console 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 () nell'angolo in alto a sinistra della pagina.

3. Nel riquadro Parameter groups (Gruppi di parametri), scegli il nome del gruppo di parametri del cluster di cui desideri visualizzare i dettagli.

4. La pagina risultante mostra i seguenti valori per ciascun parametro: nome del parametro, valore corrente, valori consentiti, se il parametro è modificabile, tipo di applicazione, tipo di dati e descrizione.

   

Using the AWS CLI

Per visualizzare i parametri e i valori di un gruppo di parametri del cluster, utilizza l'operazione describe-db-cluster-parameters con i parametri seguenti.

• --db-cluster-parameter-group-name: obbligatorio. Il nome del gruppo di parametri del cluster di cui ottenere un elenco di parametri dettagliato.

• --source— Facoltativo. Se fornito, restituisce solo i parametri per una determinata origine. Le origini dei parametri possono essere engine-default, system o user.

Il codice seguente elenca i parametri e i relativi valori per il gruppo di parametri custom3-6-param-grp. Per ulteriori informazioni sul gruppo di parametri, ometti la riga --query. Per informazioni su tutti i gruppi di parametri, ometti la riga --db-cluster-parameter-group-name.

Per Linux, macOS o Unix:

aws docdb describe-db-cluster-parameters \
   --db-cluster-parameter-group-name custom3-6-param-grp \
   --query 'Parameters[*].[ParameterName,ParameterValue]'

Per Windows:

aws docdb describe-db-cluster-parameters ^
   --db-cluster-parameter-group-name custom3-6-param-grp ^
   --query 'Parameters[*].[ParameterName,ParameterValue]'

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

[
    [
        "audit_logs",
        "disabled"
    ],
    [
        "tls",
        "enabled"
    ],
    [
        "ttl_monitor",
        "enabled"
    ]
]

Modifica dei parametri di un gruppo di parametri del cluster Amazon DocumentDB

Puoi modificare i parametri di un gruppo di parametri utilizzando la AWS Management Console o l'AWS CLI.

Using the AWS Management Console

Per aggiornare i parametri di un gruppo di parametri del cluster

1. Accedi a e apri AWS Management Console 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 () nell'angolo in alto a sinistra della pagina.

3. Nel riquadro Parameter groups (Gruppi di parametri) scegliere il gruppo di parametri del cluster di cui si desidera aggiornare i parametri.

4. La pagina risultante mostra i parametri e i relativi dettagli corrispondenti per questo gruppo di parametri del cluster. Selezionare un parametro da aggiornare.

5. In alto a destra della pagina, scegliere Edit (Modifica) per modificare il valore del parametro. Per ulteriori informazioni sui tipi di parametri del cluster, consulta Riferimento ai parametri del cluster Amazon DocumentDB.

6. Apportare la modifica, quindi scegliere Modify cluster parameter (Modifica parametro cluster) per salvare le modifiche. Per annullare le modifiche, selezionare Cancel (Annulla).

Using the AWS CLI

Per modificare i parametri di un gruppo di parametri del cluster, utilizzare l'operazione modify-db-cluster-parameter-group con i parametri seguenti.

• --db-cluster-parameter-group-name: obbligatorio. Il nome del gruppo di parametri del cluster che stai modificando.

• --parameters: obbligatorio. Il parametro o i parametri che stai modificando. Ogni voce del parametro deve includere:

  • ParameterName— Il nome del parametro che stai modificando.

  • ParameterValue— Il nuovo valore per questo parametro.

  • ApplyMethod— Come si desidera applicare le modifiche a questo parametro. I valori consentiti sono immediate e pending-reboot.

    Nota

    I parametri con ApplyType per static devono avere ApplyMethod per pending-reboot.

Per modificare i valori dei parametri di un gruppo di parametri del cluster (AWS CLI)

L'esempio seguente cambia il parametro tls.

1. Elenca i parametri e i relativi valori di 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": [
           {
               "Source": "system",
               "ApplyType": "static",
               "AllowedValues": "disabled,enabled",
               "ParameterValue": "enabled",
               "ApplyMethod": "pending-reboot",
               "DataType": "string",
               "ParameterName": "tls",
               "IsModifiable": true,
               "Description": "Config to enable/disable TLS"
           },
           {
               "Source": "user",
               "ApplyType": "dynamic",
               "AllowedValues": "disabled,enabled",
               "ParameterValue": "enabled",
               "ApplyMethod": "pending-reboot",
               "DataType": "string",
               "ParameterName": "ttl_monitor",
               "IsModifiable": true,
               "Description": "Enables TTL Monitoring"
           }
       ]
   }

2. Modifica il parametro tls in modo che il relativo valore sia disabled. Non puoi modificare ApplyMethod perché ApplyType è static.

   Per Linux, macOS o Unix:

   aws docdb modify-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"

   Per Windows:

   aws docdb modify-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"

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

   {
       "DBClusterParameterGroupName": "sample-parameter-group"
   }

3. Attendi almeno 5 minuti.

4. Elenca i valori dei parametri di 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": "tls",
               "ParameterValue": "disabled",
               "Description": "Config to enable/disable TLS",
               "Source": "user",
               "ApplyType": "static",
               "DataType": "string",
               "AllowedValues": "disabled,enabled",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           }
       ]
   }