Tablestore:Requête de plage

Prérequis

• Initialisez une instance OTSClient. Pour plus d'informations, consultez Initialiser une instance OTSClient.

• Créez un tableau de données et écrivez-y des données. Pour plus d'informations, consultez Créer un tableau de données et Écrire des données.

• Créez un index de recherche pour le tableau de données. Pour plus d'informations, consultez Créer des index de recherche.

Paramètres

Exemple de code

L'exemple de code suivant montre comment interroger les lignes dont la valeur de Col_Long est supérieure à 3. Tablestore trie les résultats de la requête en fonction de la valeur de la colonne Col_Long par ordre décroissant.

/**
 * Query the rows in which the value of the Col_Long column is greater than 3 in a table. Tablestore sorts the query results based on the value of the Col_Long column in descending order. 
 */
func RangeQuery(client *tablestore.TableStoreClient, tableName string, indexName string) {
    searchRequest := &tablestore.SearchRequest{}
    searchRequest.SetTableName(tableName)
    searchRequest.SetIndexName(indexName)
    searchQuery := search.NewSearchQuery()
    rangeQuery := &search.RangeQuery{} // Set the query type to RangeQuery. 
    rangeQuery.FieldName = "Col_Long" // Specify the name of the column that you want to query.
    rangeQuery.GT(3) // Specify the range of the column value, which is greater than 3. 
    searchQuery.SetQuery(rangeQuery)
    // Sort the query results based on the value of the Col_Long column in descending order. 
    searchQuery.SetSort(&search.Sort{
        []search.Sorter{
            &search.FieldSort{
                FieldName: "Col_Long",
                Order:     search.SortOrder_DESC.Enum(),
            },
        },
    })
    searchRequest.SetSearchQuery(searchQuery)
    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("RowCount: ", len(searchResponse.Rows))
    for _, row := range searchResponse.Rows {
        jsonBody, err := json.Marshal(row)
        if err != nil {
            panic(err)
        }
        fmt.Println("Row: ", string(jsonBody))
    }
}

FAQ

• Que faire si aucune donnée n'est trouvée lors de l'appel de l'opération Search pour les index de recherche ?

• Comment augmenter la valeur du paramètre limit à 1000 lors de l'appel de l'opération Search de la fonctionnalité d'index de recherche pour interroger des données ?

• Pourquoi un jeton devient-il invalide lors d'une requête paginée dans Search Index ?

Références

• Lorsque vous utilisez un index de recherche pour interroger des données, vous pouvez recourir aux méthodes de requête suivantes : requête de terme, requête de termes, requête match all, requête de correspondance, requête de correspondance de phrase, requête de préfixe, requête de plage, requête avec caractère générique, requête géographique, requête booléenne, requête vectorielle KNN, requête imbriquée et requête exists. Utilisez ces méthodes pour interroger des données selon plusieurs dimensions en fonction de vos besoins métier.

  Triez ou paginez les lignes satisfaisant aux conditions de la requête grâce aux fonctionnalités de tri et de pagination. Pour plus d'informations, consultez Tri et pagination.

  Utilisez la fonctionnalité de regroupement (distinct) pour regrouper l'ensemble de résultats en fonction d'une colonne spécifique. Ainsi, les données du type spécifié n'apparaissent qu'une seule fois dans les résultats de la requête. Pour plus d'informations, consultez Regroupement (déduplication).

• Pour analyser les données d'un tableau de données, utilisez la fonctionnalité d'agrégation de l'opération Search ou exécutez des instructions SQL. Par exemple, vous pouvez obtenir les valeurs minimales et maximales, la somme et le nombre total de lignes. Pour plus d'informations, consultez Agrégation et Requête SQL.

• Pour obtenir toutes les lignes satisfaisant aux conditions de la requête sans avoir besoin de les trier, appelez les opérations ParallelScan et ComputeSplits afin d'utiliser la fonctionnalité de balayage parallèle. Pour plus d'informations, consultez Effectuer un balayage parallèle.