Tablestore:Consulta por rango

Requisitos previos

• Se inicializó una instancia de OTSClient. Para obtener más información, consulte Initialize an OTSClient instance.

• Se creó una tabla de datos y se escribieron datos en ella. Para obtener más información, consulte Create data tables y Write data.

• Se creó un índice de búsqueda para la tabla de datos. Para obtener más información, consulte Create search indexes.

Parámetros

Ejemplos

A continuación se muestra un ejemplo de código para consultar las filas donde el valor de la columna Long_type_col es mayor o igual a 0 y menor que 6. En este ejemplo también se devuelve el número total de filas que cumplen con las condiciones de la consulta.

/// <summary>
/// Search the table for rows in which the value of the Long_type_col column is greater than or equal to 0 and less than 6. 
/// </summary>
/// <param name="otsClient"></param>
public static void RangeQuery(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    // Specify that the total number of rows that meet the query conditions is returned. 
    searchQuery.GetTotalCount = true;
    var rangeQuery = new RangeQuery(Long_type_col, new ColumnValue(0), new ColumnValue(6));
    // Specify that the rows in which the value of the column that you want to match is equal to the value of the From parameter are included in the response. 
    rangeQuery.IncludeLower = true;
    searchQuery.Query = rangeQuery;
    var request = new SearchRequest(TableName, IndexName, searchQuery);
    // You can configure the ColumnsToGet parameter to specify the columns that you want to return, specify that all columns are returned, or specify that all columns in the search index are returned. If you do not configure this parameter, only the primary key columns are returned. 
    request.ColumnsToGet = new ColumnsToGet()
    {
        // Specify that all columns in the search index are returned. 
        ReturnAllFromIndex = true
        // Specify the columns that you want to return. 
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Specify that all columns are returned. 
        //ReturnAll = true
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); // Specify that the total number of rows that meet the query conditions instead of the number of rows that are returned is displayed. 
}

Preguntas frecuentes

• 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?

Referencias

• Cuando usa un índice de búsqueda para consultar datos, puede utilizar los siguientes 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 y exists query. Según sus necesidades de negocio, combine distintos métodos para consultar datos desde varias dimensiones.

  Mediante las funciones de ordenamiento y paginación, ordene o pagine las filas que cumplen con las condiciones de la consulta. Para obtener más información, consulte Sorting and paging.

  Utilice la función collapse (distinct) para agrupar el conjunto de resultados según una columna específica. De esta manera, los datos del tipo indicado aparecen una sola vez en los resultados de la consulta. Para obtener más información, consulte Collapse (distinct).

• Si necesita analizar los datos de una tabla, utilice la función de agregación de la operación Search o ejecute instrucciones SQL. Por ejemplo, obtenga los valores mínimo y máximo, la suma y el número total de filas. Para obtener más información, consulte Aggregation y SQL query.

• Para obtener todas las filas que cumplen con las condiciones de la consulta sin necesidad de ordenarlas, llame a las operaciones ParallelScan y ComputeSplits para usar la función de escaneo paralelo. Para obtener más información, consulte Parallel scan.