Todos os produtos
Search
Central de documentação

Tablestore:Term Query

Última atualização: Jul 03, 2026

Uma consulta de termo (TermQuery) localiza dados em uma tabela por correspondência exata com um valor especificado, de forma semelhante à correspondência de strings.

Observações de uso

  • Em tipos de campo não textuais, como Keyword e Integer, o valor do campo deve corresponder exatamente ao termo da consulta.

  • Evite usar consultas de termo em campos Text, pois a tokenização é imprevisível e pode mudar com o tempo. Uma consulta de termo em um campo Text verifica se algum token gerado pelo analisador corresponde exatamente ao termo pesquisado. O termo da consulta em si não é tokenizado. Para buscar um valor completo e não tokenizado, use uma coluna virtual para mapear o campo como tipo Keyword e execute a consulta. Por exemplo, se um campo Text com o valor "tablestore is cool" for tokenizado em "tablestore", "is" e "cool", uma busca por qualquer um desses termos retornará uma correspondência.

Procedimento

  1. Acesse a aba Index Management.

    1. Faça login no console do Table Store.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique em no nome da instância ou em Instance Management na coluna Actions.

    4. Na aba Instance Details, na aba Data Table List, clique em no nome da tabela de dados ou em Index Management na coluna Actions.

  2. Na aba Index Management, localize o Search Index desejado e clique em Search na coluna Actions.

  3. Na caixa de diálogo Search, configure a consulta.

    1. Por padrão, todas as colunas são retornadas. Para retornar apenas colunas específicas, desative Retrieve All Columns e insira os nomes das colunas separados por vírgulas.

      Nota

      Por padrão, o Table Store retorna as colunas de chave primária da tabela de dados.

    2. Selecione um operador lógico: And, Or ou Not.

      Se você selecionar And, a consulta retornará dados que atendem a todas as condições especificadas. Se selecionar Or, a consulta retornará dados que satisfazem pelo menos uma das condições. Se selecionar Not, a consulta retornará dados que não correspondem às condições definidas.

    3. Selecione um campo de índice e clique em Add.

    4. Defina o tipo de consulta do campo de índice como Term Query (TermQuery) e insira o valor a ser buscado.

    5. A ordenação está desativada por padrão. Para ordenar os resultados por um campo específico, ative Enable Sorting, adicione o campo de ordenação e configure a ordem desejada.

    6. A agregação também está desativada por padrão. Para executar uma agregação estatística em um campo específico, ative Enable Aggregation, adicione o campo para agregação e configure as definições de agregação.

  4. Clique em OK.

    Os resultados da consulta aparecem na aba Index Management.

Integração de desenvolvimento

Use um SDK ou uma ferramenta de linha de comando para executar uma consulta de termo.

Faturamento

A consulta de dados por meio de um Search Index consome throughput de leitura. Para mais detalhes, consulte Medição e faturamento do Search Index.

Perguntas frequentes

Documentos relacionados