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:
-
Você tem uma conta Alibaba Cloud ou um usuário RAM com permissões para executar operações no Tablestore. Para obter informações sobre como conceder permissões de operação do Tablestore a um usuário RAM, consulte Usar uma política RAM para conceder permissões a um usuário RAM.
Se você pretende usar os SDKs ou a CLI do Tablestore para executar uma consulta, crie um par de AccessKey para sua conta Alibaba Cloud ou usuário RAM. Para mais detalhes, consulte Criar um par de AccessKey.
Crie uma tabela de dados. Para saber mais, consulte Operações em tabelas.
Crie um índice de pesquisa para a tabela de dados. Para mais informações, consulte Criar um índice de pesquisa.
Se você pretende usar os SDKs do Tablestore para executar uma consulta, inicialize uma instância OTSClient. Para mais detalhes, consulte Inicializar uma instância OTSClient.
Se você pretende usar a CLI do Tablestore para executar uma consulta, baixe e inicie a CLI do Tablestore e configure as informações da instância a ser acessada. Para saber mais, consulte Baixar a CLI do Tablestore e Iniciar a CLI do Tablestore e configurar as informações de acesso.
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
O Search Index oferece suporte a vários tipos de consulta para pesquisas de dados multidimensionais, incluindo consulta de termo, consulta de termos, consulta de correspondência total, consulta de correspondência, consulta de correspondência de frase, consulta de intervalo, consulta de prefixo, consulta de sufixo, consulta de curinga, consulta de curinga baseada em token, consulta booleana, consulta geográfica, consulta aninhada, pesquisa vetorial, e consulta de existência.
Ao consultar dados, você pode classificar e paginar o conjunto de resultados ou executar colapsar (deduplicação).
Para análise de dados, como encontrar o valor máximo ou mínimo, calcular uma soma ou contar linhas, use os recursos agregação estatística ou consulta SQL.
Para exportar dados rapidamente, independentemente da ordem do conjunto de resultados, use o recurso Parallel Scan.