Durata Time to live (TTL) per i record - Amazon SageMaker

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

Durata Time to live (TTL) per i record

Amazon SageMaker Feature Store offre la possibilità di eliminare definitivamente i record dal negozio online al raggiungimento di un determinato periodo di tempo, con time to live (TTL) duration (TtlDuration). Il record scadrà dopo che sarà stato raggiunto l'EventTime del record più la TtlDuration, ovvero ExpiresAt = EventTime + TtlDuration. La TtlDuration può essere applicata a livello di gruppo di funzionalità, dove tutti i record all'interno del gruppo di funzionalità avranno la TtlDuration per impostazione predefinita, oppure a livello di singolo record. Se non è specificata la TtlDuration, il valore predefinito è null e il record rimarrà nell'archivio online finché non verrà sovrascritto.

Un record eliminato utilizzando la TtlDuration viene eliminato definitivamente o rimosso completamente dall'archivio online e il record eliminato viene aggiunto all'archivio offline. Per ulteriori informazioni sulle modalità di eliminazione definitiva e cancellazione, consulta DeleteRecordla guida SageMaker API di riferimento di Amazon. Quando un record viene eliminato definitivamente, diventa immediatamente inaccessibile utilizzando Feature StoreAPIs.

Importante

TTLin genere elimina gli articoli scaduti entro pochi giorni. A seconda delle dimensioni e del livello di attività di una tabella, l'operazione di eliminazione effettiva di un item scaduto può variare. Poiché TTL è pensato per essere un processo in background, la natura della capacità utilizzata per far scadere ed eliminare gli elementi tramite TTL è variabile (ma gratuita). Per ulteriori informazioni su come vengono eliminati gli elementi da una tabella DynamoDB, vedi Come funziona: DynamoDB Time to Live (). TTL

TtlDurationdeve essere un dizionario contenente a Unit e aValue, dove Unit deve essere una stringa con valori «Secondi», «Minuti», «Ore», «Giorni» o «Settimane» e Value deve essere un numero intero maggiore o uguale a 1. TtlDurationpuò essere applicato utilizzando CreateFeatureGroupUpdateFeatureGroup, e PutRecordAPIs. Vedi la sintassi di richiesta e risposta nella documentazione CreateFeatureGroupdi Python (Boto3) SDK per, e. UpdateFeatureGroupPutRecordAPIs

  • Quando TtlDuration viene applicato a livello di gruppo di funzionalità (utilizzando CreateFeatureGroup o UpdateFeatureGroupAPIs), l'applicazione TtlDuration diventa l'impostazione predefinita TtlDuration per tutti i record che vengono aggiunti al gruppo di funzionalità dal momento in cui viene chiamato. API Quando si applica TtlDuration con UpdateFeatureGroupAPI, questo non diventerà l'impostazione predefinita TtlDuration per i record creati prima della API chiamata.

    Per rimuovere l'impostazione predefinita TtlDuration da un gruppo di funzionalità esistente, utilizzate UpdateFeatureGroup API e impostate TtlDuration Unit and Value tonull.

  • Quando TtlDuration viene applicato a livello di record (ad esempio, utilizzando PutRecordAPI), la TtlDuration durata si applica a quel record e viene utilizzata al posto del livello di feature group predefinitoTtlDuration.

  • Quando TtlDuration viene applicata a livello di gruppo di funzionalità, potrebbero essere necessari alcuni minuti prima che TtlDuration diventi effettiva.

  • Se TtlDuration viene utilizzata quando non esiste un archivio online, riceverai un errore Validation Exception (400).

Il codice di esempio seguente mostra come applicare TtlDuration durante l'aggiornamento di un feature group, in modo che i record aggiunti al feature group dopo l'esecuzione del API feature group scadano per impostazione predefinita quattro settimane dopo l'orario dell'evento.

import boto3

sagemaker_client = boto3.client("sagemaker")
feature_group_name = '<YOUR_FEATURE_GROUP_NAME>'

sagemaker_client.update_feature_group(
    FeatureGroupName=feature_group_name,
    OnlineStoreConfig={
        TtlDuration:{
            Unit: "Weeks",
            Value: 4
        }
    }
)

È possibile utilizzare il DescribeFeatureGroup API per visualizzare l'impostazione predefinitaTtlDuration.

Per visualizzare i tempi di scadenza, ExpiresAt (nel formato UTC orario ISO -8601), mentre si utilizza GetRecord o BatchGetRecord APIs è necessario impostare suExpirationTimeResponse. ENABLED Vedi la sintassi di richiesta e risposta nella documentazione DescribeFeatureGroupdi Python (Boto3) SDK per, e. GetRecordBatchGetRecordAPIs