Tablestore:Effectuer une 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 des index de recherche.

Paramètres

Exemple

L'exemple de code suivant montre comment interroger les lignes dont la valeur de la colonne Keyword_type_col correspond à « Search* » dans une table.

/// <summary>
/// Query the rows in which the value of the Keyword_type_col column matches "Search*" in a table. 
/// </summary>
/// <param name="otsClient"></param>
public static void WildcardQuery(OTSClient otsClient)
{
    var searchQuery = new SearchQuery();
    // Set the query type to WildcardQuery and specify a string that contains one or more wildcard characters to perform a wildcard query. 
    searchQuery.Query = new WildcardQuery(Keyword_type_col, "*Search*");
    // Return the total number of rows that meet the query conditions. 
    searchQuery.GetTotalCount = true;
    var request = new SearchRequest(TableName, IndexName, searchQuery);
    // You can specify the ColumnsToGet parameter to return the columns that you specify, all columns in the rows that meet the query conditions, or all columns in the search index. If you do not specify this parameter, only the primary key columns are returned. 
    request.ColumnsToGet = new ColumnsToGet()
    {
        // Return all columns in the search index. 
        ReturnAllFromIndex = true
        // Return the columns that you specify. 
        //Columns = new List<string>() { Long_type_col, Text_type_col, Keyword_type_col }
        // Return all columns in the rows that meet the query conditions. 
        //ReturnAll = true
    };

    var response = otsClient.Search(request);

    Console.WriteLine("Total Count:" + response.TotalCount); // Display the total number of rows that meet the query conditions instead of the number of returned rows. 
}

FAQ

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

• 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 ?

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

Références

• Lorsque vous utilisez un index de recherche pour interroger des données, vous pouvez recourir aux méthodes de requête suivantes : 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 wildcard, requête booléenne, requête geo, requête nested et requête exists. Vous pouvez utiliser différentes méthodes de requête pour interroger des données selon plusieurs dimensions en fonction de vos besoins métier.

  Triez ou paginez les lignes correspondant aux conditions de requête à l'aide des fonctionnalités de tri et de pagination. Pour plus d'informations, consultez la rubrique Tri et pagination.

  Utilisez la fonctionnalité de collapse (distinct) pour regrouper l'ensemble de résultats en fonction d'une colonne spécifique. 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 la rubrique Collapse (distinct).

• Pour analyser les données d'une table de données, utilisez la fonctionnalité d'agrégation de l'opération Search ou exécutez des instructions SQL. Par exemple, vous pouvez obtenir les valeurs minimales et maximales, la somme et le nombre total de lignes. Pour plus d'informations, consultez les rubriques Agrégation et Requête SQL.

• Pour obtenir toutes les lignes correspondant aux conditions de requête sans avoir besoin de les trier, appelez les opérations ParallelScan et ComputeSplits afin d'utiliser la fonctionnalité de balayage parallèle. Pour plus d'informations, consultez la rubrique Balayage parallèle.