Uma consulta de termo com o Tablestore SDK for Java identifica valores de campo ou tokens exatamente iguais ao termo pesquisado e retorna as linhas correspondentes ou a contagem total.
Pré-requisitos
Instale o Tablestore SDK for Java e inicialize o cliente.
Descrição do recurso
A consulta de termo identifica conteúdo em um campo especificado que seja exatamente igual ao termo pesquisado. Em campos não textuais, como Keyword e Long, todo o valor do campo deve ser idêntico ao termo da consulta. Já em um campo Text (consulte String types), a linha corresponde se qualquer token gerado pelo analisador for exatamente igual ao termo pesquisado. O próprio termo da consulta não passa por tokenização.
Os tokens gerados para um campo Text podem variar conforme a configuração do analisador, atualizações de algoritmo e mudanças no uso do idioma. Evite usar uma consulta de termo para corresponder à string original completa de um campo Text. Em vez disso, utilize uma virtual column para mapear o campo source para o tipo Keyword e consulte a coluna virtual.
Para chamar search, defina o tipo de consulta como TermQuery e use SearchQuery para configurar o número de linhas retornadas, o rastreamento da contagem total e outros comportamentos comuns de consulta.
SearchResponse search(SearchRequest request)O exemplo a seguir consulta linhas cujo valor do campo category seja exatamente igual a books, retornando até 10 linhas e o número total de linhas correspondentes.
String tableName = "example_table";
String indexName = "example_index";
TermQuery termQuery = new TermQuery();
termQuery.setFieldName("category");
termQuery.setTerm(ColumnValue.fromString("books"));
SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(termQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);
SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);
SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());Parâmetros
Solicitação de busca
request é um objeto SearchRequest que contém os seguintes parâmetros.
|
Nome |
Tipo |
Descrição |
|
tableName (obrigatório) |
String |
Nome da tabela. |
|
indexName (obrigatório) |
String |
Nome do índice de busca. |
|
searchQuery (obrigatório) |
SearchQuery |
Condição de consulta e configurações gerais. |
|
columnsToGet (opcional) |
SearchRequest.ColumnsToGet |
Configurações das colunas retornadas. Se este parâmetro for omitido, apenas as colunas de chave primária serão retornadas. |
|
timeoutInMillisecond (opcional) |
int |
Tempo limite da consulta no nível da solicitação, em milissegundos. O valor padrão é |
|
routingValues (opcional) |
|
Valores de chave primária para campos de roteamento personalizado. Omita este parâmetro se o índice não utilizar roteamento personalizado. |
Configurações de consulta
request.searchQuery é um objeto SearchQuery que contém os seguintes parâmetros.
|
Nome |
Tipo |
Descrição |
|
query (obrigatório) |
Query |
Condição da consulta. Defina este parâmetro como |
|
offset (opcional) |
Integer |
Posição inicial da consulta. |
|
limit (opcional) |
Integer |
Número máximo de linhas a serem retornadas. Defina este parâmetro como |
|
highlight (opcional) |
Highlight |
Configurações de resumo e destaque para campos Text. Para detalhes de configuração, consulte Summary and highlighting. |
|
collapse (opcional) |
Collapse |
Configurações de agrupamento de campo, que deduplicam resultados com base em um campo especificado. Para detalhes de configuração, consulte Collapse query results. |
|
sort (opcional) |
Sort |
Ordem de classificação dos resultados. Para detalhes de configuração, consulte Sort and paginate results. |
|
trackTotalCount (opcional) |
int |
Contagem máxima esperada de linhas correspondentes. O valor padrão é |
|
filter (opcional) |
SearchFilter |
Filtro aplicado aos resultados de |
|
aggregationList (opcional) |
|
Configurações de agregação. Para detalhes de configuração, consulte Aggregation. |
|
groupByList (opcional) |
|
Configurações de agrupamento. Para detalhes de configuração, consulte Aggregation. |
|
token (opcional) |
byte[] |
Token de paginação. Defina este parâmetro com o valor |
Condição de consulta
request.searchQuery.query é um objeto TermQuery que contém os seguintes parâmetros.
|
Nome |
Tipo |
Descrição |
|
fieldName (obrigatório) |
String |
Nome do campo indexado a ser consultado. |
|
term (obrigatório) |
ColumnValue |
Termo da consulta. Para um campo Text, o valor inteiro é usado como um único termo e não sofre tokenização. |
|
weight (opcional) |
float |
Peso de relevância da condição de consulta. O valor deve ser um número de ponto flutuante positivo. Quanto maior o valor, maior a contribuição dessa condição para a pontuação de relevância BM25. Este parâmetro não afeta a correspondência nem o número de linhas retornadas, influenciando a ordem dos resultados apenas quando |
Colunas retornadas
request.columnsToGet é um objeto SearchRequest.ColumnsToGet que contém os seguintes parâmetros.
|
Nome |
Tipo |
Descrição |
|
columns (opcional) |
|
Colunas de atributo a serem retornadas. Defina este parâmetro somente se |
|
returnAll (opcional) |
boolean |
Especifica se todas as colunas de atributo da tabela devem ser retornadas. Valor padrão: |
|
returnAllFromIndex (opcional) |
boolean |
Especifica se todas as colunas de atributo indexadas devem ser retornadas. Valor padrão: |
Valores de retorno
search retorna um objeto SearchResponse. A tabela a seguir descreve os campos principais.
|
Nome |
Tipo |
Descrição |
|
totalCount |
long |
Quantidade de linhas correspondentes. Chame |
|
rows |
|
Linhas retornadas por esta consulta. Chame |
|
searchHits |
|
Resultados da consulta. Chame |
|
nextToken |
byte[] |
Token da próxima página. Chame |
|
isAllSuccess |
boolean |
Indica se todas as partições do índice foram consultadas com sucesso. Chame |