Todos os produtos
Search
Central de documentação

Tablestore:Operações básicas de dados

Última atualização: Jul 03, 2026

O Tablestore permite gravar, ler e excluir dados pelo console do Tablestore, SDKs e CLI. Este tópico descreve os métodos disponíveis e seus cenários de aplicação.

Gravar dados

Grave dados em tabelas inserindo uma única linha, atualizando uma única linha ou gravando várias linhas simultaneamente. Especifique um número de versão de dados personalizado e use atualizações condicionais para definir condições de gravação. Para mais informações, consulte Gravar dados.

Método

Descrição

Cenário

Inserir uma única linha de dados

Grava uma única linha de dados. Se a linha já existir, o Tablestore exclui todas as versões de dados em todas as colunas da linha existente e grava os novos dados.

Adequado para gravar um pequeno volume de dados.

Atualizar uma única linha de dados

Adiciona ou remove uma coluna de atributo em uma linha, exclui uma versão específica de dados de uma coluna de atributo ou atualiza o valor de uma coluna de atributo existente.

Se a linha não existir, o sistema adiciona uma nova linha.

Recomendado para atualizar um pequeno volume de dados.

Gravar várias linhas de dados simultaneamente

Grava várias linhas de dados em uma ou mais tabelas ao mesmo tempo.

Ideal para gravar, excluir ou atualizar um grande volume de dados, ou para executar uma combinação dessas operações de uma só vez.

Ler dados

Leia dados de tabelas lendo uma única linha, várias linhas simultaneamente ou linhas cujos valores de chave primária estejam dentro de um intervalo específico. Especifique colunas a serem retornadas, aplique filtros e defina um intervalo de versões ou uma versão específica dos dados para retorno. Para mais informações, consulte Ler dados.

Método

Descrição

Cenário

Ler uma única linha de dados

Lê uma única linha de dados.

Indicado quando todos os valores das colunas de chave primária da linha alvo são conhecidos e apenas um pequeno número de linhas precisa ser lido.

Ler várias linhas de dados simultaneamente

Lê várias linhas de dados de uma ou mais tabelas ao mesmo tempo.

Útil quando todos os valores das colunas de chave primária das linhas alvo são conhecidos e o número de linhas é grande, ou para ler dados de várias tabelas.

Ler dados cujos valores de chave primária estão dentro de um intervalo específico

Lê dados cujos valores de chave primária se enquadram em um intervalo determinado.

Aplicável quando o intervalo ou prefixo dos valores de chave primária das linhas alvo pode ser definido.

Excluir dados

Exclua dados de tabelas excluindo uma única linha ou várias linhas simultaneamente. Use atualizações condicionais para estabelecer condições de exclusão. Para mais informações, consulte Excluir dados.

Método

Descrição

Cenário

Excluir uma única linha de dados

Exclui uma única linha de dados. Se a linha especificada não existir, a tabela de dados permanece inalterada.

Apropriado para excluir um pequeno volume de dados.

Excluir várias linhas de dados simultaneamente

Exclui várias linhas ao mesmo tempo com base nas informações da chave primária.

Projetado para cenários de exclusão de grande volume de dados.

Referências

  • Configure condições para gravar ou excluir dados. Para mais informações, consulte Atualizações condicionais.

  • Execute operações atômicas para ler ou gravar uma ou mais linhas de dados. Para mais informações, consulte Transações locais.

  • Colete estatísticas em tempo real para aplicações online, como contagens de visualizações de página (PV) em publicações. Para mais informações, consulte Usar o recurso de contador atômico.

  • Filtre dados que atendem a condições específicas durante operações de leitura. Para mais informações, consulte Filtros.

  • Exclua automaticamente dados cujo período de retenção excede o valor de tempo de vida (TTL) especificado. Para mais informações, consulte Versões de dados e TTL.