Tablestore:Ordenação e paginação

Cenários de uso

Pré-ordenação do índice

Por padrão, os dados em um índice de pesquisa são ordenados com base nas configurações de pré-ordenação especificadas pelo parâmetro IndexSort. Ao usar um índice de pesquisa para consultar dados, essas configurações determinam a ordem padrão de retorno dos dados correspondentes.

Ao criar um índice de pesquisa, você pode especificar as configurações de pré-ordenação pelo parâmetro IndexSort. Se não especificar configurações de pré-ordenação, os dados no índice de pesquisa serão ordenados pelo valor da chave primária.

Especificar um método de ordenação ao consultar dados

A ordenação pode ser ativada apenas para campos com enable_sort_and_agg definido como True.

Você pode especificar um método de ordenação para cada consulta. Consultas baseadas em índice de pesquisa são compatíveis com os seguintes métodos de ordenação. Também é possível especificar vários métodos com base em diferentes prioridades.

ScoreSort

sort = Sort(
    sorters=[ScoreSort(sort_order=SortOrder.DESC)]
)
client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, sort=sort, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL)
)

PrimaryKeySort

O PrimaryKeySort ordena os resultados da consulta com base no valor da chave primária.

sort = Sort(
    sorters=[PrimaryKeySort(sort_order=SortOrder.DESC)]
)
client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, sort=sort, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL)
) = PrimaryKeySort(sort_order=SortOrder.DESC)

FieldSort

O FieldSort ordena os resultados da consulta com base nos valores de uma ou mais colunas específicas.

sort = Sort(
    sorters=[FieldSort('a', SortOrder.ASC)]
)

client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, sort=sort, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL)
)

sort = Sort(
    sorters=[
        FieldSort('a', SortOrder.ASC),
        FieldSort('b', SortOrder.ASC)
    ]
)

client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, sort=sort, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL)
)

GeoDistanceSort

O GeoDistanceSort ordena os resultados da consulta por localização geográfica.

sort = Sort(
    sorters=[GeoDistanceSort('g', ['32.5,116.5', '32.0,116.0'], sort_order=SortOrder.DESC, sort_mode=SortMode.MAX)]
)

client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, sort=sort, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL)
)    

Especificar um método de paginação

Use limit e offset ou tokens para dividir os resultados da consulta em páginas.

Configurar os parâmetros limit e offset

Se você não especificar valores para os parâmetros limit e offset, os valores padrão serão usados. O valor padrão do parâmetro limit é 10. O valor padrão do parâmetro offset é 0.

query = RangeQuery('k', 'key100', 'key500', include_lower=False, include_upper=False)
search_response = client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', 
    SearchQuery(query, offset=100, limit=100, get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
)  
print('request_id : %s' % search_response.request_id)
print('is_all_succeed : %s' % search_response.is_all_succeed)
print('total_count : %s' % search_response.total_count)
print('rows : %s' % search_response.rows)

Usar um token

Recomenda-se usar um token para paginação profunda, pois este método não tem limites de profundidade de paginação.

Se o Tablestore não conseguir ler todos os dados que atendem às condições da consulta, ele retorna next_token. Use next_token para continuar lendo os dados subsequentes.

Por padrão, ao usar um token, a paginação ocorre apenas para frente. Para retornar a uma página anterior, armazene em cache um token anterior e reutilize-o, pois os tokens permanecem válidos durante toda a consulta.

Ao usar um token, o método de ordenação permanece o mesmo da solicitação anterior. O Tablestore ordena os dados com base no campo IndexSort por padrão ou no método especificado. Não é possível especificar o método de ordenação ao usar um token. Também não é possível configurar o parâmetro offset ao usar um token. Os dados retornam página por página, o que pode resultar em consultas mais lentas.

query = MatchAllQuery()
all_rows = []
next_token = None
# first round
search_response = client.search('<TABLE_NAME>', '<SEARCH_INDEX_NAME>',
        SearchQuery(query, next_token=next_token, limit=100, get_total_count=True),
        columns_to_get=ColumnsToGet(['k', 't', 'g', 'ka', 'la'], ColumnReturnType.SPECIFIED))
all_rows.extend(search_response.rows)
# loop
while search_response.next_token:
    search_response = client.search('<TABLE_NAME>', '<SEARCH_INDEX_NAME>',
        SearchQuery(query, next_token=search_response.next_token, sort=None, limit=100, get_total_count=True),
        columns_to_get=ColumnsToGet(['k', 't', 'g', 'ka', 'la'], ColumnReturnType.SPECIFIED))
    all_rows.extend(search_response.rows)

print('Total rows:%d' % len(all_rows))

Perguntas frequentes

• O que fazer quando nenhum dado é encontrado ao chamar a operação Search?

• Como aumentar o valor do parâmetro limit para 1000 ao usar a operação Search do recurso de índice de pesquisa para consultar dados?

• Por que um token se torna inválido ao usar paginação em uma consulta baseada em índice de pesquisa?

Referências

• Ao usar um índice de pesquisa para consultar dados, você pode usar os seguintes métodos de consulta: consulta por termo, consulta por termos, consulta match all, consulta match, consulta match phrase, consulta por prefixo, consulta por intervalo, consulta wildcard, consulta geográfica, consulta booleana, consulta de vetor KNN, consulta aninhada e consulta exists. Você pode usar os métodos de consulta fornecidos pelo índice de pesquisa para consultar dados de múltiplas dimensões de acordo com seus requisitos de negócio.

  Ordene ou pagine as linhas que atendem às condições da consulta usando os recursos de ordenação e paginação. Para mais informações, consulte Ordenação e paginação.

  Use o recurso collapse (distinct) para recolher o conjunto de resultados com base em uma coluna específica. Dessa forma, os dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Saiba mais em 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, obtenha os valores mínimo e máximo, soma e número total de linhas. Para mais informações, consulte Agregação e Consulta SQL.

• Para obter todas as linhas que atendem às condições da consulta sem ordenação, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Consulte Varredura paralela.