Découvrez pourquoi Escale et SoNantes ont choisi Elasticsearch comme fondation pour la recherche dans l’annuaire en ligne des adhérents.

<a href="http://www.escaledigitale.com/" target="_blank">Escale</a> est une agence d’innovation web nantaise. Notre activité principale est d’aider startups, PME et grandes entreprises à identifier leurs problématiques et à les résoudre via la réalisation de solutions web. Nous aimons les défis techniques, les projets bienveillants et ambitieux, l’écosystème nantais et les licornes.
Alors quand l’équipe de SoNantes nous a sollicité pour travailler sur un sujet qui reprenait tous ces points (sauf les licornes é_è), nous savions que nous nous embarquions pour un beau projet !
<a href="https://sonantes.fr/" target="_blank">SoNantes</a> est une monnaie complémentaire à l’euro qui vise à accélérer et favoriser les échanges économiques locaux de la région nantaise. L’idée est de permettre aux professionnels d'accroître leur visibilité, de valoriser leur image et d’augmenter leurs fonds de roulement. Les particuliers peuvent, quant à eux, faire leurs achats en SoNantes et s’assurer que l’argent dépensé sera réutilisé dans la région nantaise en favorisant les circuits courts et les commerçants locaux.
Vous l’aurez deviné, la réussite d’un tel projet dépend en grande partie de l’adoption de la monnaie à la fois par les particuliers et les professionnels. Pour favoriser cette traction, SoNantes mise sur la valeur ajoutée d’outils et de services à l’ergonomie soignée gravitant autour de la monnaie. C’est pour la réalisation de l’un de ces outils, l’annuaire, que nous avons collaboré.
<img alt="escale-sonantes-logos.png" data-sys-asset-uid="blt987c7791befe368c" src="https://api.contentstack.io/v2/assets/576d7b6390177aa453928d5e/download?uid=blt987c7791befe368c">
<h2>Un annuaire pour les montrer tous, un annuaire pour les trouver, et dans les bons plans les lier</h2>Nous voilà donc chargés de développer un annuaire des professionnels adhérant à notre monnaie nantaise préférée. Ce projet peut être décomposé en plusieurs modules :
<ul>
	<li>Une API HTTP pour rechercher et obtenir des informations sur les adhérents</li>
	<li>Une API HTTP pour obtenir des informations sur les bons plans proposés par des adhérents</li>
	<li>Un site web qui exploite les mêmes données que ces APIs et permet une visualisation confortable (sur une carte, par exemple)</li>
	<li>Des widgets pouvant être intégrés sur des sites tiers et utilisant les données des APIs</li>
</ul>L’annuaire doit s’insérer dans le système d’information déjà existant. L’interconnexion entre les deux entités est matérialisée par un axccès en lecture-seule à une base de données MySQL qui contient toutes les informations dont nous avons besoin. Nous avons choisi de développer notre applicatif en PHP grâce au framework web <a href="https://laravel.com/" target="_blank">Laravel</a>.
Pour cet article, nous n’allons considérer que le premier module : l’API HTTP de recherche des adhérents. L’annuaire doit permettre de trouver un professionnel en fournissant dans un champ unique des informations pouvant correspondre à plusieurs attributs : nom, commune, catégorie et tags. On veut favoriser certains attributs : si le texte saisi correspond en partie au nom du professionnel pour un résultat donné, ce résultat doit être mieux classé que si la correspondance est sur la commune. On veut aussi obtenir des résultats pertinents même si on fait une faute de frappe. On a donc besoin de fonctionnalités avancées de recherche en plein texte (ou full text search).
L’annuaire doit également pouvoir filtrer les résultats pour ne garder que ceux qui sont géographiquement proches, dans le cas où l’utilisateur s’est géolocalisé et a spécifié un rayon maximum.
Toutes ces contraintes ne pouvant être satisfaites par MySQL seul, nous avons donc décidé de mettre à l’épreuve les fonctionnalités d’<a href="https://www.elastic.co/products/elasticsearch" target="_blank">Elasticsearch</a>&nbsp;!
<img alt="technologies-sonantes.png" data-sys-asset-uid="blt1935d223de1b9828" src="https://api.contentstack.io/v2/assets/576d7b7d049482172d2fada2/download?uid=blt1935d223de1b9828">
<h2>Elasticsearch, l'index pointé vers le futur</h2>Étant donné ce contexte, la faible taille des données (moins de 1 Mo) et leur fréquence de changement occasionnelle, nous avons choisi de conserver MySQL comme stockage maître, et d’introduire Elasticsearch comme un index externe. La base MySQL contient donc les données de référence, et Elasticsearch contient une copie d’une partie de ces données qui lui permet de renvoyer une liste ordonnée d'identifiants lorsqu’on lui soumet une recherche.
Pour garder les données à jour dans Elasticsearch, nous avons développé une tâche qui s’exécute de manière régulière. Cette tâche réalise les opérations suivantes :
<ol>
	<li>Création d’un nouvel index au nom unique</li>
	<li>Envoi à cet index d’un <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping.html" target="_blank">mapping</a> correspondant à nos données</li>
	<li>Récupération des données dans la base MySQL, mise sous la forme d’un document JSON respectant le mapping (on fait correspondre le champ <code>_id</code> du document avec notre clé primaire dans MySQL), et envoi dans l’index</li>
	<li>Mise à jour de l’<a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html" target="_blank">alias</a> nommé <code>sonantes</code> pour qu’il pointe vers le nouvel index&nbsp;</li>
	<li>Suppression de l’ancien index vers lequel pointait l’alias</li>
</ol>
<img alt="sonantes-process.png" data-sys-asset-uid="bltd7de7f496f88583e" src="https://api.contentstack.io/v2/assets/576d7b75049482172d2fad9c/download?uid=bltd7de7f496f88583e">
Le point le plus intéressant dans ce processus est l’utilisation des <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html" target="_blank">alias</a>. Cette fonctionnalité d’Elasticsearch permet d’associer un ou plusieurs noms supplémentaires à un index existant, un peu à la manière d’un lien symbolique Unix. Ainsi, notre application peut utiliser l’alias <code>sonantes</code>, sans avoir besoin de connaître le nom de l’index cible de cet alias. Changer la cible d’un alias est une opération atomique, ce qui offre les avantages suivants :
<ul>
	<li>Si le processus d’indexation échoue, l’alias n’a pas été modifié et pointe toujours vers l’ancien index ;</li>
	<li>Le changement de l’index actif se fait sans période d’indisponibilité.</li>
</ul>Les interactions entre notre application PHP Laravel et Elasticsearch passent par le <a href="https://github.com/elastic/elasticsearch-php" target="_blank">client PHP officiel</a>. Nous utilisons également le paquet <a href="https://github.com/cviebrock/laravel-elasticsearch" target="_blank">laravel-elasticsearch</a> qui fournit une intégration propre du client PHP officiel d’Elasticsearch dans l'environnement de Laravel : cela permet par exemple de configurer les paramètres de connexion à Elasticsearch d’une manière similaire à la configuration des bases de données dans Laravel.
Voici un exemple de code PHP utilisant ces abstractions pour changer la cible de l’alias <code>sonantes</code> :
<pre class="prettyprint">&lt;?php
Elasticsearch::indices()-&gt;updateAliases([
 'body' =&gt; [
 'actions' =&gt; [
 [
 'add' =&gt; [
 'index' =&gt; $newIndex,
 'alias' =&gt; 'sonantes'
 ],
 ],
 [
 'remove' =&gt; [
 'index' =&gt; $oldIndex,
 'alias' =&gt; 'sonantes'
 ]
 ],
 ],
 ],
]);
</pre><h2>Lance-requêtes téléguidé</h2>En ce qui concerne l’exploitation de cet index Elasticsearch, notre application procède de la manière suivante :
<ol>
	<li>Création d’une requête Elasticsearch en fonction des données reçues dans la requête HTTP</li>
	<li>Récupération des résultats, et extraction de leurs identifiants</li>
	<li>Envoi d’une requête à MySQL pour obtenir toutes les données associées à ces identifiants, en conservant leur ordre</li>
	<li>Envoi d’une réponse HTTP contenant le résultat</li>
</ol>On va s’intéresser à la requête qui est envoyée à Elasticsearch, dont voici un exemple :
<pre class="prettyprint">&lt;?php
Elasticsearch::search([
 'index' =&gt; 'sonantes',
 'type' =&gt; 'company',
 'body' =&gt; [
 'filter' =&gt; [
 'bool' =&gt; [
 'must' =&gt; [
 [
 'term' =&gt; [
 'active' =&gt; 1,
 ],
 ],
 [
 'geo_distance_range' =&gt; [
 'from' =&gt; $from.'km',
 'to' =&gt; $to.'km',
 'location' =&gt; $lon.','.$lat,
 ],
 ],
 ],
 ],
 ],
 'query' =&gt; [
 'bool' =&gt; [
 'must' =&gt; [
 [
 'multi_match' =&gt; [
 'query' =&gt; $text,
 'fields' =&gt; ['name^2', 'city', 'category^5', 'tags^3'],
 'type' =&gt; 'best_fields',
 'fuzziness' =&gt; 3,
 ],
 ],
 ],
 ],
 ]
 ],
]);
</pre>Il y a trois choses intéressantes à observer :&nbsp;
<ul>
	<li>On cible l’index <code>sonantes</code> qui est en fait un alias, comme vu dans la section précédente (mais ça ne change rien car Elasticsearch va résoudre ce nom pour que la requête atteigne le vrai index)</li>
	<li>Une section <code>filter</code> dans la requête spécifie des critères d’exclusion de données du résultat de la requête</li>
	<li>Une section <code>query</code> définit ce qu’on cherche, et comment ordonner les résultats</li>
</ul>La section de filtrage comporte deux conditions qui doivent être respectées pour qu’un document puisse être présent dans les résultats. La première indique que le champ booléen <code>active</code> du document doit être à vrai. La seconde utilise une <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-distance-range-query.html" target="_blank">Geo Distance Range Query</a> pour garantir que le professionnel modélisé par le document se situe géographiquement dans une couronne définie par un point central et deux rayons. Cette seconde condition est facile à exprimer car le mapping de notre index comprend un champ de type <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/geo-point.html" target="_blank">Geo-point</a>, supporté nativement par Elasticsearch.&nbsp;
La section de requête, quant à elle, comporte une <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-multi-match-query.html" target="_blank">Multi Match Query</a>. C’est une requête très intéressante pour la recherche en plein texte car elle est capable de rechercher à travers plusieurs champs des documents. Ces champs sont indiqués dans le paramètre <code>fields</code>, et peuvent être associés à un poids (appelé boost). Avec ces informations et un mode de fonctionnement (ici best_fields, le mode par défaut), Elasticsearch est capable d’ordonner les résultats dans un ordre en cohérence avec nos contraintes métier. Dans notre exemple, on souhaite donner plus de points à la catégorie d’un professionnel qu’à sa ville. Ainsi, on obtient des premiers résultats plus pertinents que sans les boosts. 
<h2>Elasticsearch, notre base de données complémentaire</h2>Sur ce projet, notre usage d’Elasticsearch n’était pas celui qui est le plus souvent mis en avant. Nous n’avons pas utilisé les fonctionnalités de type “temps réel”, ni celles liées à la haute disponibilité puisque nous utilisons un unique nœud. Nous n’avons utilisé Elasticsearch comme moyen de stockage primaire pour aucune donnée, c’est à dire que les données que nous avons placées dans Elasticsearch ne sont jamais considérées comme source de vérité.
Pour autant, utiliser Elasticsearch a du sens. Il sert à indexer des données provenant d’une base de données relationnelle, et nous offre des fonctionnalités avancées de recherche en plein texte.
Nous avons vu quelques exemples de ces fonctionnalités : le filtrage par géocode, le boost de score de certains champs dans les résultats de recherche et la capacité à ignorer les erreurs de frappe légères (fuzziness). Il en existe bien d’autres !
Comme expliqué en introduction, SoNantes se différencie en proposant des services et des outils de qualité. C’est avec cet objectif en tête qu’Elasticsearch a été choisi comme fondation pour la recherche dans l’annuaire des adhérents. Les fonctionnalités actuellement disponibles ne sont qu’un aperçu, le niveau zéro, de ce qu’il est possible de réaliser. Maintenant qu’Elasticsearch a été intégré au système, implémenter des fonctionnalités de recherche plus poussées est relativement simple : il suffit de modifier la manière dont l’application le requête, et éventuellement adapter la requête SQL qui sert à importer les données. Un coût plutôt faible en regard de la valeur ajoutée !
<hr><img data-sys-asset-uid="blt371c65f5f171c2d9" src="https://api.contentstack.io/v2/assets/576d7b5c799b40ec0b589aa5/download?uid=blt371c65f5f171c2d9" alt="david-sferruzza-profile.jpeg" style="line-height: 1.6em; float: left; width: 146px; height: 149px; margin: 0px;" height="149" width="146">
David Sferruzza. Ingénieur généraliste de formation, <a href="https://twitter.com/d_sferruzza" target="_blank">David</a> est responsable R&D chez Escale, une agence nantaise d'innovation web, et prépare une thèse doctorale à l'Université de Nantes dans le domaine du génie logiciel !
 
 
 
<img data-sys-asset-uid="blte0bdf2b8ccbd1b01" src="https://api.contentstack.io/v2/assets/576d7b6b90177aa453928d64/download?uid=blte0bdf2b8ccbd1b01" alt="killian-blais-profile.png" style="line-height: 1.6em; width: 145px; height: 146px; float: left; margin: 0px;" height="146" width="145">
Killian Blais. Développeur web chez Escale, <a href="https://twitter.com/killianblais" target="_blank">Killian</a> est spécialisé en PHP et particulièrement dans l’écosystème Laravel.

annuaire-commercants-sonantes.jpg

blog-image.jpg

Elasticsearch pour trouver des commerçants nantais : une histoire de small data

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

David Sferruzza

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Communication Preferences - ONLY for /communication-preferences

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/elastic-cloud-account-terms" target="_self">Conditions générales d'utilisation</a>, et vous acceptez de recevoir les <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">types de notification sélectionnés</a> à l'adresse que vous avez fournie plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.By submitting this form, I agree to Elastic sharing my contact information with Google Cloud. I also agree to Elastic giving my information to the vendor for the purpose of shipping my food package.

GDPR Text + Google Cloud

By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Serverless GDPR Text

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/serverless-preview-terms" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.

Cloud Trial GDPR Text

En envoyant votre demande d'inscription, vous acceptez les <a href="/fr/agreements/global/cloud-services-monthly" rel="nofollow">conditions générales d'utilisation d'Elastic Cloud</a>. Vos données personnelles seront traitées conformément à la <a href="/fr/legal/privacy-statement">déclaration de confidentialité d'Elastic</a>.

By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.

Newsletter GDPR Text

En confirmant votre envoi, vous reconnaissez que vous avez lu et que vous acceptez nos <a href="/fr/legal/terms-of-use" target="_self">Conditions générales d'utilisation</a>, et vous permettez à Elastic de <a href="/fr/legal/privacy-statement#how-we-use-the-information" target="_self">vous contacter</a> à propos de produits et services similaires en utilisant les informations que vous avez fournies plus haut. Pour en savoir plus ou pour revenir sur votre décision (possible à tout moment), consultez la <a href="/fr/legal/privacy-statement/" target="_self">Déclaration de confidentialité d'Elastic</a>.

Explore similar demos

Overview

You'll also receive an email with related content.

You'll also receive an email with related content

Nous vous enverrons plus de contenu susceptible de vous intéresser.

Speakers

Close

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

Le contenu de cette page n'est pas disponible dans la langue sélectionnée. Chez Elastic, nous mettons tout en œuvre pour vous proposer du contenu dans différentes langues. En attendant, nous vous remercions de votre patience !

See more insights

Articles by

Author

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Load More

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Voir à quelle heure débute le webinar dans mon fuseau horaire

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Si vous ne pouvez pas vous libérer le jour J, inscrivez-vous et nous vous enverrons l'enregistrement. Vous recevrez aussi un e-mail contenant des ressources connexes.

Small image for

On-demand webinar

Featured webinar

Register to Attend

Share on Facebook

Reset all

Upcoming webinar

View more posts

Print

Hosted by

Sign In to Attend

View next

Follow us on Facebook

Share

Highlights

Read less

Thank you for registering. We will send you a confirmation email soon.

Nous vous remercions de votre inscription. Vous allez recevoir un e-mail de confirmation.

Author

Articles by David Sferruzza

Elasticsearch pour trouver des commerçants nantais : une histoire de small data

Sign up for Elastic Cloud free trial