Use o recurso de consulta match all para corresponder todas as linhas de uma tabela, obtendo o número total de linhas ou retornando múltiplas linhas aleatórias.
Pré-requisitos
Uma instância OTSClient está inicializada. Para obter mais informações, consulte Initialize an OTSClient instance.
Uma tabela de dados está criada e contém dados gravados. Para obter mais informações, consulte Create data tables e Write data.
Um índice de pesquisa está criado para a tabela de dados. Para obter mais informações, consulte Create search indexes.
Parâmetros
|
Parâmetro |
Descrição |
|
Query |
O tipo da consulta. Defina este parâmetro como MatchAllQuery. |
|
TableName |
O nome da tabela de dados. |
|
IndexName |
O nome do índice de pesquisa. |
|
Limit |
O número máximo de linhas que a consulta atual deve retornar. Para consultar apenas a quantidade de linhas que atendem às condições sem retornar dados específicos, defina este parâmetro como 0. |
|
GetTotalCount |
Indica se o sistema deve retornar o número total de linhas que atendem às condições da consulta. Valor padrão: false — o número total de linhas não é retornado. Definir este parâmetro como true compromete o desempenho da consulta. |
|
ColumnsToGet |
Indica se todas as colunas das linhas que atendem às condições da consulta devem ser retornadas. Você pode configurar os parâmetros ReturnAll, Columns e ReturnAllFromIndex. Por padrão,
Defina |
Exemplo
O código de exemplo a seguir mostra como consultar o número total de linhas em uma tabela.
/// <summary>
/// Perform a match all query to query the total number of rows in a table.
/// </summary>
/// <param name="otsClient"></param>
public static void MatchAllQuery(OTSClient otsClient)
{
var searchQuery = new SearchQuery();
searchQuery.Query = new MatchAllQuery();
searchQuery.GetTotalCount = true; // Set the GetTotalCount parameter to true to return the total number of rows that meet the query conditions.
/*
* In the result of a match all query, the value of the TotalCount parameter indicates the total number of rows in the table.
* To query only the number of rows that meet the query conditions without specific data, set the Limit parameter to 0.
*/
searchQuery.Limit = 0;
var request = new SearchRequest(TableName, IndexName, searchQuery);
var response = otsClient.Search(request);
// Check whether all rows that meet the query conditions are returned. If the value of the isAllSuccess parameter is false, Tablestore may fail to query data on some servers, and not all rows that meet the query conditions are returned.
Console.WriteLine("IsAllSuccess:" + response.IsAllSuccess);
Console.WriteLine("Total Count:" + response.TotalCount);
}Perguntas frequentes
Referências
-
Ao usar um índice de pesquisa para consultar dados, você pode empregar os seguintes métodos de consulta: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, Boolean query, geo query, nested query e exists query. Cada método permite consultar dados a partir de diferentes dimensões, de acordo com os requisitos do seu negócio.
É possível classificar ou paginar as linhas que atendem às condições da consulta por meio dos recursos de ordenação e paginação. Para obter mais informações, consulte Sorting and paging.
Use o recurso de colapso (distinct) para agrupar o conjunto de resultados com base em uma coluna específica. Dessa forma, dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Para obter mais informações, consulte Collapse (distinct).
Para analisar dados em uma tabela de dados, use o recurso de agregação da operação Search ou execute instruções SQL. Por exemplo, é possível obter os valores mínimo e máximo, a soma e o número total de linhas. Para obter mais informações, consulte Aggregation e SQL query.
Para obter todas as linhas que atendem às condições da consulta sem necessidade de ordená-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para obter mais informações, consulte Parallel scan.