Todos os produtos
Search
Central de documentação

Tablestore:SingleColumnValueFilter

Última atualização: Sep 09, 2026

Condição de filtro única, como column_a > 5. Usada para atualizações condicionais e filtragem.

Estrutura de dados

message SingleColumnValueFilter {
    required ComparatorType comparator = 1;
    required string column_name = 2;
    required bytes column_value = 3;
    required bool filter_if_missing = 4;
    required bool latest_version_only = 5; 
    optional ValueTransferRule value_transfer_rule =6;
     
}                

Nome

Tipo

Obrigatório

Descrição

comparator

ComparatorType

Sim

Operador relacional.

column_name

string

Sim

Nome da coluna.

column_value

bytes

Sim

Valor da coluna serializado no formato Plainbuffer.

filter_if_missing

bool

Sim

Define se a linha será filtrada caso a coluna não exista.

latest_version_only

bool

Sim

Indica se o filtro se aplica apenas à versão mais recente da coluna. Valores válidos:

  • true (padrão): O filtro verifica somente o valor da versão mais recente para validar a condição.

  • false: O filtro avalia os valores de todas as versões para verificar se atendem à condição.

value_transfer_rule

ValueTransferRule

Não

Usa uma expressão regular para corresponder a uma string e convertê-la para o tipo String, Integer ou Double.

Defina este parâmetro para filtrar dados de uma coluna pelo valor de um subcampo quando a coluna armazena dados em formato personalizado, como uma string formatada em JSON.

Operações relacionadas