Todos os produtos
Search
Central de documentação

Tablestore:Atualizações condicionais

Última atualização: Jul 03, 2026

O Tablestore oferece suporte a atualizações condicionais, que permitem atualizar dados em uma linha de destino apenas se ela atender a uma condição especificada.

Visão geral do recurso

As atualizações condicionais possibilitam implementar mecanismos semelhantes à cláusula WHERE do SQL ou a bloqueios otimistas. No Tablestore, essas atualizações podem basear-se na existência da linha ou nos valores das colunas.

Condição de existência de linha

Essa condição verifica se uma linha de destino existe na tabela de dados. Há suporte para as três condições a seguir:

  • Ignorar: o sistema não verifica a existência da linha.

  • Esperar existência: a condição é atendida se a linha de destino existir na tabela de dados.

  • Esperar inexistência: a condição é atendida se a linha de destino não existir na tabela de dados.

Condição de valor de coluna

Esta verificação avalia se o valor de uma coluna de atributo na linha de destino atende a um critério definido. Dois tipos de condições têm suporte.

Tipo

Operações com suporte

Descrição

Condição de valor único

Operações relacionais: igual a, diferente de, maior que, maior ou igual a, menor que e menor ou igual a

  • Verifica se o valor de uma única coluna de atributo atende à condição.

  • Especifique se a condição deve ser considerada atendida quando a coluna de atributo de destino não existir na linha. Por padrão, a condição é considerada atendida.

  • Defina a versão dos dados da coluna de atributo para a verificação. É possível verificar apenas a versão mais recente ou todas as versões. Por padrão, somente a versão mais recente é verificada.

Condição composta

Operações lógicas: NOT, AND e OR

  • Avalia se os dados da linha atendem à condição composta.

  • As subcondições de uma condição composta podem ser uma condição de valor único ou outra condição composta.

  • Há suporte para uma combinação de até 32 condições.

Uso

As atualizações condicionais só podem ser executadas por meio de um SDK ou da interface de linha de comando (CLI).

Faturamento

Ao usar atualizações condicionais para verificar a existência de linhas e valores de colunas, o sistema lê os dados da linha de destino. Essa operação gera taxas de leitura de dados, calculadas da mesma forma que as leituras de dados padrão. Para obter mais informações, consulte Visão geral do faturamento.