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

# Riferimento ai parametri del cluster Amazon DocumentDB
<a name="cluster_parameter_groups-list_of_parameters"></a>

Quando modifichi un parametro dinamico e salvi il gruppo di parametri del cluster, la modifica viene applicata immediatamente, indipendentemente dall'impostazione *Apply Immediately (Applica immediatamente)*. Quando modifichi un parametro statico e salvi il gruppo di parametri del cluster, la modifica del parametro viene applicata dopo che avrai riavviato manualmente l'istanza. Puoi riavviare un'istanza utilizzando la console Amazon DocumentDB o chiamando esplicitamente. `reboot-db-instance`

La tabella seguente mostra i parametri che si applicano a tutte le istanze in un cluster Amazon DocumentDB. 


**Parametri a livello di cluster Amazon DocumentDB**  

| Parametro | Valore predefinito | Valori validi | Modificabile | Applica tipo | Tipo di dati | Description | 
| --- | --- | --- | --- | --- | --- | --- | 
| audit\$1logs | disabled | abilitati, disabilitati, ddl, dml\$1read, dml\$1write, all, none | Sì | Dinamico | Stringa | Definisce se i log CloudWatch di controllo di Amazon sono abilitati. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Sì | Dinamico | Numero intero | Definisce la durata del tempo (in secondi) in cui il registro del flusso di modifiche viene mantenuto e può essere consumato.  | 
| default\$1collection\$1compression | disabled | abilitato, disabilitato (Amazon DocumentDB 5.0)/zstd, lz4, nessuno (Amazon Document 2.0) DB8 | Sì | Dinamico | Stringa | Definisce l'impostazione di compressione predefinita per le nuove raccolte in un cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| profiler | disabled | abilitato, disabilitato | Sì | Dinamico | Stringa | Abilita il profiling per operazioni lente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| profiler\$1sampling\$1rate | 1.0 | 0,0 - 1,0 | Sì | Dinamico | Float | Definisce la frequenza di campionamento per le operazioni registrate. | 
| profiler\$1threshold\$1ms | 100 | 50-2147483646 | Sì | Dinamico | Numero intero | Definisce la soglia per profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| planner\$1version | 3.0 | 1,0, 2,0, 3,0 | Sì | Dinamico | Float | Definisce la versione del pianificatore di query da utilizzare per le query.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| tls | abilitato | abilitato, disabilitato, fips-140-3, tls1.2\$1, tls1.3\$1 | Sì | Statico | Stringa | Definisce se sono necessarie connessioni Transport Layer Security (TLS). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 
| ttl\$1monitor | abilitato | abilitato, disabilitato | Sì | Dinamico | Stringa | Definisce se il monitoraggio Time to Live (TTL) è abilitato per il cluster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | 

# Modifica dei parametri del cluster Amazon DocumentDB
<a name="cluster_parameter_groups-parameters"></a>

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
<a name="cluster_parameter_groups-describe_details_parameters"></a>

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

------
#### [ Using the Console di gestione AWS ]

**Per visualizzare i dettagli di un gruppo di parametri del cluster**

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

1. 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.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.

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

1. 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.  
![\[Screenshot: nomi e valori dei parametri.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)

------
#### [ 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`.

**Example**  
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
<a name="cluster_parameter_groups-modify_parameters"></a>

Puoi modificare i parametri di un gruppo di parametri utilizzando o. Console di gestione AWS AWS CLI

------
#### [ Using the Console di gestione AWS ]

**Per aggiornare i parametri di un gruppo di parametri del cluster**

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

1. 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.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.

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

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

1. 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](cluster_parameter_groups-list_of_parameters.md).

1. 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"
           }
       ]
   }
   ```

1. **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"
   }
   ```

1. **Attendi almeno 5 minuti.**

1. **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"
           }
       ]
   }
   ```

------