Tablestore:Requête par terme

Notes d'utilisation

• Pour les types de champs non textuels tels que Keyword et Integer, la valeur du champ doit correspondre exactement au terme de la requête.

• Évitez d'utiliser une requête par terme sur les champs Text, car leur tokenisation est imprévisible et peut évoluer avec le temps. Une requête par terme sur un champ Text vérifie si l'un des jetons produits par l'analyseur correspond exactement au terme de la requête. Le terme de la requête lui-même n'est pas tokenisé. Pour faire correspondre une valeur entière non tokenisée, utilisez une colonne virtuelle afin de mapper le champ au type Keyword avant d'exécuter la requête. Par exemple, si un champ Text contenant la valeur « tablestore is cool » est tokenisé en « tablestore », « is » et « cool », une recherche portant sur « tablestore », « is » ou « cool » renverra une correspondance.

Procédure

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, repérez 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 ne retourner que certaines colonnes, 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 qui satisfont à toutes les conditions spécifiées. Si vous choisissez Or, elle retourne les données répondant à au moins l'une des conditions indiquées. Enfin, si vous optez pour Not, la requête renvoie les données qui ne satisfont pas aux conditions spécifiées.

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

   4. Définissez le type de requête du champ d'index sur Term Query (TermQuery) et saisissez la valeur à rechercher.

   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 donné, 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.

Intégration au développement

Vous pouvez utiliser un SDK ou un outil en ligne de commande pour exécuter une requête par terme.

• SDK : Java, Go, Python, Node.js, .NET, PHP

• Outil en ligne de commande

Facturation

L'interrogation des données via un index de recherche consomme du débit de lecture. Pour en savoir plus, reportez-vous à la section Mesure et facturation de l'index de recherche.

FAQ

• Pourquoi ne puis-je pas trouver de données lorsque j'appelle l'API Search de l'index de recherche ?

• Comment augmenter la limite d'un appel API Search à 1 000 ?

• Pourquoi le jeton expire-t-il lors de la pagination des résultats de requête via l'index de recherche ?

Documents connexes

• L'index de recherche prend en charge divers types de requêtes pour l'interrogation multidimensionnelle des données, notamment la requête par terme, la requête par termes, la requête match all, la requête de correspondance, la requête de correspondance de phrase, la requête de plage, la requête de préfixe, la requête de suffixe, la requête avec caractères génériques, la requête avec caractères génériques basée sur les jetons, la requête booléenne, la requête géographique, la requête imbriquée, la recherche vectorielle, ainsi que la requête exists.

• Lors de l'interrogation des données, vous avez la possibilité de trier et paginer l'ensemble des résultats ou d'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 exploiter les fonctionnalités d'agrégation statistique ou de requête SQL.

• Afin d'exporter rapidement les données indépendamment de l'ordre de l'ensemble de résultats, utilisez la fonctionnalité Parallel Scan.