Todos os produtos
Search
Central de documentação

Tablestore:Batch delete data

Última atualização: Sep 17, 2026

No Tablestore, você pode excluir dados em lote usando chaves primárias. Também é possível configurar um tempo de vida (TTL) para remover automaticamente os dados expirados.

Importante

Não é possível recuperar dados excluídos. Execute esta operação com cautela.

Excluir dados diretamente com base nas chaves primárias

O Tablestore permite excluir dados em lote usando chaves primárias. Após consultar as chaves primárias dos dados que deseja remover, chame a operação BatchWriteRow para executar a exclusão. Siga as etapas abaixo:

  1. Escolha um método para obter as chaves primárias dos dados que deseja excluir.

    • Para excluir dados dentro de um intervalo específico de chave primária, chame a operação GetRange para consultar os dados e recuperar suas chaves primárias. Para mais informações, consulte Read data.

    • Para excluir dados que atendam a condições específicas, use o índice de pesquisa, caso a tabela possua um. Consulte os dados pelo índice de pesquisa para recuperar as chaves primárias correspondentes. Para mais informações, consulte Basic queries.

    • Para excluir todos os dados de uma tabela, exclua a tabela e crie uma nova com a mesma configuração.

      Como alternativa, chame a operação GetRange. Defina o intervalo de chave primária do ponto virtual INF_MIN (mínimo infinito) a INF_MAX (máximo infinito) para varrer toda a tabela e recuperar todas as chaves primárias. Esta operação consome recursos computacionais significativos. Use-a com cautela.

  2. Chame a operação BatchWriteRow para excluir os dados em lote usando as chaves primárias. Para mais informações, consulte Write data.

Configurar o TTL para excluir automaticamente dados expirados

O TTL é uma propriedade da tabela que define o período de retenção de dados. Quando os dados em uma coluna de atributo ultrapassam o TTL configurado, o sistema os exclui automática e assincronamente dessa coluna. Se os dados em todas as colunas de atributo de uma linha excederem o TTL, o sistema excluirá automática e assincronamente a linha inteira.

Siga as etapas abaixo:

  1. Chame a operação UpdateTable para alterar o TTL da tabela.

    Importante

    Se a tabela tiver um índice de pesquisa ou secundário, o valor de TTL do índice deve ser menor ou igual ao valor de TTL da tabela. Ao alterar o TTL da tabela, certifique-se de que o novo valor atenda a essa restrição.

  2. Dados que excedem o TTL são considerados expirados. O sistema exclui esses dados automática e assincronamente.

    Mesmo antes da exclusão efetiva, os dados ficam inacessíveis aos usuários.