Expiration des enregistrements pour les tables

Par défaut, les enregistrements de vos tables S3 n'expirent pas. Pour minimiser les coûts de stockage de vos tables, vous pouvez activer et configurer l'expiration des enregistrements pour les tables. Avec cette option, Amazon S3 supprime automatiquement les enregistrements d'une table lorsqu'ils expirent.

Si vous activez l'expiration des enregistrements pour une table, vous spécifiez le nombre de jours pendant lesquels les enregistrements doivent être conservés dans la table avant leur expiration. Cela peut prendre n'importe quel nombre de jours allant de 1 jour à 2 147 483 647 jours. Par exemple, pour conserver les enregistrements d'une table pendant un an, spécifiez les 365 jours. Les enregistrements sont ensuite conservés pendant 365 jours. Au bout de 365 jours, les enregistrements expirent et Amazon S3 les supprime automatiquement.

Vous pouvez activer et configurer l'expiration des enregistrements pour les tables AWS gérées qui stockent des ensembles de données spécifiques provenant de certains Services AWS, actuellement Amazon S3 Storage Lens et Amazon SageMaker Catalog. Les options d'expiration des enregistrements ne sont actuellement pas disponibles pour les autres tables AWS gérées. L'exception concerne les tables de journal des métadonnées Amazon S3. Les tables de journal utilisent des paramètres d'expiration d'enregistrement distincts que vous spécifiez au niveau du service. Pour plus d'informations sur la configuration de l'expiration des enregistrements pour ce type de table, consultezExpiration des enregistrements d’une table de journal. Notez que les options d'expiration des enregistrements ne sont pas disponibles pour les tables S3 que vous créez.

Après avoir activé l'expiration des enregistrements pour une table, vous pouvez la désactiver à tout moment. Amazon S3 arrête alors d'expirer et de supprimer les enregistrements de la table.

Comment fonctionne l'expiration des enregistrements

L'expiration des enregistrements supprime automatiquement les enregistrements d'une table S3 lorsque les enregistrements sont antérieurs au nombre de jours que vous spécifiez dans les paramètres d'expiration des enregistrements de la table. Pour déterminer la date d'expiration des enregistrements, Amazon S3 utilise des horodatages spécifiques dans les enregistrements. Le choix de la colonne d'horodatage découle directement du schéma de table d'une table. Il n'est pas nécessaire de spécifier la colonne d'horodatage à utiliser. Les tables sont gérées par Amazon S3 AWS et choisit automatiquement la colonne appropriée à utiliser lorsque vous activez l'expiration des enregistrements pour une table.

Vous pouvez activer et configurer les paramètres d'expiration des enregistrements pour les tables AWS gérées qui stockent des métriques Amazon S3 Storage Lens spécifiques ou des métadonnées spécifiques du SageMaker catalogue Amazon. Les options d'expiration des enregistrements sont disponibles pour les tables AWS gérées suivantes pour ces services :

Une fois que vous avez activé l'expiration des enregistrements pour une table, Amazon S3 commence à exécuter des tâches d'expiration d'enregistrement qui effectuent les opérations suivantes pour la table :

La suppression est également basée sur les paramètres d'expiration des instantanés et de suppression de fichiers non référencés dans les paramètres de configuration de maintenance de la table. Pour en savoir plus sur ces paramètres, consultezMaintenance des tables.

Configuration de l'expiration des enregistrements pour une table

Vous pouvez activer, configurer et gérer les paramètres d'expiration des enregistrements pour une table S3 à l'aide de la console Amazon S3, de l'API REST Amazon S3, AWS Command Line Interface (AWS CLI) ou AWS SDKs.

Avant d'essayer d'effectuer ces tâches pour une table, assurez-vous que vous disposez des autorisations Gestion des identités et des accès AWS (IAM) suivantes :

Les sections suivantes expliquent comment activer, configurer et désactiver les paramètres d'expiration des enregistrements pour une table à l'aide de la console Amazon S3 et du AWS CLI. Pour effectuer ces tâches avec l'API REST d'Amazon S3 ou un AWS SDK, utilisez l'PutTableRecordExpirationConfigurationopération. Pour plus d'informations, consultez la section Développement avec Amazon S3 dans le manuel Amazon Simple Storage Service API Reference.

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

{
    "status": "disabled"
}

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

Surveillance de l'expiration des enregistrements pour une table

Pour surveiller l'état et les résultats des opérations d'expiration des enregistrements pour vos tables S3, utilisez l'GetTableRecordExpirationJobStatusopération ou, si vous utilisez le AWS CLI, exécutez la get-table-record-expiration-job-statuscommande. Dans votre demande, spécifiez le Amazon Resource Name (ARN) de la table.

Par exemple, la AWS CLI commande suivante permet de récupérer l'état des opérations d'expiration des enregistrements pour une table spécifique dans un bucket de tables. Pour utiliser cet exemple, remplacez les user input placeholders par vos propres informations.

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

Si votre demande aboutit, vous recevez une réponse qui fournit des informations détaillées, telles que la date à laquelle Amazon S3 a effectué les dernières opérations d'expiration des enregistrements pour la table et le statut de cette exécution. Si l'exécution la plus récente a réussi, la réponse inclut également des mesures de traitement, par exemple le nombre de fichiers de données et d'enregistrements supprimés, et la taille totale des données supprimées. Si des erreurs se sont produites lors de la dernière exécution, la réponse inclut un message d'échec décrivant pourquoi l'exécution a échoué.

Considérations

Lorsque vous configurez et gérez les paramètres d'expiration des enregistrements pour vos tables S3 AWS gérées, gardez à l'esprit les points suivants :