Terms query - Tablestore - Centre de documentation Alibaba Cloud

Une requête Terms est similaire à une requête Term. Elle prend en charge plusieurs mots-clés. Une ligne de données est renvoyée lorsque la valeur de la colonne correspond à au moins l'un des mots-clés. Les requêtes Terms s'utilisent comme l'opérateur IN dans les instructions SQL.

Opération API

Appelez l'opération Search ou ParallelScan et définissez le type de requête sur TermsQuery pour exécuter une requête Terms.

Paramètres

Paramètre	Description
query	Type de requête. Définissez ce paramètre sur TermsQuery.
fieldName	Nom du champ à faire correspondre.
terms	Termes de recherche à faire correspondre. Vous pouvez spécifier jusqu'à 1 024 termes. Une ligne de données est renvoyée lorsque la valeur de la colonne correspond à au moins l'un des mots-clés.
getTotalCount	Indique si le nombre total de lignes répondant 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 se dégradent.
weight	Poids à attribuer au champ interrogé pour calculer le score de pertinence des mots-clés basé sur BM25. Ce paramètre s'utilise dans les scénarios de recherche en texte intégral. Plus le poids spécifié pour le champ est élevé, plus le score de pertinence basé sur BM25 l'est également. La valeur doit être un nombre à virgule flottante positif. Ce paramètre n'affecte pas le nombre de lignes renvoyées, mais influence les scores de pertinence basés sur BM25 des résultats.
tableName	Nom de la table de données.
indexName	Nom de l'index de recherche.
columnsToGet	Indique si toutes les colonnes de chaque ligne répondant aux conditions de la requête doivent être renvoyées. Vous pouvez spécifier 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 Terms. Avant de commencer, assurez-vous d'avoir effectué les préparatifs suivants :

Vous disposez d'un compte Alibaba Cloud ou d'un utilisateur RAM disposant des autorisations nécessaires pour effectuer des opérations sur Tablestore. Pour plus d'informations sur l'octroi des autorisations d'opération Tablestore à un utilisateur RAM, consultez la rubrique Utiliser une stratégie RAM pour accorder des autorisations à un utilisateur RAM.

Pour utiliser les SDK Tablestore ou l'interface CLI Tablestore, créez une paire AccessKey pour votre compte Alibaba Cloud ou votre utilisateur RAM. Pour plus d'informations, consultez la rubrique Créer une paire AccessKey.
Une table de données a été créée. Pour plus d'informations, consultez la rubrique Opérations sur les tables.
Un index de recherche a été créé pour la table de données. Pour plus d'informations, consultez la rubrique Créer un index de recherche.
Pour utiliser les SDK Tablestore, initialisez une instance OTSClient. Pour plus d'informations, consultez la rubrique Initialiser une instance OTSClient.
Pour utiliser l'interface CLI Tablestore, téléchargez et démarrez l'outil, puis configurez les informations relatives à l'instance à laquelle vous souhaitez accéder. Pour plus d'informations, consultez les rubriques Télécharger l'interface CLI Tablestore et Démarrer l'interface CLI Tablestore et configurer les informations d'accès.

Utiliser la console Tablestore

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. Sur 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.
Sur l'onglet Index Management, localisez l'index de recherche cible et cliquez sur Search dans la colonne Actions.
Dans la boîte de dialogue Search, spécifiez les conditions de 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 qui satisfont à toutes les conditions spécifiées. Si vous sélectionnez Or, la requête renvoie les données qui satisfont à au moins l'une des conditions spécifiées. Si vous sélectionnez Not, la requête renvoie les données qui ne satisfont pas aux conditions spécifiées.
3. Sélectionnez un champ indexé et cliquez sur Add.
4. Définissez le type de requête du champ indexé sur Terms query (TermsQuery), saisissez une valeur, puis cliquez sur Add.
  
  Pour ajouter plusieurs valeurs, répétez la procédure consistant à saisir une Value et à cliquer sur Add.
5. Par défaut, le tri est désactivé. 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. Par défaut, l'agrégation est désactivée. 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.
Cliquez sur OK.

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

Utiliser l'interface CLI Tablestore

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

Exécutez la commande search pour utiliser l'index de recherche search_index afin d'interroger des données et de renvoyer toutes les colonnes indexées de chaque ligne répondant aux conditions de la requête.
```
search -n search_index --return_all_indexed
```

Saisissez les conditions de la requête comme indiqué par le système :

{
    "Offset": -1,
    "Limit": 10,
    "Collapse": null,
    "Sort": null,
    "GetTotalCount": true,
    "Token": null,
    "Query": {
        "Name": "TermsQuery",
        "Query": {
            "FieldName": "col_keyword",
            "Terms": ["hangzhou", "xi'an"]
        }
    }
}

Utiliser les SDK Tablestore

Exécutez une requête Terms à l'aide des SDK Tablestore suivants : SDK Tablestore pour Java, SDK Tablestore pour Go, SDK Tablestore pour Python, SDK Tablestore pour Node.js, SDK Tablestore pour .NET et SDK Tablestore pour PHP. Cet exemple utilise le SDK Tablestore pour Java.

Facturation

L'interrogation de données à l'aide d'un index de recherche consomme du débit de lecture. Pour plus d'informations, consultez la rubrique Mesure et facturation de l'index de recherche.

FAQ

Références

L'index de recherche 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 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.
Lorsque vous interrogez 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.