Uma consulta booleana recupera dados de uma tabela com base em uma combinação de subconsultas. O Tablestore retorna as linhas que atendem às condições das subconsultas. Uma subconsulta pode ser de qualquer tipo, inclusive outra consulta booleana.
Operação da API
Para executar uma consulta booleana, chame a operação Search ou ParallelScan e defina o tipo de consulta como BoolQuery.
Parâmetros
Parâmetro | Descrição |
mustQueries | Lista de subconsultas. Retorna apenas as linhas que atendem a todas as condições das subconsultas. Este parâmetro equivale ao operador AND. |
mustNotQueries | Lista de subconsultas. Retorna apenas as linhas que não atendem a nenhuma condição das subconsultas. Este parâmetro equivale ao operador NOT. |
filterQueries | Lista de subconsultas. Retorna apenas as linhas que atendem a todos os subfiltros. Um filtro é semelhante a uma consulta, mas não calcula pontuação de relevância com base no número de subfiltros atendidos por uma linha. |
shouldQueries | Lista de subconsultas opcionais para correspondência nos resultados. Este parâmetro equivale ao operador OR. Retorna apenas as linhas que atendem ao número mínimo de condições de subconsulta especificado pelo parâmetro shouldQueries. Uma pontuação de relevância geral mais alta indica que a linha atende a mais condições de subconsulta especificadas pelo parâmetro shouldQueries. |
minimumShouldMatch | Número mínimo de condições de subconsulta especificadas pelo parâmetro shouldQueries que as linhas retornadas devem atender. Se não houver outras condições além das definidas em shouldQueries, o valor padrão de minimumShouldMatch será 1. Caso existam outras condições (como as dos parâmetros mustQueries, mustNotQueries e filterQueries), o valor padrão de minimumShouldMatch será 0. |
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, indicando que a contagem total não será retornada. Definir este parâmetro como true compromete o desempenho da consulta. |
tableName | Nome da tabela de dados. |
indexName | Nome do índice de pesquisa. |
columnsToGet | Define se o sistema deve retornar todas as colunas de cada linha que atenda às condições da consulta. Configure os campos returnAll e columns para este parâmetro. O valor padrão do campo returnAll é false, indicando que nem todas as colunas serão retornadas. Nesse caso, use o campo columns para especificar as colunas desejadas. Sem essa especificação, o sistema retorna apenas as colunas de chave primária. Se você definir o campo returnAll como true, todas as colunas serão retornadas. |
Métodos
Execute consultas booleanas usando o console do Tablestore, a CLI do Tablestore ou os SDKs do Tablestore. Antes de prosseguir, certifique-se de cumprir os seguintes pré-requisitos:
-
Utilize uma conta Alibaba Cloud ou um usuário RAM com as permissões necessárias para operações do Table Store. Para conceder permissões a um usuário RAM, consulte Conceder permissões a um usuário RAM usando uma política do RAM.
Caso utilize um SDK ou ferramenta de linha de comando, crie um AccessKey para sua conta Alibaba Cloud ou usuário RAM, caso ainda não possua um.
Você já criou uma tabela de dados.
Um Índice de Pesquisa foi criado para a tabela de dados.
Se estiver usando um SDK, inicialize o Cliente do Tablestore.
Ao utilizar a ferramenta de linha de comando, baixe e inicie a ferramenta, configure a conexão com sua instância e selecione a tabela de destino. Para mais informações, consulte Baixar a ferramenta de linha de comando, Iniciar a ferramenta e configurar informações de conexão e Operações de tabela de dados.
Faturamento
A consulta de dados por meio de um Índice de Pesquisa consome throughput de leitura. Para mais informações, consulte Medição e faturamento do Índice de Pesquisa.
Perguntas frequentes
Referências
O Índice de Pesquisa suporta vários tipos de consulta para buscas multidimensionais de dados, 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 curinga, consulta curinga 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.
Para exportar dados rapidamente sem se preocupar com a ordem do conjunto de resultados, utilize o recurso Parallel Scan.