Tablestore:Ordenamiento y paginación

Escenarios

Preordenamiento de índices

De forma predeterminada, Tablestore ordena los datos de un índice de búsqueda según un orden predefinido conocido como preordenamiento de índices (IndexSort). Al consultar datos, IndexSort determina el orden predeterminado de los resultados devueltos.

Al crear un índice de búsqueda, puede personalizar IndexSort. Si no especifica esta configuración, el índice se ordenará por clave principal de forma predeterminada.

Especificar un método de ordenamiento al consultar datos

El ordenamiento solo se habilita para los campos cuyo parámetro EnableSortAndAgg esté establecido en true.

Puede especificar un método de ordenamiento para cada consulta. Las consultas basadas en índices de búsqueda admiten los métodos descritos a continuación. También es posible combinar varios métodos de ordenamiento con distintas prioridades.

ScoreSort

var searchQuery = new SearchQuery();
searchQuery.Sort = new Sort(new List<ISorter>() { new ScoreSort() });

PrimaryKeySort

Utilice PrimaryKeySort para ordenar los resultados de la consulta según el valor de la clave principal.

// Sort the query results based on the values of the primary key in ascending order. 
var searchQuery = new SearchQuery();
searchQuery.Sort = new Sort(new List<ISorter>() { new PrimaryKeySort() });

// Sort the query results based on the values of the primary key in descending order. 
var searchQuery = new SearchQuery();
searchQuery.Sort = new Sort(new List<ISorter>() { new PrimaryKeySort(SortOrder.DESC) });

FieldSort

FieldSort permite ordenar los resultados de la consulta según los valores de una o más columnas específicas.

var searchQuery = new SearchQuery();
var fieldSort = new FieldSort("col", SortOrder.ASC);
searchQuery.Sort = new Sort(new List<ISorter>() { fieldSort });

var searchQuery = new SearchQuery();
var col1Sort = new FieldSort("col", SortOrder.ASC);
var col2Sort = new FieldSort("co2", SortOrder.ASC);
searchQuery.Sort = new Sort(new List<ISorter>() { col1Sort, col2Sort });

GeoDistanceSort

Emplee GeoDistanceSort para ordenar los resultados de la consulta por ubicación geográfica.

var searchQuery = new SearchQuery();
var geoDistanceSort = new GeoDistanceSort("geoCol", new List<string>(){"0","0"});
searchQuery.Sort = new Sort(new List<ISorter>() { geoDistanceSort });

Especificar un método de paginación

Para paginar las filas de la respuesta, configure los parámetros Limit y Offset, o bien utilice tokens.

Paginación basada en los parámetros Limit y Offset

Para obtener información sobre cómo aumentar el valor máximo del parámetro Limit, consulte 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?.

Si no configura los parámetros Limit y Offset al utilizar este método, el valor predeterminado de Limit será 10 y el de Offset será 0.

var searchQuery = new SearchQuery();
searchQuery.Query = new MatchAllQuery();
searchQuery.Limit = 100;
searchQuery.Offset = 100;

Paginación basada en tokens

Se recomienda utilizar un token para la paginación profunda, ya que este método no impone límites en la profundidad de la paginación.

Si Tablestore no logra leer todos los datos que cumplen las condiciones de la consulta, devuelve NextToken. Utilice NextToken para continuar con la lectura de los datos subsecuentes.

De forma predeterminada, el uso de un token solo permite avanzar hacia las páginas siguientes. No obstante, dado que un token es válido durante toda la consulta, puede almacenarlo en caché y usar el token anterior para retroceder entre páginas.

Al utilizar un token, el método de ordenamiento coincide con el de la solicitud anterior. Tablestore ordena los datos según el parámetro IndexSort de forma predeterminada o conforme al método que haya especificado. No es posible definir el método de ordenamiento ni configurar el parámetro Offset cuando se emplea un token. Los datos se devuelven secuencialmente, página por página.

/// <summary>
/// In this example, a token is used to page the rows in the response and Tablestore reads all data and returns the data in a list. 
/// </summary>
/// <param name="otsClient"></param>
public static SearchResponse ReadMoreRowsWithToken(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    searchQuery.Query = new MatchAllQuery();

    var request = new SearchRequest(TableName, IndexName, searchQuery);

    var response = otsClient.Search(request);
    var rows = response.Rows;
    while (response.NextToken != null) // If NextToken is null in the response, all data is read. 
    {
        request.SearchQuery.Token = response.NextToken;
        response = otsClient.Search(request);
        rows.AddRange(response.Rows);
    }

    return response;
}

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

• Al consultar datos mediante un índice de búsqueda, 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, estos métodos permiten consultar datos desde múltiples dimensiones.

  Las funciones de ordenamiento y paginación le permiten organizar o dividir en páginas las filas que cumplen las condiciones de la consulta. Para obtener más información, consulte Sorting and paging.

  La función collapse (distinct) reduce el conjunto de resultados con base en una columna específica. Así, 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, puede obtener 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 las condiciones de la consulta sin necesidad de ordenarlas, llame a las operaciones ParallelScan y ComputeSplits para aprovechar la función de escaneo paralelo. Para obtener más información, consulte Parallel scan.