Todos os produtos
Search
Central de documentação

Tablestore:Índice de pesquisa

Última atualização: Jul 03, 2026

Os índices de pesquisa permitem consultas multidimensionais e análises estatísticas em cenários de big data com base em índices invertidos e armazenamento colunar. Este tópico descreve como usar o recurso de índice de pesquisa com o Tablestore SDK for Python.

Gerencie índices

A tabela a seguir descreve as operações de gerenciamento compatíveis com índices de pesquisa.

Operação

Descrição

Crie um índice de pesquisa

Crie um índice de pesquisa para uma tabela de dados.

Listar índices de pesquisa

Consulte os índices de pesquisa criados para uma tabela.

Atualize as configurações de um índice de pesquisa

Atualize o tempo de vida (TTL) de um índice de pesquisa.

Consultar a descrição de um índice de pesquisa

Obtenha a descrição de um índice de pesquisa, incluindo informações sobre os campos e as configurações do índice.

Exclua um índice de pesquisa

Exclua um índice de pesquisa que não seja mais necessário.

Especifique o TTL de um índice de pesquisa

Exclua dados históricos ou estenda o período de retenção dos dados em um índice de pesquisa conforme as necessidades do negócio.

Tipos de dados

Além dos tipos de dados básicos, como Long, Double, Boolean, Keyword, Text, Date, Geopoint e Vector, os índices de pesquisa são compatíveis com dois tipos especiais: Array e Nested. Para mais informações, consulte Tipos de dados.

Consulta de dados

A tabela a seguir detalha os tipos de consulta compatíveis com índices de pesquisa. Selecione o tipo adequado às suas necessidades de negócio.

Recurso

Tipo de consulta

Descrição

Consulta básica

Match all query

Corresponde a todas as linhas da tabela para consultar o número total de linhas ou retornar várias linhas aleatórias.

Term query

Usa correspondências exatas para recuperar dados de uma tabela de dados. Uma term query é semelhante a uma consulta baseada em correspondência de strings.

Terms query

Permite especificar várias palavras-chave para pesquisar as linhas que correspondem a pelo menos uma delas. Uma linha de dados será retornada se o valor da coluna corresponder a pelo menos uma das palavras-chave. É possível usar terms queries da mesma forma que o operador IN em instruções SQL.

Prefix query

Recupera dados que contêm o prefixo especificado de uma tabela de dados.

Range query

Recupera dados que estão dentro do intervalo especificado.

Wildcard query

Recupera dados que correspondem a uma string contendo caracteres curinga.

Exists query

Essa consulta também é chamada de consulta NULL ou consulta de valor NULL. Ela é usada em dados esparsos para determinar se uma coluna de uma linha existe.

Collapse (distinct)

Colapsa o conjunto de resultados com base em uma coluna específica para exibir dados do tipo especificado apenas uma vez nos resultados retornados, garantindo a diversidade dos tipos de resultado.

Geo query

As geo queries são classificadas nos seguintes tipos: geo-distance query, geo-bounding box query e geo-polygon query.

  • Geo-distance query: permite especificar uma área geográfica circular definida por um ponto central e um raio como condição de consulta. O Tablestore retorna as linhas nas quais o valor do campo especificado está dentro da área geográfica circular.

  • Geo-bounding box query: permite especificar uma área geográfica retangular como condição de consulta. O Tablestore retorna as linhas nas quais o valor do campo especificado está dentro da área geográfica retangular.

  • Geo-polygon query: permite especificar uma área geográfica poligonal como condição de consulta. O Tablestore retorna as linhas nas quais o valor do campo especificado está dentro da área geográfica poligonal.

Nested query

Recupera os dados nas linhas filhas de campos aninhados.

Processamento de dados

Sorting and paging

Defina um método de ordenação ao criar um índice de pesquisa ou especifique um método de ordenação ao usar o índice de pesquisa para consultar dados. Dessa forma, as linhas que atendem às condições de consulta são retornadas com base na ordem predefinida ou especificada.

Se a resposta incluir um grande número de linhas, localize os dados configurando os parâmetros limit e offset ou usando tokens.

Aggregation

Execute operações de agregação para obter o valor mínimo, valor máximo, soma, média, contagem e contagem distinta de linhas, estatísticas de percentil e linhas em cada grupo. Também é possível executar operações de agregação para agrupar resultados por valor de campo, intervalo, localização geográfica, filtro, histograma ou histograma de datas, além de realizar consultas aninhadas. Execute múltiplas operações de agregação para consultas complexas.

Consulta baseada em combinação de condições de subconsulta

Boolean query

Recupera dados de uma tabela de dados com base em uma combinação de subconsultas. O Tablestore retorna as linhas que correspondem às subconsultas.

Pesquisa de texto completo

Match query

Usa correspondências aproximadas para recuperar dados de uma tabela de dados.

Match phrase query

Essa consulta é semelhante à match query, exceto pelo fato de avaliar as posições dos tokens. Uma linha atende à condição de consulta somente se a ordem e as posições dos tokens na linha corresponderem à ordem e às posições especificadas.

Highlight the query results

Configure parâmetros de destaque para realçar as strings de consulta nos segmentos das linhas que atendem às condições de consulta.

Pesquisa vetorial

KNN vector query

Use o recurso de consulta vetorial k-nearest neighbor (KNN) para realizar uma pesquisa de vizinho mais próximo aproximada com base em vetores. Dessa forma, é possível encontrar itens de dados com a maior similaridade em relação ao vetor que você deseja consultar em um conjunto de dados em grande escala.

Exportação de dados

Se não houver requisitos quanto à ordem dos resultados da consulta, use o recurso de varredura paralela para obter os resultados da consulta de maneira eficiente. Para mais informações, consulte Varredura paralela.