Todos os produtos
Search
Central de documentação

Tablestore:Consulta de dados

Última atualização: Jun 30, 2026

Os índices de busca no Tablestore SDK for Python oferecem suporte a consultas básicas, consulta booleana, ordenação e paginação, agregação, busca full-text e consulta vetorial k-nearest neighbor (KNN).

Consultas básicas

A tabela a seguir descreve as consultas básicas compatíveis com índices de busca.

Tipo de consulta

Descrição

Consulta match all

Corresponde a todas as linhas. Use para obter a contagem total de linhas ou retornar linhas aleatórias.

Consulta term

Recupera dados por correspondência exata em um valor de coluna, semelhante à correspondência de strings.

Consulta terms

Corresponde a linhas em que o valor de uma coluna é igual a qualquer uma das palavras-chave especificadas. Equivale ao operador IN do SQL.

Consulta prefix

Corresponde a linhas em que o valor de uma coluna começa com o prefixo especificado.

Consulta range

Corresponde a linhas em que o valor de uma coluna está dentro de um intervalo especificado.

Consulta wildcard

Corresponde a linhas usando caracteres curinga na string de busca.

Consulta exists

Verifica se uma coluna específica existe em uma linha. Também conhecida como consulta NULL ou consulta de valor NULL. Útil para dados esparsos.

Collapse (distinct)

Remove duplicatas dos resultados com base em uma coluna especificada para que cada valor distinto apareça apenas uma vez, garantindo diversidade no conjunto de resultados.

Consulta geo

Consulta linhas por localização geográfica. Inclui três subtipos:

  • Consulta geo-distance: corresponde a linhas dentro de uma área circular definida por um ponto central e um raio.

  • Consulta geo-bounding box: corresponde a linhas dentro de uma área retangular especificada.

  • Consulta geo-polygon: corresponde a linhas dentro de uma área poligonal especificada.

Consulta nested

Consulta linhas filhas de campos aninhados.

Consulta booleana

Uma consulta booleana recupera dados com base em uma combinação de subconsultas e retorna as linhas que atendem às condições especificadas. Para mais informações, consulte Consulta booleana.

Ordenação e paginação

Defina um método de ordenação ao criar um índice de busca ou especifique-o no momento da consulta. Para grandes conjuntos de resultados, use os parâmetros limit e offset ou tokens para paginar os resultados. Para mais informações, consulte Ordenação e paginação.

Agregação

As operações de agregação retornam estatísticas como mínimo, máximo, soma, média, contagem, contagem distinta e percentis. Você também pode agrupar resultados por valor de campo, intervalo, localização geográfica, filtro, histograma ou histograma de datas e executar agregações aninhadas em cada grupo. Para mais informações, consulte Agregação.

Busca full-text

A busca full-text localiza linhas que contêm strings de consulta especificadas. Configure parâmetros de destaque para realçar os termos correspondentes nos resultados. Para mais informações, consulte Busca full-text.

Consulta vetorial KNN

A consulta vetorial KNN realiza uma busca aproximada do vizinho mais próximo para encontrar os itens de dados mais semelhantes a um determinado vetor em um conjunto de dados de grande escala. Para mais informações, consulte Consulta vetorial KNN.