Todos os produtos
Search
Central de documentação

Tablestore:TermQuery

Última atualização: Jul 03, 2026

O TermQuery define as configurações de uma consulta de termo. Esse recurso permite consultar dados que correspondem exatamente ao valor especificado de um campo. A consulta de termo é semelhante a consultas baseadas em condições de correspondência de string. Se o campo usado para corresponder ao prefixo for do tipo TEXT, os valores do campo serão tokenizados. Uma linha atenderá às condições da consulta quando pelo menos um token contiver o prefixo especificado.

Estrutura de dados

message TermQuery {
    optional string field_name = 1;
    optional bytes term = 2;
    optional float weight = 3;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Nome da coluna de atributo.

term

bytes

Sim

Palavra-chave usada para corresponder aos valores do campo durante a execução de uma consulta de termo. O valor deve ser codificado com PlainBuffer. Para mais informações, consulte PlainBuffer.

Essa palavra não é tokenizada, sendo tratada como um termo inteiro.

Caso o campo utilizado para corresponder ao prefixo seja do tipo TEXT, seus valores passarão por tokenização. A linha satisfaz as condições da consulta se pelo menos um dos tokens resultantes contiver o prefixo definido. Por exemplo, se o valor de uma coluna do tipo TEXT em determinada linha for tablestore is cool, ele poderá ser dividido nos tokens tablestore, is e cool. Assim, a linha será considerada válida na consulta caso você especifique tablestore, is ou cool como palavra-chave de busca.

weight

float

Não

Configurações de peso da condição de consulta.