Modifica dei gruppi di parametri del cluster Amazon DocumentDB - Amazon DocumentDB

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à.

Modifica dei gruppi di parametri del cluster Amazon DocumentDB

Questa sezione spiega come modificare un gruppo di parametri Amazon DocumentDB personalizzato. In Amazon DocumentDB, non è possibile modificare un gruppo di parametri del default cluster creato quando si crea per la prima volta un cluster con una nuova versione del motore in una nuova regione. Se il tuo cluster Amazon DocumentDB utilizza il gruppo di parametri del cluster predefinito e desideri modificare un valore al suo interno, devi prima creare un nuovo gruppo di parametri o copiare un gruppo di parametri esistente, modificarlo e quindi applicare il gruppo di parametri modificato al cluster.

Completa i seguenti passaggi per modificare un gruppo di parametri del cluster personalizzato. La propagazione delle azioni di modifica potrebbe richiedere del tempo. Attendi che il gruppo di parametri del cluster modificato sia disponibile prima di collegarlo al cluster. Puoi utilizzare la AWS Management Console o l'operazione describe-db-cluster-parameters dell'AWS CLI per verificare che il gruppo di parametri del cluster sia stato modificato. Per ulteriori informazioni, consulta Descrizione dei gruppi di parametri del cluster.

Using the AWS Management Console

Segui questi passaggi per modificare un gruppo di parametri Amazon DocumentDB personalizzato. Non puoi modificare un gruppo di parametri default. Se desideri modificare un valore nel gruppo di parametri default, puoi copiare il gruppo di parametri del cluster predefinito, modificarlo e quindi applicare il gruppo di parametri modificato al cluster. Per ulteriori informazioni sull'applicazione dei gruppi di parametri al cluster, consulta Modifica di un cluster Amazon DocumentDB.

Per modificare un gruppo di parametri del cluster personalizzato

  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 sul lato sinistro della console scegli Parameter groups (Gruppi di parametri). Nell'elenco dei gruppi di parametri, scegli il nome del gruppo di parametri da modificare.

    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. Per ogni parametro nel gruppo di parametri che desideri modificare, procedi nel seguente modo:

    1. Individua il parametro che vuoi modificare e verifica che sia modificabile controllando se è elencato come true nella colonna Modifiable (Modificabile).

    2. Se è modificabile, seleziona il parametro e scegli Edit (Modifica) in alto a destra nella pagina della console.

    3. Nella finestra di dialogo Modify <parameter-name> (Modifica), apporta le modifiche desiderate. Quindi scegli Modify cluster parameter (Modifica parametro del cluster) oppure scegli Cancel (Annulla) per annullare le modifiche.

Using the AWS CLI

Puoi modificare o modificare qualsiasi parametro modificabile in un gruppo ApplyMethod di parametri del cluster Amazon DocumentDB personalizzato utilizzando il. ParameterValue Description AWS CLI Non puoi apportare modifiche direttamente in un gruppo di parametri del cluster predefinito.

Per modificare i parametri di un gruppo di parametri del cluster personalizzato, utilizza 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. I parametri che stai modificando. Per un elenco dei parametri che si applicano a tutte le istanze in un cluster Amazon DocumentDB, consulta la. Riferimento ai parametri del cluster Amazon DocumentDB 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.

Esempio - Modifica del valore di un parametro

In questo esempio, puoi elencare i valori dei parametri di sample-parameter-group e modificare il parametro tls. Quindi, dopo 5 minuti, puoi elencare di nuovo i valori dei parametri di sample-parameter-group per visualizzare i valori modificati.

  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 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 verificare che il parametro tls sia stato modificato.

    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": [
           {
               "ParameterValue": "false",
               "ParameterName": "enable_audit_logs",
               "ApplyType": "dynamic",
               "DataType": "string",
               "Description": "Enables auditing on cluster.",
               "AllowedValues": "true,false",
               "Source": "system",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           },
           {
               "ParameterValue": "disabled",
               "ParameterName": "tls",
               "ApplyType": "static",
               "DataType": "string",
               "Description": "Config to enable/disable TLS",
               "AllowedValues": "disabled,enabled",
               "Source": "system",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           }
       ]
}