Tablestore:Requête avec caractères génériques

Prérequis

• Initialisez une instance OTSClient. Pour plus d'informations, consultez la rubrique Initialiser une instance OTSClient.

• Créez une table de données et écrivez-y des données. Pour plus d'informations, consultez les rubriques 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 la rubrique Créer un index de recherche.

Paramètres

Exemples

L'exemple de code suivant recherche les lignes dont la valeur de Col_Keyword correspond à la chaîne « table*e ».

/**
 * Search the table for rows in which the value of Col_Keyword matches "table*e". 
 */
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 returning specific data, you can set limit to 0. This way, Tablestore returns the number of rows that meet the query conditions without specific data from the table. 
        query: { // Set the query type to TableStore.QueryType.WILDCARD_QUERY. 
            queryType: TableStore.QueryType.WILDCARD_QUERY,
            query: {
                fieldName: "Col_Keyword",
                value: "table*e" // Specify a string that contains one or more wildcard characters in a wildcard query. 
            }
        },
        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 indicates 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 specified 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

• [Que faire si l'exception « length of field value is longer than 32 for the [WILDCARD_QUERY] query » se produit lors de l'interrogation des données à l'aide d'une requête avec caractères génériques ?](t1914484.xdita#)Que faire si l'erreur « length of field value is longer than 32 for the [WILDCARD_QUERY] query » survient lors de l'utilisation d'une requête avec caractères génériques ?

• Que faire si aucune donnée n'est trouvée lors de l'appel de l'opération Search ?

• Comment augmenter la valeur du paramètre limit à 1000 lors de l'appel de l'opération Search de la fonctionnalité d'index de recherche pour interroger les données ?

• Pourquoi un jeton devient-il invalide lors de l'utilisation de la pagination dans une requête basée sur un index de recherche ?

Références

• Les index de recherche prennent en charge les types de requête suivants : requête term, requête terms, requête match all, requête match, requête match phrase, requête prefix, requête range, requête avec caractères génériques, requête booléenne, requête geo, requête nested, requête vector et requête exists. Sélectionnez le type de requête adapté à vos besoins métier.

  Pour trier ou paginer les lignes répondant aux conditions de requête, utilisez la fonctionnalité de tri et de pagination. Pour plus d'informations, consultez la rubrique Tri et pagination.

  Pour regrouper l'ensemble de résultats selon 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. Pour plus d'informations, consultez la rubrique Regroupement (distinct).

• Pour analyser les données d'une table de données (valeurs extrêmes, somme, nombre total de lignes, etc.), effectuez des opérations d'agrégation ou exécutez des instructions SQL. Pour plus d'informations, consultez les rubriques Agrégation et Requête SQL.

• Pour obtenir rapidement toutes les lignes répondant aux conditions de 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 la rubrique Analyse parallèle.