Interrogation de Couchbase avec MapReduce Views

La fonction map est exécutée une fois sur chaque document. Lorsque la vue est créée, la fonction map est exécutée une fois sur chaque document du compartiment et les résultats sont stockés dans le compartiment.

Une fois la vue créée, la fonction map est exécutée uniquement sur les documents récemment insérés ou mis à jour afin de mettre à jour la vue de manière incrémentielle.

Les résultats de la fonction map étant stockés dans le compartiment de données, les requêtes sur une vue présentent des latences faibles.

Voyons un exemple de fonction map qui crée un index sur le champ name de tous les documents du compartiment dont le champ type est égal à «StudentGrade» :

La fonction emit indique à Couchbase quel (s) champ (s) de données à stocker dans la clé d’index (premier paramètre) et quelle valeur (deuxième paramètre) à associer au document indexé.

Dans ce cas, nous ne stockons que la propriété document name dans la clé d’index. Et comme nous ne souhaitons pas associer une valeur particulière à chaque entrée, nous passons null comme paramètre value.

Lors du traitement de la vue, Couchbase crée un index des clés émises par la fonction map , en associant chaque clé à tous les documents pour lesquels cette clé a été émise.

Par exemple, si trois propriétés ont la propriété name définie sur «John Doe» , la clé d’indexation «John Doe» sera associée à ces trois documents.

La fonction reduce est utilisée pour effectuer des calculs d’agrégat à l’aide des résultats d’une fonction map . L’interface utilisateur administrative de Couchbase offre un moyen simple d’appliquer les fonctions reduce intégrées «nombre », « sum», et « stats» à votre fonction map__.

Vous pouvez également écrire vos propres fonctions reduce pour des agrégations plus complexes. Nous verrons des exemples d’utilisation des fonctions intégrées reduce plus loin dans ce didacticiel.

Les vues sont organisées en un ou plusieurs documents de conception par compartiment. En théorie, le nombre de vues par document de conception est illimité.

Cependant, pour des performances optimales, il a été suggéré de limiter chaque document de conception à moins de dix vues.

Lorsque vous créez une vue dans un document de conception, Couchbase la désigne comme une vue development . Vous pouvez exécuter des requêtes sur une vue development pour tester ses fonctionnalités. Une fois que vous êtes satisfait de la vue, vous publiez le document de conception, et la vue devient une vue production .

Pour construire une requête sur une vue Couchbase, vous devez fournir son nom de document de conception et son nom de vue afin de créer un objet ViewQuery :

Une fois exécutée, cette requête retournera toutes les lignes de la vue. Nous verrons dans les sections suivantes comment restreindre le jeu de résultats en fonction des valeurs de clé.

Pour construire une requête sur une vue de développement, vous pouvez appliquer la méthode development () lors de la création de la requête:

Une fois que nous avons un objet ViewQuery , nous pouvons exécuter la requête pour obtenir un ViewResult :

Et maintenant que nous avons ViewResult , nous pouvons parcourir les lignes pour obtenir les identifiants et/ou le contenu du document:

Pour trouver toutes les notes du cours d’histoire, nous appliquons la méthode key à notre requête de base:

Si vous souhaitez rechercher toutes les notes des cours de mathématiques et de sciences, vous pouvez appliquer la méthode keys à la requête de base en lui transmettant un tableau de valeurs de clé:

Pour rechercher tous les documents avec une plage de valeurs grade , quelle que soit la valeur du champ course , nous avons besoin d’une vue qui n’émet que le champ grade . Écrivons la fonction map pour la vue « findByGrade »:

Écrivons une requête en Java en utilisant cette vue pour trouver toutes les notes équivalentes à une lettre «B» (de 80 à 89 inclus):

Notez que la valeur de la clé de début dans une requête de plage est toujours traitée comme inclusive.

Et si toutes les notes sont connues pour être des entiers, la requête suivante donnera les mêmes résultats:

Pour trouver tous les grades «A» (90 et plus), il suffit de spécifier la limite inférieure:

Et pour trouver toutes les notes d’échec (inférieures à 60), il suffit de spécifier la limite supérieure:

Supposons maintenant que nous voulions trouver tous les étudiants d’un cours spécifique dont les notes se situent dans une certaine plage. Cette requête nécessite une nouvelle vue qui émet les champs course et grade .

Avec les vues multi-champs, chaque clé d’index est émise sous forme de tableau de valeurs.

Comme notre requête implique une valeur fixe pour course et une plage de valeurs grade , nous écrirons la fonction map pour émettre chaque clé sous forme de tableau de la forme[ course , grade ].

Regardons la fonction map pour la vue “ findByCourseAndGrade “:

Lorsque cette vue est renseignée dans Couchbase, les entrées d’index sont triées par course et grade . Voici un sous-ensemble de clés dans la vue « findByCourseAndGrade », présentées dans leur ordre de tri naturel:

Étant donné que les clés de cette vue sont des tableaux, vous utiliseriez également des tableaux de ce format pour spécifier les limites inférieure et supérieure d’une requête d’intervalle par rapport à cette vue.

Cela signifie que pour trouver tous les étudiants ayant obtenu une note «B» (80 à 89) dans le cours de mathématiques, vous devez définir la limite inférieure sur:

et la borne supérieure à:

Écrivons la requête de plage en Java:

Si nous voulons trouver pour tous les étudiants qui ont reçu une note «A» (90 et plus) en mathématiques, alors nous écririons:

Notez que parce que nous fixons la valeur du cours à « Math », nous devons inclure une limite supérieure avec la valeur grade la plus élevée possible.

Sinon, notre ensemble de résultats inclurait également tous les documents dont la valeur de course est lexicographiquement supérieure à « Math ».

Et pour trouver tous les échecs en mathématiques (moins de 60):

Comme dans l’exemple précédent, nous devons spécifier une limite inférieure avec la note la plus basse possible. Sinon, notre ensemble de résultats inclurait également toutes les notes où la valeur de course est lexicographiquement inférieure à «Math **

Enfin, pour trouver les cinq notes mathématiques les plus élevées (sauf les égalités), vous pouvez demander à Couchbase d’effectuer un tri décroissant et de limiter la taille de l’ensemble de résultats:

Notez que lorsque vous effectuez un tri décroissant, les valeurs startKey et endKey sont inversées, car Couchbase applique le tri avant d’appliquer le limit .

Commençons par écrire la fonction map pour qu’une vue compte le nombre d’étudiants dans chaque cours:

Nous appellerons cette vue « countStudentsByCourse » et indiquerons qu’elle utilisera la fonction intégrée « count» . Et comme nous n’effectuons qu’un simple compte, nous pouvons toujours émettre null comme valeur pour chaque entrée.

Pour compter le nombre d’étudiants dans chaque cours:

L’extraction de données à partir de requêtes agrégées diffère de ce que nous avons vu jusqu’à présent. Au lieu d’extraire un document Couchbase correspondant pour chaque ligne du résultat, nous extrayons les clés d’agrégation et les résultats.

Exécutons la requête et extrayons les comptes dans un fichier java.util.Map :

Ensuite, écrivons une vue calculant la somme des heures de crédit tentées par chaque élève. Nous appellerons cette vue « sumHoursByStudent » et indiquerons qu’elle utilisera la fonction intégrée « sum» __:

Notez que lors de l’application de la fonction “ sum” , nous devons émettre__ la valeur à additionner - dans ce cas, le nombre de crédits - pour chaque entrée.

Ecrivez une requête pour trouver le nombre total de crédits pour chaque étudiant:

Et maintenant, exécutons la requête et extrayons les sommes agrégées dans un fichier java.util.Map :

Supposons que nous voulions calculer la moyenne pondérée cumulative de chaque élève pour tous les cours, en utilisant l’échelle conventionnelle en fonction des notes obtenues et du nombre d’heures de crédit valorisées par le cours (A = 4 points par heure d’heures de crédit, B = 3 points par heure de crédit, C = 2 points par heure de crédit et D = 1 point par heure de crédit).

Il n’existe pas de fonction intégrée reduce permettant de calculer les valeurs moyennes. Nous allons donc combiner les résultats de deux vues pour calculer le GPA.

Nous avons déjà la vue «sumHoursByStudent» qui résume le nombre d’heures-crédits que chaque étudiant a tenté. Nous avons maintenant besoin du nombre total de points obtenus par chaque élève.

Créons une vue appelée «sumGradePointsByStudent», qui calcule le nombre de points obtenus pour chaque cours suivi. Nous allons utiliser la fonction intégrée “ sum” pour réduire la fonction map__ suivante:

Examinons maintenant cette vue et extrayons les sommes dans un fichier java.util.Map :

Enfin, combinons les deux _Map _ afin de calculer la moyenne cumulative pour chaque élève: