Todos os produtos
Search
Central de documentação

Tablestore:RangeQuery

Última atualização: Jul 03, 2026

O RangeQuery define as configurações de uma consulta de intervalo. Use esse recurso para consultar dados dentro de um intervalo especificado. Se o tipo do campo for TEXT, o Tablestore tokeniza a string e corresponde a qualquer token dentro do intervalo definido.

Estrutura de dados

message RangeQuery {
    optional string field_name = 1;
    optional bytes range_from = 2; // variant value
    optional bytes range_to = 3; // variant value
    optional bool include_lower = 4;
    optional bool include_upper = 5;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Nome da coluna de atributo.

range_from

bytes

Sim

Valor inicial da consulta. Codifique esse valor com PlainBuffer. Para mais informações, consulte PlainBuffer.

Ao definir condições de intervalo, use greaterThan para representar o sinal de maior que (>) e greaterThanOrEqual para indicar maior ou igual a (≥).

range_to

bytes

Sim

Valor final da consulta. Codifique esse valor com PlainBuffer. Para mais informações, consulte PlainBuffer.

Ao definir condições de intervalo, use lessThan para representar o sinal de menor que (<) e lessThanOrEqual para indicar menor ou igual a (≤).

include_lower

bool

Não

Especifique se range_from deve ser incluído nos resultados.

include_upper

bool

Não

Especifique se range_to deve ser incluído nos resultados.