Utilisez une requête de terme pour interroger les données correspondant exactement à la valeur spécifiée d'un champ. Les requêtes de terme s'apparentent aux requêtes basées sur des conditions de correspondance de chaînes. Si le type de la colonne est TEXT, Tablestore tokenize la chaîne et utilise les jetons pour faire correspondre le mot-clé. Une ligne satisfait aux conditions de la requête lorsqu'au moins un des jetons de la ligne correspond exactement au mot-clé. Le mot-clé utilisé pour la correspondance lors d'une requête de terme n'est pas tokenisé.
Prérequis
Initialisez une instance OTSClient. Pour plus d'informations, consultez Initialiser une instance OTSClient.
Créez une table de données et écrivez-y des données. Pour plus d'informations, consultez Créer des tables de données et Écrire des données.
Créez un index de recherche pour la table de données. Pour plus d'informations, consultez Créer un index de recherche.
Paramètres
|
Paramètre |
Description |
|
tableName |
Nom de la table de données. |
|
indexName |
Nom de l'index de recherche. |
|
offset |
Position à partir de laquelle la requête actuelle commence. |
|
limit |
Nombre maximal de lignes que la requête actuelle doit renvoyer. Pour interroger uniquement le nombre de lignes satisfaisant aux conditions de la requête sans obtenir les données spécifiques, définissez le paramètre limit sur 0. |
|
queryType |
Type de requête. Définissez ce paramètre sur TableStore.QueryType.TERM_QUERY. |
|
fieldName |
Nom de la colonne à interroger. |
|
term |
Mot-clé utilisé pour faire correspondre la valeur de la colonne lors d'une requête de terme. Ce mot n'est pas tokenisé. Le mot entier sert à la correspondance avec la valeur de la colonne. Si le type de la colonne est TEXT, Tablestore tokenize la chaîne et utilise les jetons pour faire correspondre le mot-clé. Une ligne satisfait aux conditions de la requête lorsqu'au moins un des jetons de la ligne correspond exactement au mot-clé. Par exemple, si la valeur d'une colonne de type TEXT dans une ligne est « tablestore is cool », la valeur peut être tokenisée en « tablestore », « is » et « cool ». La ligne satisfait aux conditions de la requête si vous spécifiez « tablestore », « is » ou « cool » comme mot-clé pour la correspondance. |
|
getTotalCount |
Indique s'il faut renvoyer le nombre total de lignes satisfaisant aux conditions de la requête. La valeur par défaut est false, ce qui signifie que le nombre total de lignes n'est pas renvoyé. La définition de ce paramètre sur true dégrade les performances de la requête. |
|
columnToGet |
Indique s'il faut renvoyer toutes les colonnes de chaque ligne satisfaisant aux conditions de la requête. Vous pouvez configurer les champs returnType et returnNames pour ce paramètre.
|
Exemple
L'exemple de code suivant montre comment interroger les lignes dont la valeur de la colonne Col_Keyword correspond exactement à « hangzhou » :
/**
* Search the table for rows in which the value of Col_Keyword exactly matches "hangzhou".
*/
client.search({
tableName: TABLE_NAME,
indexName: INDEX_NAME,
searchQuery: {
offset: 0,
limit: 10, // To query only the number of rows that meet the query conditions without specific data, set the limit parameter to 0.
query: { // Set the query type to TableStore.QueryType.TERM_QUERY.
queryType: TableStore.QueryType.TERM_QUERY,
query: {
fieldName: "Col_Keyword",
term: "hangzhou"
}
},
getTotalCount: true // Specify whether to return the total number of rows that meet the query conditions. The default value of this parameter is false, which specifies that the total number of rows that meet the query conditions is not returned.
},
columnToGet: { // Specify the columns that you want to return. You can set the parameter to RETURN_SPECIFIED to return specific columns, RETURN_ALL to return all columns, RETURN_ALL_FROM_INDEX to return all columns in the search index, or RETURN_NONE to return only the primary key columns.
returnType: TableStore.ColumnReturnType.RETURN_ALL
}
}, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', JSON.stringify(data, null, 2));
});FAQ
FAQ
Références
-
Les index de recherche prennent en charge les types de requêtes suivants : requête de terme, requête de termes, requête match all, requête de correspondance, requête de correspondance de phrase, requête de préfixe, requête de plage, requête avec caractères génériques, requête booléenne, requête géographique, requête imbriquée, requête vectorielle, et requête exists. Sélectionnez un type de requête adapté à vos besoins métier.
Pour trier ou paginer les lignes satisfaisant aux conditions de la requête, utilisez la fonctionnalité de tri et de pagination. Pour plus d'informations, consultez Tri et pagination.
Pour regrouper l'ensemble de résultats en fonction d'une colonne spécifique, utilisez la fonctionnalité de regroupement (distinct). Ainsi, les données du type spécifié n'apparaissent qu'une seule fois dans les résultats de la requête. Pour plus d'informations, consultez Regroupement (distinct).
Pour analyser les données d'une table de données, par exemple pour obtenir les valeurs extrêmes, la somme et le nombre total de lignes, effectuez des opérations d'agrégation ou exécutez des instructions SQL. Pour plus d'informations, consultez Agrégation et Requête SQL.
Pour obtenir rapidement toutes les lignes satisfaisant aux conditions de la requête sans tri, appelez les opérations ParallelScan et ComputeSplits afin d'utiliser la fonctionnalité d'analyse parallèle. Pour plus d'informations, consultez Analyse parallèle.