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 | 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:
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:
|
value_transfer_rule | 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
Use o recurso de atualização condicional ao chamar as operações PutRow, UpdateRow, DeleteRow ou BatchWriteRow.
Use o recurso de filtro ao chamar as operações GetRow, GetRange ou BatchGetRow.