Tablestore:Executar uma consulta booleana

Pré-requisitos

• Inicialize uma instância do OTSClient. Para mais informações, consulte Inicializar uma instância do OTSClient.

• Crie uma tabela de dados e insira dados na tabela. Para mais informações, consulte Criar tabelas de dados e Gravar dados.

• Crie um índice de pesquisa para a tabela de dados. Para mais informações, consulte Criar índices de pesquisa.

Parâmetros

Exemplo

O código de exemplo a seguir mostra como executar uma consulta booleana composta por subconsultas booleanas. Neste exemplo, a consulta busca linhas em que o valor da coluna Keyword_type_col é "SearchIndex" ou "TableStore". O serviço retorna todas as colunas do índice de pesquisa.

/// <summary>
/// A Boolean query contains one or more subqueries. Each subquery has its own type. 
/// MustQueries: The rows must meet all subquery conditions. 
/// ShouldQueries: More than one condition is specified by the ShouldQueries parameter. If a row meets at least one condition, the row meets the query conditions. 
/// MustNotQueries: The rows must not meet the conditions. 
/// MinimumShouldMatch: The rows must meet the minimum number of conditions. 
/// </summary>
/// <param name="otsClient"></param>
public static void BoolQuery(OTSClient otsClient)
{
    Console.WriteLine("\n Start bool query...");

    var searchQuery = new SearchQuery();
    // Return the total number of rows that meet the query conditions. 
    searchQuery.GetTotalCount = true;
    var boolQuery = new BoolQuery();
    var shouldQuerys = new List<IQuery>();
    shouldQuerys.Add(new TermQuery(Keyword_type_col, new ColumnValue("SearchIndex")));
    shouldQuerys.Add(new TermQuery(Keyword_type_col, new ColumnValue("TableStore")));
    boolQuery.ShouldQueries = shouldQuerys;
    boolQuery.MinimumShouldMatch = 1;

    searchQuery.Query = boolQuery;

    var request = new SearchRequest(TableName, IndexName, searchQuery);
    // You can specify the ColumnsToGet parameter to return the columns that you specify, all columns in the rows that meet the query conditions, or all columns in the search index. If you do not specify this parameter, only the primary key columns are returned. 
    request.ColumnsToGet = new ColumnsToGet()
    {
        // Return all columns in the search index. 
        ReturnAllFromIndex = true
        // Return the columns that you specify. 
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Return all columns in the rows that meet the query conditions. 
        //ReturnAll = true
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); // Display the total number of rows that meet the query conditions instead of the number of returned rows. 
    foreach (var row in response.Rows)
    {
        PrintRow(row);
    }
}

Perguntas frequentes

• What do I do if no data can be found by calling the Search operation?

• How do I increase the value of the limit parameter to 1000 when I call the Search operation of the search index feature to query data?

• Why does a token become invalid when pagination is used in a search index-based query?

Referências

• Ao utilizar um índice de pesquisa para consultar dados, você pode empregar os seguintes métodos: 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. Consulte dados em múltiplas dimensões com métodos distintos, conforme as necessidades do seu negócio.

  Use os recursos de ordenação e paginação para classificar ou paginar as linhas que atendem às condições da consulta. Para mais informações, consulte Sorting and paging.

  Use o recurso de agrupamento (distinct) para agrupar o conjunto de resultados com base em uma coluna específica. Dessa forma, os dados desse tipo aparecem apenas uma vez nos resultados. Para mais informações, consulte Agrupamento (distinct).

• Caso precise analisar os dados de uma tabela, utilize o recurso de agregação da operação Search ou execute instruções SQL. Por meio deles, você pode obter valores mínimos e máximos, somas e a quantidade total de linhas. Para mais informações, consulte Aggregation e SQL query.

• Para recuperar todas as linhas que correspondem às condições da consulta sem precisar ordená-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Parallel scan.