Manutenção para buckets de tabela - Amazon Simple Storage Service
Remoção de arquivos sem referênciaConsiderações e limitações

Manutenção para buckets de tabela

O Amazon S3 oferece operações de manutenção para aprimorar o gerenciamento e a performance dos buckets de tabela. A opção a seguir é habilitada por padrão para todos os buckets de tabela. Você pode editar ou desabilitar essa opção especificando um arquivo de configuração de manutenção para o bucket de tabela.

A edição dessa configuração requer a permissão s3tables:PutTableBucketMaintenanceConfiguration.

Remoção de arquivos sem referência

A remoção de arquivos sem referência identifica e exclui todos os objetos que não são referidos por nenhum snapshot de tabela. Como parte da política de remoção de arquivos sem referência, você pode configurar duas propriedades: unreferencedDays (três dias por padrão) e nonCurrentDays (dez dias por padrão).

Para qualquer objeto não referenciado pela tabela e mais antigo que a propriedade unreferencedDays, o S3 marca o objeto como desatualizado. O S3 exclui objetos desatualizados após o número de dias especificado pela propriedade nonCurrentDays.

nota

As exclusões de objetos desatualizados são permanentes, sem nenhuma maneira de recuperá-los.

Para visualizar ou recuperar objetos que foram marcados como desatualizados, você deve entrar em contato com o AWS Support. Para obter informações sobre como entrar em contato com o AWS Support, consulte Entrar em contato com a AWS ou a Documentação do AWS Support.

A remoção de arquivos não referenciados determina os objetos a serem excluídos de uma tabela somente com referência a essa tabela. Qualquer referência feita a esses objetos fora da tabela não impedirá que a remoção de arquivos não referenciados exclua um objeto.

Se você desativar a remoção de arquivos não referenciados, nenhum trabalho em andamento será afetado. A nova configuração entrará em vigor no próximo trabalho após a alteração da configuração. Para ter mais informações, consulte as informações sobre preços na Definição de preço do Amazon S3.

Você só pode configurar a remoção de arquivos não referenciados ao nível do bucket de tabela. Essa configuração se aplicará a todas as tabelas do bucket.

Como configurar a remoção de arquivos não referenciados usando a AWS CLI

O exemplo a seguir definirá unreferencedDays como 4 dias e nonCurrentDays como 10 dias usando a API PutTableBucketMaintenanceConfiguration.

aws s3tables put-table-bucket-maintenance-configuration \
   --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
   --type icebergUnreferencedFileRemoval \
   --value '{"status":"enabled","settings":{"icebergUnreferencedFileRemoval":{"unreferencedDays":4,"nonCurrentDays":10}}}'

Para obter mais informações, consulte put-table-bucket-maintenance-configuration na Referência de comandos da AWS CLI.

Considerações e limitações

Para saber mais sobre considerações adicionais e limites para remoção de arquivos não referenciados, consulte Considerações e limitações para trabalhos de manutenção.