How to perform a prefix query by using Tablestore SDK for Go - Tablestore: Central de Documentação do Alibaba Cloud

Use a consulta de prefixo para buscar dados correspondentes a um prefixo especificado. Se o campo usado na condição de prefixo for do tipo TEXT, os valores serão tokenizados. Uma linha atenderá aos critérios da consulta quando pelo menos um token contiver o prefixo definido.

Pré-requisitos

Instância OTSClient inicializada. Para mais informações, consulte Inicializar uma instância OTSClient.
Tabela de dados criada e populada. Para mais informações, consulte Criar uma tabela de dados e Gravar dados.
Índice de pesquisa criado para a tabela de dados. Para mais informações, consulte Criar índices de pesquisa.

Parâmetros

Parâmetro	Descrição
TableName	Nome da tabela de dados.
IndexName	Nome do índice de pesquisa.
Query	Tipo de consulta. Defina este parâmetro como PrefixQuery.
FieldName	Nome do campo para correspondência.
Prefix	Prefixo para correspondência. Se o campo alvo for do tipo TEXT, os valores serão tokenizados antes da correspondência. Uma linha atenderá às condições da consulta quando pelo menos um token começar com o prefixo especificado.
GetTotalCount	Indica se o sistema deve retornar o número total de linhas correspondentes às condições da consulta. Valor padrão: false. Definir este valor como true reduz o desempenho da consulta.
ColumnsToGet	Controla as colunas retornadas. Configure por meio dos subparâmetros ReturnAll e Columns. Por padrão, ReturnAll é false e apenas as colunas de chave primária são retornadas. Para retornar colunas específicas fora da chave primária, defina ReturnAll como false e liste as colunas em Columns. Para retornar todas as colunas, defina ReturnAll como true.

Código de exemplo

O exemplo abaixo consulta linhas nas quais o valor da coluna Col_Keyword começa com hangzhou:

/**
 * Query the rows in which the value of the Col_Keyword column contains the "hangzhou" prefix in a table. 
 */
func PrefixQuery(client *tablestore.TableStoreClient, tableName string, indexName string) {
    searchRequest := &tablestore.SearchRequest{}
    searchRequest.SetTableName(tableName)
    searchRequest.SetIndexName(indexName)
    query := &search.PrefixQuery{} // Set the query type to PrefixQuery. 
    query.FieldName = "Col_Keyword" // Specify the name of the field that you want to match. 
    query.Prefix = "hangzhou" // Specify the prefix that is used to match the value of the column. 
    searchQuery := search.NewSearchQuery()
    searchQuery.SetQuery(query)
    searchQuery.SetGetTotalCount(true)
    searchRequest.SetSearchQuery(searchQuery)
    // Return all columns in the rows that meet the query conditions. 
    searchRequest.SetColumnsToGet(&tablestore.ColumnsToGet{
        ReturnAll:true,
    })
    searchResponse, err := client.Search(searchRequest)
    if err != nil {
        fmt.Printf("%#v", err)
        return
    }
    fmt.Println("IsAllSuccess: ", searchResponse.IsAllSuccess) // Check whether all rows that meet the query conditions are returned. 
    fmt.Println("TotalCount: ", searchResponse.TotalCount) // Display the total number of rows that meet the query conditions instead of the number of returned rows. 
    fmt.Println("RowCount: ", len(searchResponse.Rows))
    for _, row := range searchResponse.Rows {
        jsonBody, err := json.Marshal(row)
        if err != nil {
            panic(err)
        }
        fmt.Println("Row: ", string(jsonBody))
    }
}

Perguntas frequentes

Referências

Ao usar um índice de pesquisa, utilize os seguintes métodos de consulta: consulta de termo, consulta de termos, consulta match all, consulta match, consulta match phrase, consulta de prefixo, consulta de intervalo, consulta curinga, consulta geográfica, consulta booleana, consulta vetorial KNN, consulta aninhada e consulta exists. Esses métodos permitem consultar dados em múltiplas dimensões conforme as necessidades do seu negócio.

Ordene ou pagine as linhas correspondentes às condições da consulta usando os recursos de classificação e paginação. Para mais informações, consulte Classificação e paginação.

Use o recurso de colapso (distinto) para agrupar o conjunto de resultados com base em uma coluna específica. Assim, os dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Para mais informações, consulte Colapso (deduplicação).
Para analisar dados em uma tabela, use o recurso de agregação da operação Search ou execute instruções SQL. É possível obter valores mínimos e máximos, somas e o número total de linhas. Para mais informações, consulte Agregação e Consulta SQL.
Para obter todas as linhas correspondentes às condições da consulta sem ordenação, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Executar uma varredura paralela.