Match all query - Tablestore SDK for Java - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize o cliente.

Descrição do recurso

A consulta match all corresponde a todos os dados em um search index sem especificar campo ou valor para filtragem. Ao chamar search, defina o tipo de consulta como MatchAllQuery 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 corresponde a todas as linhas de um search index e retorna até 10 linhas, além do número total de linhas correspondentes.

String tableName = "example_table";
String indexName = "example_index";

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(new MatchAllQuery());
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());

Nota

O MatchAllQuery atribui a mesma pontuação de relevância a todas as linhas correspondentes. Sem uma ordem de classificação explícita, a ordem das linhas não é garantida. Para recuperar apenas a contagem total, defina limit como 0. Nesse caso, o servidor não retorna nenhuma linha. O rastreamento de contagens totais aumenta a sobrecarga da consulta.

Parâmetros

Solicitação de pesquisa

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 search index.
searchQuery (obrigatório)	SearchQuery	Condição de consulta e configurações gerais de consulta.
columnsToGet (opcional)	SearchRequest.ColumnsToGet	Configurações das colunas retornadas. Se 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 é `-1`, que não define um tempo limite separado para a consulta.
routingValues (opcional)	`List<PrimaryKey>`	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 de consulta. Defina este parâmetro como `MatchAllQuery` para uma consulta match all.
offset (opcional)	Integer	Posição inicial da consulta.
limit (opcional)	Integer	Número máximo de linhas a retornar. Defina este parâmetro como `0` para não retornar nenhuma linha.
collapse (opcional)	Collapse	Configurações de agrupamento de campos, que deduplicam os resultados por 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	Número máximo esperado de linhas correspondentes a contar. O valor padrão é `TRACK_TOTAL_COUNT_DISABLED`, que desativa a contagem. Defina este parâmetro como `TRACK_TOTAL_COUNT` para contar todas as linhas correspondentes. Um valor menor melhora o desempenho da consulta.
filter (opcional)	SearchFilter	Filtro aplicado aos resultados de `query`.
aggregationList (opcional)	`List<Aggregation>`	Configurações de agregação. Para detalhes de configuração, consulte Aggregation.
groupByList (opcional)	`List<GroupBy>`	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 `nextToken` da resposta anterior para continuar a leitura das linhas. Ao definir `token`, o SDK limpa `sort`, pois o token já contém as condições de classificação.

Condição de consulta

request.searchQuery.query é um objeto MatchAllQuery e não possui parâmetros adicionais. Este tipo de consulta não oferece suporte a resumo e destaque. Para tipos de consulta compatíveis e detalhes de configuração, consulte Summary and highlighting.

Colunas retornadas

request.columnsToGet é um objeto SearchRequest.ColumnsToGet que contém os seguintes parâmetros.

Nome	Tipo	Descrição
columns (opcional)	`List<String>`	Colunas de atributo a retornar. Defina este parâmetro apenas se `returnAll` e `returnAllFromIndex` forem ambos `false`. Se omitido, apenas as colunas de chave primária serão retornadas.
returnAll (opcional)	boolean	Especifica se todas as colunas de atributo da tabela devem ser retornadas. Valor padrão: `false`.
returnAllFromIndex (opcional)	boolean	Especifica se todas as colunas de atributo indexadas devem ser retornadas. Valor padrão: `false`. Este parâmetro e `returnAll` não podem ser ambos `true`.

Valores de retorno

search retorna um objeto SearchResponse. A tabela a seguir descreve os campos principais.

Nome	Tipo	Descrição
totalCount	long	Número de linhas correspondentes. Chame `getTotalCount()` para obter o valor. O valor retornado depende da configuração `trackTotalCount`.
rows	`List<Row>`	Linhas retornadas por esta consulta. Chame `getRows()` para obter o valor. O número de linhas não excede `limit`.
nextToken	byte[]	Token da próxima página. Chame `getNextToken()` para obter o valor. Se o valor não for `null`, defina-o como `token` na próxima solicitação para continuar a leitura das linhas.
isAllSuccess	boolean	Indica se todas as partições do índice foram consultadas com sucesso. Chame `isAllSuccess()` para obter o valor. Se o valor for `false`, a resposta conterá resultados parciais e `totalCount` poderá ser menor que o número real de linhas correspondentes.