Todos os produtos
Search
Central de documentação

Tablestore:Consulta de termos

Última atualização: Sep 29, 2026

Uma consulta de termos é semelhante a uma consulta de termo, mas aceita várias palavras-chave. A consulta retorna uma linha de dados quando o valor da coluna corresponde a pelo menos uma das palavras-chave. Use consultas de termos da mesma forma que o operador IN em instruções SQL.

Operação de API

Chame a operação Search ou ParallelScan e defina o tipo de consulta como TermsQuery para executar uma consulta de termos.

Parâmetros

Parâmetro

Descrição

query

O tipo da consulta. Defina o parâmetro de consulta como TermsQuery.

fieldName

O nome do campo a corresponder.

terms

Os termos de pesquisa para correspondência. Especifique até 1.024 termos.

A consulta retorna uma linha de dados quando o valor da coluna corresponde a pelo menos uma das palavras-chave.

getTotalCount

Defina se a consulta retorna o número total de linhas que atendem às condições. O valor padrão é false, o que indica que o sistema não retorna o número total de linhas.

Se você definir este parâmetro como true, o desempenho da consulta será comprometido.

weight

O peso a atribuir ao campo consultado para calcular a pontuação de relevância de palavras-chave com base em BM25. Use este parâmetro em cenários de pesquisa de texto completo. Quanto maior o peso especificado para o campo, maior a pontuação de relevância baseada em BM25. O valor deve ser um número de ponto flutuante positivo.

Este parâmetro não afeta o número de linhas retornadas, mas altera as pontuações de relevância baseadas em BM25 dos resultados da consulta.

tableName

O nome da tabela de dados.

indexName

O nome do índice de pesquisa.

columnsToGet

Defina se a consulta retorna todas as colunas de cada linha que atende às condições. Especifique os campos returnAll e columns para este parâmetro.

O valor padrão do campo returnAll é false, o que indica que o sistema não retorna todas as colunas. Nesse caso, use o campo columns e especifique as colunas a retornar. Caso não especifique nenhuma coluna, o sistema retorna apenas as colunas de chave primária.

Se você definir o campo returnAll como true, o sistema retorna todas as colunas.

Métodos

Use o console do Tablestore, a CLI do Tablestore ou os SDKs do Tablestore para executar uma consulta de termos. Antes de executar a consulta, certifique-se de atender aos seguintes pré-requisitos:

Usar o console do Tablestore

  1. Acesse a aba Index Management.

    1. Faça login no Console do Tablestore.

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

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

    4. Na aba Instance Details, dentro da aba Data Table List, clique no nome da tabela de dados ou clique 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, especifique as condições de consulta.

    1. Por padrão, o sistema retorna todas as colunas. Para retornar 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 retorna dados que atendem a todas as condições especificadas. Se selecionar Or, a consulta retorna dados que atendem a pelo menos uma das condições. Se selecionar Not, a consulta retorna dados que não atendem às condições especificadas.

    3. Selecione um campo indexado e clique em Add.

    4. Defina o tipo de consulta do campo indexado como Terms query (TermsQuery), insira um valor e clique em Add.

      Para adicionar vários valores, repita o processo de inserir um Value e clicar em Add.

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

    6. Por padrão, a agregação está desativada. 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.

Usar a CLI do Tablestore

Execute o comando search na CLI do Tablestore para consultar dados usando índices de pesquisa. Para mais informações, consulte Índice de pesquisa.

  1. Execute o comando search para usar o índice de pesquisa search_index, consultar dados e retornar todas as colunas indexadas de cada linha que atende às condições da consulta.

    search -n search_index --return_all_indexed
  2. Insira as condições de consulta conforme solicitado pelo sistema:

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "TermsQuery",
            "Query": {
                "FieldName": "col_keyword",
                "Terms": ["hangzhou", "xi'an"]
            }
        }
    }

Usar os SDKs do Tablestore

Execute uma consulta de termos usando os seguintes SDKs do Tablestore: SDK do Tablestore para Java, SDK do Tablestore para Go, SDK do Tablestore para Python, SDK do Tablestore para Node.js, SDK do Tablestore para .NET e SDK do Tablestore para PHP. Neste exemplo, usamos o SDK do Tablestore para Java.

O exemplo a seguir consulta linhas cujo valor do campo category seja exatamente igual a books ou games e retorna até 10 linhas, além do número total de linhas correspondentes.

String tableName = "example_table";
String indexName = "example_index";

TermsQuery termsQuery = new TermsQuery();
termsQuery.setFieldName("category");
termsQuery.addTerm(ColumnValue.fromString("books"));
termsQuery.addTerm(ColumnValue.fromString("games"));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(termsQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());

Faturamento

A consulta de dados com um Search Index consome throughput de leitura. Para mais informações, consulte Medição e faturamento do Search Index.

Perguntas frequentes

Referências