Tous les produits
Search
Centre de documentation

Tablestore:Requête de cadre géographique (geo-bounding box)

Dernière mise à jour :Aug 18, 2026

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 latitude,longitude. Valeurs valides pour la latitude : [-90,+90]. Valeurs valides pour la longitude : [-180,+180]. Exemple : 35,8,-45,91.

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 :

Utiliser la console Tablestore

  1. Accédez à l'onglet Index Management.

    1. Connectez-vous à la console Table Store.

    2. Dans la barre de navigation supérieure, sélectionnez un groupe de ressources et une région.

    3. Sur la page Overview, cliquez sur le nom de l'instance ou sur Instance Management dans la colonne Actions.

    4. Sous l'onglet Instance Details, dans l'onglet Data Table List, cliquez sur le nom de la table de données ou sur Index Management dans la colonne Actions.

  2. Sous l'onglet Index Management, localisez l'index de recherche cible et cliquez sur Search dans la colonne Actions.

  3. Dans la boîte de dialogue Search, configurez la requête.

    1. Par défaut, toutes les colonnes sont renvoyées. Pour renvoyer des colonnes spécifiques, désactivez l'option Retrieve All Columns et saisissez les noms des colonnes séparés par des virgules.

      Remarque

      Par défaut, Table Store renvoie les colonnes de clé primaire de la table de données.

    2. Sélectionnez un opérateur logique : And, Or ou Not.

      Si vous sélectionnez And, la requête renvoie les données satisfaisant toutes les conditions spécifiées. Si vous sélectionnez Or, la requête renvoie les données satisfaisant au moins l'une des conditions. Si vous sélectionnez Not, la requête renvoie les données ne satisfaisant pas aux conditions spécifiées.

    3. Sélectionnez un champ d'index de type Geopoint et cliquez sur Add.

    4. Définissez le type de requête pour le champ d'index sur GeoBoundingBoxQuery, puis saisissez les coordonnées des coins supérieur gauche et inférieur droit du rectangle.

    5. Le tri est désactivé par défaut. Pour trier les résultats selon un champ spécifique, activez l'option Enable Sorting, ajoutez le champ de tri et configurez l'ordre de tri.

    6. L'agrégation est désactivée par défaut. Pour effectuer une agrégation statistique sur un champ spécifique, activez l'option Enable Aggregation, ajoutez le champ d'agrégation et configurez les paramètres d'agrégation.

  4. Cliquez sur OK.

    Les résultats de la requête s'affichent sous l'onglet Index Management.

Utiliser l'interface CLI Tablestore

Utilisez l'interface CLI Tablestore pour exécuter la commande search afin d'interroger des données à l'aide d'index de recherche. Pour plus d'informations, consultez la rubrique Index de recherche.

  1. Exécutez la commande search pour utiliser l'index de recherche search_index afin d'interroger les données et renvoyer toutes les colonnes indexées de chaque ligne correspondant aux conditions de requête.

    search -n search_index --return_all_indexed
  2. L'exemple de code suivant montre comment saisir les conditions de requête selon les invites du système :

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "GeoBoundingBoxQuery",
            "Query": {
                "FieldName": "col_geopoint",
                "TopLeft": "10,0",
                "BottomRight": "0,10"
            }
        }
    }

Utiliser les SDK Tablestore

Exécutez des requêtes de cadre géographique à l'aide du SDK Tablestore pour Java, du SDK Tablestore pour Go, du SDK Tablestore pour Python, du SDK Tablestore pour Node.js, du SDK Tablestore pour .NET et du SDK Tablestore pour PHP. L'exemple ci-dessous utilise le SDK Tablestore pour Java pour illustrer l'exécution de requêtes de cadre géographique.

GeoBoundingBoxQuery geoBoundingBoxQuery = new GeoBoundingBoxQuery();
geoBoundingBoxQuery.setFieldName("location");
geoBoundingBoxQuery.setTopLeft("2,-1");
geoBoundingBoxQuery.setBottomRight("-1,2");

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(geoBoundingBoxQuery);

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