Tablestore:Requête de plage

1. Accédez à l'onglet Indexes.

   1. Connectez-vous à la console Tablestore.

   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 que vous souhaitez gérer ou cliquez sur Manage Instance dans la colonne Actions de l'instance.

   4. Sur l'onglet Tables de l'onglet Instance Details, cliquez sur le nom de la table de données ou cliquez sur Indexes dans la colonne Actions de la table de données.

2. Sur l'onglet Indexes, localisez l'index de recherche que vous souhaitez utiliser pour interroger les données et cliquez sur Manage Data dans la colonne Actions.

3. Dans la boîte de dialogue Query Data, interrogez les données.

   1. Par défaut, le système renvoie toutes les colonnes d'attribut. Pour renvoyer des colonnes d'attribut spécifiques, désactivez All Columns et spécifiez les colonnes d'attribut que vous souhaitez renvoyer. Séparez plusieurs colonnes d'attribut par des virgules (,).

      Remarque

      Par défaut, le système renvoie toutes les colonnes de clé primaire de la table de données.

   2. Sélectionnez l'opérateur logique And, Or ou Not en fonction de vos besoins métier.

      Si vous sélectionnez l'opérateur logique And, les données répondant aux conditions de requête sont renvoyées. Si vous sélectionnez l'opérateur Or et spécifiez une seule condition de requête, les données répondant à cette condition sont renvoyées. Si vous sélectionnez l'opérateur logique Or et spécifiez plusieurs conditions de requête, les données répondant à l'une des conditions sont renvoyées. Si vous sélectionnez l'opérateur logique Not, les données ne répondant pas aux conditions de requête sont renvoyées.

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

   4. Définissez le type de requête pour le champ d'index sur Range Query (RangeQuery) et spécifiez une plage de requête.

      La plage de requête est un intervalle fermé à gauche et ouvert à droite.

   5. Par défaut, la fonctionnalité de tri est désactivée. Si vous souhaitez trier les résultats de la requête en fonction de champs spécifiques, activez Sort et spécifiez les champs selon lesquels vous souhaitez trier les résultats ainsi que l'ordre de tri.

   6. Par défaut, la fonctionnalité d'agrégation est désactivée. Si vous souhaitez collecter des statistiques sur un champ spécifique, activez Collect Statistics, spécifiez le champ sur lequel vous souhaitez collecter des statistiques, puis configurez les informations nécessaires à la collecte des statistiques.

4. Cliquez sur OK.

   Les données répondant aux conditions de requête s'affichent dans l'ordre spécifié sur l'onglet Indexes.

Exécutez la commande search dans l'interface de ligne de commande pour interroger les données à l'aide d'un index de recherche. Pour plus d'informations, consultez Index de recherche.

1. Exécutez la commande search pour interroger les données de la table à l'aide de l'index de recherche search_index. Cette commande renvoie toutes les colonnes indexées.

   search -n search_index --return_all_indexed

2. Saisissez les conditions de requête comme indiqué par le système. Voici un exemple :

   {
       "Offset": -1,
       "Limit": 10,
       "Collapse": null,
       "Sort": null,
       "GetTotalCount": true,
       "Token": null,
       "Query": {
           "Name": "RangeQuery",
           "Query": {
               "FieldName": "col_long",
               "From": 1,
               "To": 100,
               "IncludeLower": true,
               "IncludeUpper": false
           }
       }
   }

Utilisez un SDK Java, un SDK Go, un SDK Python, un SDK Node.js, un SDK .NET ou un SDK PHP pour exécuter une requête de plage. Cette rubrique utilise le SDK Java comme exemple.

L'exemple suivant interroge les valeurs Long du champ price qui se situent dans l'intervalle semi-ouvert [100, 500). La requête renvoie au maximum 10 lignes et le nombre total de correspondances.

String tableName = "example_table";
String indexName = "example_index";

RangeQuery rangeQuery = new RangeQuery();
rangeQuery.setFieldName("price");
rangeQuery.greaterThanOrEqual(ColumnValue.fromLong(100L));
rangeQuery.lessThan(ColumnValue.fromLong(500L));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(rangeQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());