Uma consulta por sufixo (SuffixQuery) localiza dados em um índice de pesquisa que terminam com uma string específica. Por exemplo, você pode rastrear a entrega de um pacote usando os quatro últimos dígitos de um número de telefone.
Como funciona
Para executar uma SuffixQuery, especifique o valor do sufixo a ser correspondido.
Apenas o tipo de dado FuzzyKeyword oferece suporte a consultas por sufixo. O tipo FuzzyKeyword é otimizado para operações de pesquisa difusa, como SuffixQuery, PrefixQuery e wildcard query, e garante desempenho estável independentemente do volume de dados.
Campos do tipo
FuzzyKeywordnão permitem ordenação ou agregação. Se precisar ordenar ou agregar dados de um campoFuzzyKeyword, crie umavirtual columndo tipoKeywordpara essa finalidade.Para simular uma consulta por sufixo em um campo
Keyword, inverta a string durante a gravação dos dados e use uma consulta por prefixo (PrefixQuery) para buscar os dados.
API
Chame a operação Search ou ParallelScan com o tipo de consulta definido como SuffixQuery.
Parâmetros
|
Parâmetro |
Descrição |
|
query |
Defina o tipo de consulta como SuffixQuery. |
|
fieldName |
O campo a ser correspondido. |
|
suffix |
O valor do sufixo. |
|
getTotalCount |
Especifica se o número total de linhas correspondentes deve ser retornado. O valor padrão é false. Retornar o número total de linhas correspondentes afeta o desempenho da consulta. |
|
weight |
O peso da consulta. Este parâmetro é usado para ordenação baseada em pontuação em cenários de índice de texto completo. Um valor de peso maior resulta em uma pontuação mais alta para as linhas correspondentes. O valor deve ser um número de ponto flutuante positivo. Este parâmetro afeta apenas as pontuações dos resultados retornados, não o número de resultados. |
|
tableName |
O nome da tabela de dados. |
|
indexName |
O nome do índice de pesquisa. |
|
columnsToGet |
As colunas a serem retornadas. Isso inclui as configurações returnAll e columns. Por padrão, returnAll é false. Se returnAll for false, use columns para especificar as colunas a serem retornadas. Se você não especificar columns, apenas as colunas de chave primária serão retornadas. Se você definir returnAll como true, todas as colunas serão retornadas. |
Uso
Execute uma consulta por sufixo usando o console do Tablestore ou um SDK. Antes de começar, atenda aos seguintes pré-requisitos:
Você criou um
RAM usere concedeu a ele permissões para acessar o Tablestore. Para obter mais informações, consulte Usar o par AccessKey de um usuário RAM para acessar o Tablestore.Você criou uma tabela de dados. Para obter mais informações, consulte Operações em tabelas de dados.
Você criou um índice de pesquisa para a tabela de dados. Para obter mais informações, consulte Criar um índice de pesquisa.
Faturamento
A consulta de dados usando um Search Index consome throughput de leitura. Para obter mais informações, consulte Medição e faturamento do Search Index.
Perguntas frequentes
Tópicos relacionados
O Search Index oferece suporte a vários tipos de consulta para buscas multidimensionais, incluindo consulta por termo, consulta por termos, consulta match all, consulta match, consulta phrase match, consulta por intervalo, consulta por prefixo, consulta por sufixo, consulta wildcard, consulta wildcard baseada em token, consulta booleana, consulta geográfica, consulta aninhada, busca vetorial e consulta exists.
Ao consultar dados, você pode ordenar e paginar o conjunto de resultados ou executar colapso (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 de agregação estatística ou consulta SQL.
Para exportar dados rapidamente independentemente da ordem do conjunto de resultados, use o recurso Parallel Scan.