

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

# Ottimizzatore per la conservazione degli snapshot
<a name="update-snapshot-retention"></a>

 È possibile aggiornare la configurazione esistente di un ottimizzatore di conservazione delle istantanee per una particolare tabella Apache Iceberg utilizzando la AWS Glue console o l' AWS CLI API. UpdateTableOptimizer 

------
#### [ Console ]

**Per aggiornare la configurazione di conservazione degli snapshot**

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

1. Scegliere **Catalogo dati** e poi **Tabelle**. Dall'elenco delle tabelle, selezionare la tabella Iceberg in cui aggiornare la configurazione dell'ottimizzatore per la conservazione degli snapshot.

1. Nella parte inferiore della pagina **Dettagli tabella**, selezionare la scheda **Ottimizzazione tabella**, poi scegliere **Modifica**. È anche possibile scegliere **Modifica** in **Ottimizzazione** dal menu **Operazioni** situato nell'angolo in alto a destra della pagina.

1.  Nella pagina **Modifica ottimizzazione**, apportare le modifiche desiderate. 

1.  Scegli **Save** (Salva). 

------
#### [ AWS CLI ]

 Per aggiornare un ottimizzatore di conservazione delle istantanee utilizzando AWS CLI, è possibile utilizzare il seguente comando: 

```
aws glue update-table-optimizer \
 --catalog-id {{123456789012}} \
 --database-name {{iceberg_db}} \
 --table-name {{iceberg_table}} \
 --table-optimizer-configuration '{"roleArn":"arn:aws:iam::{{123456789012}}:role/{{optimizer_role}}"","enabled":'true', "vpcConfiguration":{"glueConnectionName":{{"glue_connection_name"}}},"retentionConfiguration":{"icebergConfiguration":{"snapshotRetentionPeriodInDays":{{7}},"numberOfSnapshotsToRetain":{{3}},"cleanExpiredFiles":{{'true'}}}}}' \
 --type retention
```

 Questo comando aggiorna la configurazione della conservazione per la tabella specificata nel dato catalogo, nel database e nella regione. I parametri chiave sono: 
+  snapshotRetentionPeriodInDays —Il numero di giorni in cui conservare le istantanee prima della scadenza. Il valore predefinito è `1`. 
+ numberOfSnapshotsToRetain — Il numero minimo di istantanee da conservare, anche se sono più vecchie del periodo di conservazione. Il valore predefinito è `5`. 
+ cleanExpiredFiles — Un valore booleano che indica se eliminare i file di dati scaduti dopo la scadenza delle istantanee. Il valore predefinito è `true`. 

   Se impostato su true, gli snapshot più vecchi vengono rimossi dai metadati della tabella e i relativi file sottostanti vengono eliminati. Se questo parametro è impostato su false, gli snapshot più vecchi vengono rimossi dai metadati della tabella ma i relativi file sottostanti rimangono nell'archivio come file orfani. 

------
#### [ API ]

Per aggiornare un ottimizzatore di tabelle, si può utilizzare l'API `UpdateTableOptimizer`. Questa API consente di aggiornare la configurazione di un ottimizzatore di tabelle esistente per la compattazione, la conservazione o la rimozione di file orfani. I parametri della richiesta includono:
+ catalogId (obbligatorio): l'ID del catalogo contenente la tabella 
+  databaseName (opzionale): il nome del database contenente la tabella 
+  tableName (opzionale): il nome della tabella 
+  type (obbligatorio): il tipo di ottimizzatore della tabella (compattazione, conservazione o orphan\_file\_delete) 
+  retentionConfiguration (obbligatorio): la configurazione aggiornata per l'ottimizzatore delle tabelle, che include l'ARN del ruolo, lo stato di abilitazione, la configurazione di conservazione e la configurazione per la rimozione dei file orfani. 

------