Exécutez une requête de plage pour interroger des données situées dans une plage spécifiée. Si le champ à interroger est de type TEXT, ses valeurs sont tokenisées. Une ligne satisfait les conditions de la requête lorsqu'au moins un de ses jetons correspond à la plage définie.
Opération API
Pour effectuer une requête de plage, appelez l'opération Search ou ParallelScan et définissez le type de requête sur RangeQuery.
Paramètres
Paramètre | Description |
fieldName | Nom du champ à faire correspondre. |
from | Valeur de début de la plage de recherche. Lorsque vous spécifiez des conditions de plage, utilisez greaterThan pour indiquer le signe supérieur strict (>) et greaterThanOrEqual pour indiquer le signe supérieur ou égal (≥). |
to | Valeur de fin de la plage de recherche. Lorsque vous spécifiez des conditions de plage, utilisez lessThan pour indiquer le signe inférieur strict (<) et lessThanOrEqual pour indiquer le signe inférieur ou égal (≤). |
includeLower | Indique si la valeur du paramètre from doit être incluse dans la réponse. Type : BOOLEAN. |
includeUpper | Indique si la valeur du paramètre to doit être incluse dans la réponse. Type : BOOLEAN. |
query | Type de requête. Définissez ce paramètre sur RangeQuery. |
sort | Méthode de tri. Pour plus d'informations, consultez la section Tri et pagination. |
getTotalCount | Indique si le nombre total de lignes correspondant aux conditions de la requête doit être renvoyé. La valeur par défaut est false, ce qui signifie que le nombre total n'est pas renvoyé. Si vous définissez ce paramètre sur true, les performances de la requête peuvent être dégradées. |
tableName | Nom de la table de données. |
indexName | Nom de l'index de recherche. |
columnsToGet | Indique si toutes les colonnes des lignes correspondant aux conditions de la requête doivent être renvoyées. Vous pouvez configurer les champs returnAll et columns pour ce paramètre. La valeur par défaut du champ returnAll est false, ce qui signifie que toutes les colonnes ne sont pas renvoyées. Dans ce cas, utilisez le champ columns pour spécifier les colonnes à renvoyer. Si vous ne spécifiez aucune colonne, seules les colonnes de clé primaire sont renvoyées. Si vous définissez le champ returnAll sur true, toutes les colonnes sont renvoyées. |
Méthodes
Utilisez la console Tablestore, l'interface CLI Tablestore ou les SDK Tablestore pour exécuter une requête de plage. Avant de commencer, assurez-vous d'avoir effectué les préparatifs suivants :
-
Utilisez un compte Alibaba Cloud ou un utilisateur RAM disposant des autorisations nécessaires pour les opérations Table Store. Pour accorder des autorisations à un utilisateur RAM, consultez la section Accorder des autorisations à un utilisateur RAM via une stratégie RAM.
Si vous utilisez un SDK ou un outil en ligne de commande, créez une AccessKey pour votre compte Alibaba Cloud ou votre utilisateur RAM si vous n'en possédez pas déjà une.
Créez un Search Index pour la table de données.
Si vous utilisez un SDK, initialisez le client Tablestore.
Si vous utilisez l'outil en ligne de commande, téléchargez et démarrez l'outil, puis configurez la connexion à votre instance et sélectionnez la table cible. Pour plus d'informations, consultez les sections Télécharger l'outil en ligne de commande, Démarrer l'outil et configurer les informations de connexion et Opérations sur les tables de données.
Facturation
L'interrogation de données à l'aide d'un Search Index consomme du débit de lecture. Pour plus d'informations, consultez la section Mesure et facturation de Search Index.
FAQ
Références
Search Index prend en charge divers types de requêtes pour les interrogations de données multidimensionnelles, notamment la requête term, la requête terms, la requête match all, la requête match, la requête phrase match, la requête de plage, la requête prefix, la requête suffix, la requête wildcard, la requête token-based wildcard, la requête boolean, la requête geo, la requête nested, la recherche vectorielle, et la requête exists.
Lors de l'interrogation des données, vous pouvez trier et paginer l'ensemble de résultats ou effectuer un pliage (déduplication).
Pour l'analyse des données, telle que la recherche de la valeur maximale ou minimale, le calcul d'une somme ou le comptage des lignes, vous pouvez utiliser les fonctionnalités d'agrégation statistique ou de requête SQL.
Pour exporter rapidement des données indépendamment de l'ordre de l'ensemble de résultats, vous pouvez utiliser la fonctionnalité Parallel Scan.