La requête MatchAllQuery permet de sélectionner toutes les lignes d'une table. Utilisez-la pour obtenir le nombre total de lignes ou pour renvoyer un échantillon aléatoire de lignes.
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
|
Paramètre |
Description |
|
Query |
Type de requête. Définissez ce paramètre sur MatchAllQuery. |
|
TableName |
Nom de la table de données. |
|
IndexName |
Nom de l'index de recherche. |
|
Limit |
Nombre maximal de lignes à renvoyer par la requête actuelle. Pour obtenir uniquement le nombre de lignes correspondant aux conditions de requête sans récupérer les données, définissez ce paramètre sur 0. |
|
GetTotalCount |
Indique si le nombre total de lignes correspondant aux conditions de requête doit être renvoyé. La valeur par défaut est false, ce qui signifie que le nombre total de lignes n'est pas renvoyé. Définir ce paramètre sur true dégrade les performances de la requête. |
|
ColumnsToGet |
Indique si toutes les colonnes des lignes correspondant aux conditions de requête doivent être renvoyées. Vous pouvez spécifier les paramètres ReturnAll, Columns et ReturnAllFromIndex. Par défaut,
Définissez |
Exemple
L'exemple de code suivant montre comment obtenir le nombre total de lignes d'une table.
/// <summary>
/// Perform a match all query to query the total number of rows in a table.
/// </summary>
/// <param name="otsClient"></param>
public static void MatchAllQuery(OTSClient otsClient)
{
var searchQuery = new SearchQuery();
searchQuery.Query = new MatchAllQuery();
searchQuery.GetTotalCount = true; // Set the GetTotalCount parameter to true to return the total number of rows that meet the query conditions.
/*
* In the result of a match all query, the value of the TotalCount parameter indicates the total number of rows in the table.
* To query only the number of rows that meet the query conditions without specific data, set the Limit parameter to 0.
*/
searchQuery.Limit = 0;
var request = new SearchRequest(TableName, IndexName, searchQuery);
var response = otsClient.Search(request);
// Check whether all rows that meet the query conditions are returned. If the value of the isAllSuccess parameter is false, Tablestore may fail to query data on some servers, and not all rows that meet the query conditions are returned.
Console.WriteLine("IsAllSuccess:" + response.IsAllSuccess);
Console.WriteLine("Total Count:" + response.TotalCount);
}FAQ
Comment interroger le nombre total de lignes dans une table ?
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 MatchAllQuery, requête Match, requête MatchPhrase, requête Prefix, requête Range, requête Wildcard, requête Bool, requête Geo, requête Nested et requête Exists. Vous pouvez combiner ces méthodes pour interroger les données selon plusieurs dimensions en fonction de vos besoins métier.
Vous pouvez trier ou paginer les lignes correspondant aux conditions de requête grâce aux fonctionnalités de tri et de pagination. Pour plus d'informations, consultez la rubrique Tri et pagination.
La fonctionnalité de regroupement (distinct) permet de condenser l'ensemble des 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 Regroupement (distinct).
Pour analyser les données d'une table, 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 ainsi que 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.