Registra la scadenza per le tabelle - Amazon Simple Storage Service

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

Registra la scadenza per le tabelle

Per impostazione predefinita, i record nelle tabelle S3 non scadono. Per ridurre al minimo i costi di archiviazione per le tabelle, puoi abilitare e configurare la scadenza dei record per le tabelle. Con questa opzione, Amazon S3 rimuove automaticamente i record da una tabella quando i record scadono.

Se abiliti la scadenza dei record per una tabella, specifichi il numero di giorni in cui conservare i record nella tabella prima della scadenza dei record. Questo può essere un numero qualsiasi di giorni, compreso tra 1 e 2.147.483.647 giorni. Ad esempio, per conservare i record della tabella per un anno, specificare i giorni. 365 I record persistono quindi per 365 giorni. Dopo 365 giorni, i record scadono e Amazon S3 li rimuove automaticamente.

Puoi abilitare e configurare la scadenza dei record per le tabelle AWS gestite che memorizzano set di dati specifici da determinati Servizi AWS, attualmente Amazon S3 Storage Lens e Amazon SageMaker Catalog. Le opzioni di scadenza dei record non sono attualmente disponibili per altre tabelle AWS gestite. L'eccezione sono le tabelle del journal dei metadati di Amazon S3. Le tabelle del journal utilizzano impostazioni di scadenza dei record distinte specificate a livello di servizio. Per informazioni sulla configurazione della scadenza dei record per questo tipo di tabella, vedereScadenza dei record della tabella del diario. Tieni presente che le opzioni di scadenza dei record non sono disponibili per le tabelle S3 che crei.

Dopo aver abilitato la scadenza dei record per una tabella, puoi disabilitarla in qualsiasi momento. Amazon S3 interrompe quindi la scadenza e la rimozione dei record dalla tabella.

Come funziona la scadenza dei record

La scadenza dei record rimuove automaticamente i record da una tabella S3 quando i record sono più vecchi del numero di giorni specificato nelle impostazioni di scadenza dei record per la tabella. Per determinare quando scadono i record, Amazon S3 utilizza timestamp specifici nei record. La scelta della colonna timestamp deriva direttamente dallo schema della tabella per una tabella. Non è necessario specificare quale colonna di timestamp utilizzare. Le tabelle sono gestite da AWS e Amazon S3 sceglie automaticamente la colonna appropriata da utilizzare quando abiliti la scadenza dei record per una tabella.

Puoi abilitare e configurare le impostazioni di scadenza dei record per le tabelle AWS gestite che memorizzano parametri specifici di Amazon S3 Storage Lens o metadati specifici di Amazon SageMaker Catalog. Le opzioni di scadenza dei record sono disponibili per le seguenti tabelle AWS gestite per tali servizi:

  • S3 Storage Lens — bucket_property_metricsdefault_activity_metrics,, default_storage_metricsexpanded_prefixes_activity_metrics, eexpanded_prefixes_storage_metrics. Per determinare quando scadono i record in queste tabelle, Amazon S3 utilizza report_time il campo nei record.

  • SageMaker Catalogo Amazon —ASSET. Per determinare quando scadono i record in questa tabella, Amazon S3 utilizza snapshot_time il campo nei record.

Dopo aver abilitato la scadenza dei record per una tabella, Amazon S3 inizia a eseguire processi di scadenza dei record che eseguono le seguenti operazioni per la tabella:

  1. Identifica i record più vecchi dell'impostazione di scadenza specificata.

  2. Crea una nuova istantanea che escluda i riferimenti ai record scaduti.

La rimozione si basa anche sulla scadenza dell'istantanea e sulle impostazioni di rimozione dei file senza riferimenti nelle impostazioni di configurazione di manutenzione della tabella. Per ulteriori informazioni su queste impostazioni, consulta. Manutenzione delle tabelle

avvertimento

Amazon S3 scade e rimuove i record entro 24-48 ore dopo che i record diventano idonei alla scadenza. I record delle tabelle vengono rimossi dallo snapshot più recente. I dati e lo spazio di archiviazione dei record vengono rimossi tramite operazioni di manutenzione delle tabelle. I record delle tabelle non possono essere recuperati dopo la loro scadenza.

Configurazione della scadenza dei record per una tabella

Puoi abilitare, configurare e gestire in altro modo le impostazioni di scadenza dei record per una tabella S3 utilizzando la console Amazon S3, l'API REST di Amazon S3 AWS Command Line Interface ,AWS CLI() o. AWS SDKs

Prima di provare a eseguire queste attività per una tabella, assicurati di disporre delle seguenti autorizzazioni AWS Identity and Access Management (IAM):

  • s3tables:GetTableRecordExpirationConfiguration— Questa azione consente di accedere alle impostazioni correnti di scadenza dei record per le tabelle.

  • s3tables:PutTableRecordExpirationConfiguration— Questa azione consente di abilitare, configurare e disabilitare le impostazioni di scadenza dei record per le tabelle.

  • s3tables:GetTableRecordExpirationJobStatus— Questa azione consente di monitorare lo stato delle operazioni di scadenza dei record (lavori) per le tabelle e accedere alle metriche per le operazioni.

Le seguenti sezioni spiegano come abilitare, configurare e disabilitare le impostazioni di scadenza dei record per una tabella utilizzando la console Amazon S3 e il. AWS CLI Per eseguire queste attività con l'API REST di Amazon S3 o un AWS SDK, utilizza l'operazione. PutTableRecordExpirationConfiguration Per ulteriori informazioni, consulta la sezione Sviluppo con Amazon S3 nel riferimento alle API di Amazon Simple Storage Service.

Per abilitare e configurare le impostazioni di scadenza dei record per una tabella S3 utilizzando la console, segui questi passaggi.

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

  2. Nel pannello di navigazione a sinistra, scegli Bucket di tabelle.

  3. Nella pagina Table buckets, scegli il bucket che memorizza la tabella.

  4. Nella scheda Tabelle, scegli la tabella.

  5. Nella scheda Manutenzione, nella sezione Scadenza dei record, scegli Modifica.

  6. In Scadenza del record, scegli Abilita.

  7. Per Giorni dopo i quali i record scadono, inserisci il numero di giorni in cui conservare i record nella tabella. Può essere qualsiasi numero intero compreso tra 1 e 2.147.483.647. Ad esempio, per conservare i record per un anno, immettere. 365

    avvertimento

    Quando si determina il periodo di conservazione appropriato per i record nella tabella, si noti che i record non possono essere recuperati dopo la scadenza.

  8. Scegli Save changes (Salva modifiche).

Per modificare successivamente il periodo di conservazione, ripeti i passaggi precedenti.

Per disabilitare successivamente la scadenza dei record, ripetere i passaggi da 1 a 5. Quindi, per il passaggio 6, scegli Disabilita. Al termine, scegliere Save changes (Salva modifiche).

Per configurare e gestire le impostazioni di scadenza dei record per una tabella S3 utilizzando AWS CLI, esegui il put-table-record-expiration-configurationcomando.

Puoi iniziare creando un file JSON che contiene le impostazioni di scadenza dei record da applicare alla tabella. L'esempio seguente mostra il contenuto di un file JSON che consente la scadenza dei record per una tabella. Inoltre, specifica un periodo di conservazione di 30 giorni per i record della tabella. In altre parole, specifica che i record della tabella devono scadere dopo 30 giorni.

{ "status": "enabled", "settings": { "days": 30 { }

Per utilizzare l'esempio precedente, sostituiscili user input placeholders con le tue informazioni.

avvertimento

Quando si determina il periodo di conservazione appropriato per i record nella tabella, si noti che i record non possono essere recuperati dopo la scadenza.

Per disabilitare la scadenza dei record per una tabella, specificate disabled il status campo e omettete l'settingsoggetto dal file. Esempio:

{ "status": "disabled" }

Dopo aver creato un file JSON con le impostazioni da applicare, esegui il put-table-record-expiration-configuration comando. Per il table-arn parametro, specifica l'Amazon Resource Name (ARN) della tabella. Per il value parametro, specifica il nome del file che memorizza le impostazioni.

Ad esempio, il comando seguente aggiorna le impostazioni di scadenza dei record per una tabella. Le impostazioni sono specificate in un file denominatorecord-expiration-config.json.

aws s3tables put-table-record-expiration-configuration \ --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table \ --value file://./record-expiration-config.json

Per utilizzare l'esempio precedente, sostituiscili user input placeholders con le tue informazioni.

Monitoraggio della scadenza dei record per una tabella

Per monitorare lo stato e i risultati delle operazioni di scadenza dei record per le tabelle S3, usa l'GetTableRecordExpirationJobStatusoperazione o, se stai usando AWS CLI, esegui il get-table-record-expiration-job-statuscomando. Nella richiesta, specifica l'Amazon Resource Name (ARN) della tabella.

Ad esempio, il AWS CLI comando seguente recupera lo stato delle operazioni di scadenza dei record per una tabella specifica in un bucket di tabella. Per utilizzare questo esempio, sostituisci user input placeholders con le informazioni appropriate.

aws s3tables get-table-record-expiration-job-status \ --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table

Se la richiesta ha esito positivo, riceverai una risposta che fornisce dettagli come l'ultima data in cui Amazon S3 ha eseguito le operazioni di scadenza dei record per la tabella e lo stato di tale esecuzione. Se l'esecuzione più recente ha avuto esito positivo, la risposta include anche i parametri di elaborazione, ad esempio il numero di file e record di dati che sono stati rimossi e la dimensione totale dei dati rimossi. Se si sono verificati errori durante l'esecuzione più recente, la risposta include un messaggio di errore che descrive il motivo per cui l'esecuzione non è riuscita.

Considerazioni

Quando configuri e gestisci le impostazioni di scadenza dei record per le tabelle S3 AWS gestite, tieni presente quanto segue:

  • La scadenza dei record è disponibile solo per alcune tabelle AWS gestite create dai supporti Servizi AWS, Amazon S3 Storage Lens e Amazon SageMaker Catalog. Inoltre, la scadenza dei record è disponibile solo per le singole tabelle, non per interi gruppi di tabelle.

  • Per determinare quando scadono i record, Amazon S3 utilizza timestamp specifici nelle tabelle. Questi timestamp indicano quando i dati sono stati creati, non quando Amazon S3 ha inserito i record in una tabella. La colonna timestamp utilizzata dipende dal servizio che pubblica la tabella: per i parametri di S3 Storage Lens, il report_time campo e, per i metadati di Amazon SageMaker Catalog, il campo. snapshot_time Non puoi specificare quale campo utilizzare perché le tabelle sono gestite da. AWS

  • Se si verificano ritardi nell'esportazione dei dati in una tabella, i record potrebbero diventare idonei alla scadenza prima del previsto. Per questo motivo, ti consigliamo di tenere conto dei potenziali ritardi di inserimento aggiungendo un buffer al periodo di conservazione nelle impostazioni di scadenza delle tabelle.

  • I record scadono e vengono rimossi entro 24-48 ore dal momento in cui diventano idonei alla scadenza. Amazon S3 non ha una scadenza e rimuove i record immediatamente dopo che sono diventati idonei alla scadenza.

  • I record non possono essere recuperati dopo la loro scadenza e dopo essere stati rimossi.