A consulta de termos é semelhante à consulta de termo único, mas permite buscar por várias palavras-chave. O sistema retorna uma linha de dados quando o valor da coluna corresponde a pelo menos uma das palavras-chave especificadas. Esse tipo de consulta funciona como o operador IN em instruções SQL.
Operação de API
Para executar uma consulta de termos, chame a operação Search ou ParallelScan e defina o tipo de consulta como TermsQuery.
Parâmetros
Parâmetro | Descrição |
query | Tipo da consulta. Defina este parâmetro como TermsQuery. |
fieldName | Nome do campo para correspondência. |
terms |
Termos de busca para correspondência. É possível especificar até 1.024 termos. O sistema retorna uma linha de dados se o valor da coluna corresponder a pelo menos uma das palavras-chave. |
getTotalCount | Define se o sistema deve retornar o número total de linhas que atendem às condições da consulta. O valor padrão é false, o que indica que a contagem total não será retornada. Definir este parâmetro como true pode comprometer o desempenho da consulta. |
weight | Peso atribuído ao campo consultado para calcular a pontuação de relevância de palavras-chave baseada em BM25. Utilizado em cenários de busca full-text. Quanto maior o peso definido para o campo, maior será sua pontuação de relevância BM25. Este parâmetro aceita um número de ponto flutuante positivo. O peso não altera a quantidade de linhas retornadas, mas influencia diretamente a pontuação de relevância dos resultados da consulta. |
tableName | Nome da tabela de dados. |
indexName | Nome do índice de busca. |
columnsToGet | Indica se o sistema deve retornar todas as colunas de cada linha correspondente. Configure os campos returnAll e columns para este parâmetro. Por padrão, returnAll é false e nem todas as colunas são retornadas. Nesse caso, utilize o campo columns para definir quais colunas deseja obter. Se nenhuma coluna for especificada, apenas as colunas de chave primária serão retornadas. Ao definir returnAll como true, todas as colunas serão incluídas na resposta. |
Métodos
Você pode consultar termos usando o console do Tablestore, a CLI do Tablestore ou os SDKs do Tablestore. Antes de iniciar, certifique-se de cumprir os seguintes pré-requisitos:
-
Possua uma conta Alibaba Cloud ou um usuário RAM com permissões para operar no Tablestore. Para conceder permissões a um usuário RAM, consulte Usar uma política do RAM para conceder permissões a um usuário RAM.
Se pretender utilizar os SDKs do Tablestore ou a CLI do Tablestore, crie um par de AccessKey para sua conta Alibaba Cloud ou usuário RAM. Para mais detalhes, veja Criar um par de AccessKey.
Tenha uma tabela de dados criada. Consulte Operações em tabelas.
Tenha criado um índice de busca para a tabela de dados. Veja Criar um índice de busca.
Se for usar os SDKs do Tablestore, inicialize uma instância OTSClient. Siga as instruções em Inicializar uma instância OTSClient.
Para consultas via CLI do Tablestore, baixe e inicie a ferramenta e configure as informações de acesso à instância desejada. Consulte Baixar a CLI do Tablestore e Iniciar a CLI do Tablestore e configurar informações de acesso.
Faturamento
Consultar dados usando um Search Index consome throughput de leitura. Para mais informações, veja Medição e faturamento do Search Index.
Perguntas frequentes
Referências
O Search Index suporta diversos tipos de consulta para buscas multidimensionais, incluindo consulta de termo, consulta de termos, consulta match all, consulta match, consulta phrase match, consulta de intervalo, consulta de prefixo, consulta de sufixo, consulta wildcard, consulta wildcard baseada em token, consulta booleana, consulta geográfica, consulta aninhada, busca vetorial e consulta exists.
Durante a consulta de dados, é possível ordenar e paginar o conjunto de resultados ou aplicar colapso (deduplicação).
Para análises de dados, como encontrar valores máximos ou mínimos, calcular somas ou contar linhas, utilize os recursos de agregação estatística ou consulta SQL.
Caso precise exportar dados rapidamente sem se preocupar com a ordem dos resultados, utilize o recurso Parallel Scan.