Todos os produtos
Search
Central de documentação

Tablestore:SingleColumnValueFilter

Última atualização: Jul 03, 2026

Define uma única condição de filtro, como column_a>5. O SingleColumnValueFilter é usado nos recursos de atualização condicional e filtro.

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;
     
}                

Parâmetro

Tipo

Obrigatório

Descrição

comparator

ComparatorType

Sim

Operador relacional.

column_name

string

Sim

Nome da coluna.

column_value

bytes

Sim

Valor da coluna após codificação PlainBuffer.

filter_if_missing

bool

Sim

Indica se a condição de filtro se aplica quando a coluna especificada não existe na linha. Valores válidos:

  • true: mantém a linha. Este é o valor padrão.

  • false: filtra a linha.

Por exemplo, se a condição de filtro for column_a>0 e filter_if_missing estiver definido como true, a linha será mantida caso column_a não exista nela.

latest_version_only

bool

Sim

Determina se a condição de filtro se aplica apenas à versão mais recente. Valores válidos:

  • true: retorna a linha somente se a versão mais recente do valor da coluna atender à condição. Este é o valor padrão.

  • false: retorna a linha se qualquer versão do valor da coluna atender à condição.

value_transfer_rule

ValueTransferRule

Não

Converte uma string para o tipo String, Integer ou Double após correspondência por expressão regular.

Configure este parâmetro se armazenar dados da coluna em formato personalizado, como string JSON, e precisar filtrar e consultar esses dados pelo valor de um subcampo.

Referências