Todos os produtos
Search
Central de documentação

Tablestore:Atualizações condicionais

Última atualização: Sep 22, 2026

O Tablestore oferece suporte a atualizações condicionais, que permitem atualize dados em uma linha de destino somente quando ela atende a uma condição especificada.

Visão geral do recurso

As atualizações condicionais permitem implementar mecanismos semelhantes à cláusula WHERE do SQL ou ao bloqueio otimista. No Tablestore, as atualizações condicionais podem se basear na existência da linha ou nos valores das colunas.

Condição de existência da linha

Essa condição verifica se uma linha de destino existe na tabela de dados. As três condições a seguir são aceitas:

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

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

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

Condição de valor de coluna

Essa condição verifica se o valor de uma coluna de atributo na linha de destino atende a uma condição especificada. Os dois tipos de condição a seguir são aceitos.

Tipo

Operações aceitas

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 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 de 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

  • Verifica 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.

  • É possível combinar 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 os valores de colunas, o sistema lê os dados da linha de destino. Essa operação gera custos de leitura de dados, calculados da mesma forma que as leituras padrão. Para mais informações, consulte Billing overview.