Une requête de cadre géographique vous permet de spécifier une zone rectangulaire comme condition de recherche. Tablestore renvoie les lignes dont la valeur du champ spécifié se situe dans cette zone rectangulaire.
Opérations API
Définissez le type de requête sur GeoBoundingBoxQuery dans l'opération Search ou ParallelScan pour exécuter des requêtes de cadre géographique.
Paramètres
|
Paramètre |
Description |
|
fieldName |
Nom de la colonne à interroger. La valeur de ce paramètre doit être de type GEOPOINT. |
|
topLeft |
Paire de coordonnées du coin supérieur gauche de la zone géographique rectangulaire. |
|
bottomRight |
Paire de coordonnées du coin inférieur droit de la zone géographique rectangulaire. Une zone rectangulaire est définie par son coin supérieur gauche et son coin inférieur droit. Le format est |
|
query |
Instruction de requête pour l'index de recherche. Définissez ce paramètre sur GeoBoundingBoxQuery. |
|
getTotalCount |
Indique si le nombre total de lignes correspondant aux conditions de 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 seront réduites. |
|
tableName |
Nom de la table de données. |
|
indexName |
Nom de l'index de recherche. |
|
columnsToGet |
Spécifie si toutes les colonnes de chaque ligne correspondant aux conditions de 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
Exécutez des requêtes de cadre géographique via la console Tablestore, l'interface CLI Tablestore et les SDK Tablestore. Avant de commencer, assurez-vous que les prérequis suivants sont remplis :
-
Utilisez un compte Alibaba Cloud ou un utilisateur RAM disposant des permissions nécessaires pour les opérations Table Store. Pour accorder des permissions à un utilisateur RAM, consultez la rubrique Accorder des permissions à 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.
Vous avez créé une table de données.
Un Index de recherche a été créé 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 lancez l'outil, puis configurez la connexion à votre instance et sélectionnez la table cible. Pour plus d'informations, consultez les rubriques 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 via un index de recherche consomme du débit de lecture. Pour plus d'informations, consultez la rubrique Mesure et facturation des index de recherche.
FAQ
Références
L'index de recherche prend en charge divers types de requêtes pour l'interrogation multidimensionnelle des données, 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 range, 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 valeurs maximales ou minimales, le calcul d'une somme ou le comptage de lignes, vous pouvez utiliser les fonctionnalités d'agrégation statistique ou de requête SQL.
Pour exporter rapidement des données sans tenir compte de l'ordre de l'ensemble de résultats, vous pouvez utiliser la fonctionnalité Parallel Scan.