Ce tutoriel guide les développeurs qui découvrent Alibaba Cloud Elasticsearch (ES) à travers le flux complet, de la création du cluster à la récupération des données. Le tutoriel dure environ 45 minutes, dont environ 20 minutes d'attente pour la création du cluster.
Ce que vous allez apprendre
Créez et configurez un cluster ES.
Modélisez des données à l'aide de Developer Tools dans Kibana. Kibana est l'un des composants principaux d'ES. Il vous permet d'explorer, d'analyser et de présenter les données stockées dans ES via une interface graphique intuitive. Kibana est intégré à la console ES, vous n'avez donc pas besoin de l'installer manuellement.
Insérez des exemples de données et exécutez diverses opérations de recherche. Une fois ce tutoriel terminé, vous pourrez créer un index, lire et écrire des données, ainsi qu'effectuer des recherches dans ES.
Version d'ES et coût
Avant de commencer, examinez les informations clés suivantes concernant cet essai :
Type et version d'ES : Vector Enhanced Edition 8.17.0. Cette édition modularise les services algorithmiques principaux du pipeline de recherche IA, notamment l'analyse de documents, le découpage, l'intégration de texte, l'analyse de requêtes, la récupération, le classement et l'intégration de grands modèles de langage (LLM). Elle prend en charge la recherche sémantique, la génération augmentée par récupération (RAG) et la recherche multimodale.
Coût estimé : Ce tutoriel utilise la facturation paiement à l'utilisation tout au long du processus et applique une configuration minimale pour maintenir un faible coût d'essai : une seule zone, les spécifications de nœud et l'espace de stockage les plus petits, aucun nœud maître dédié et aucune fonctionnalité d'amélioration avancée entraînant des frais supplémentaires. La procédure décrite dans cette rubrique prend environ 45 minutes. Si vous libérez le cluster immédiatement après avoir terminé, le coût total estimé est inférieur à 5 USD.
Avec la configuration recommandée dans cette rubrique, vous êtes facturé uniquement pour trois éléments en paiement à l'utilisation : les spécifications des nœuds de données, l'espace de stockage des nœuds de données et les spécifications des nœuds Kibana. Vous pouvez consulter les éléments de facturation et le prix unitaire de chaque élément en bas de la page d'achat.
Les clusters ES sont facturés à l'heure et les frais continuent de s'accumuler tant que le cluster est en cours d'exécution. Après l'essai, libérez immédiatement le cluster en suivant la section « Nettoyer les ressources et étapes suivantes » de cette rubrique afin d'éviter des frais inutiles.
Prérequis
Inscrivez-vous et connectez-vous à un compte Alibaba Cloud. Assurez-vous que le compte dispose des autorisations nécessaires pour créer et gérer des ressources telles qu'Elasticsearch et Virtual Private Cloud (VPC).
Créez un VPC et un vSwitch, et notez la région et la zone où se trouvent le VPC et le vSwitch. Lors de la création du cluster ES ultérieurement, vous devez sélectionner la même région et la même zone. Sinon, le cluster ne pourra pas être associé au VPC et au vSwitch.
Procédure
Étape 1 : Créez un cluster (environ 20 minutes)
Connectez-vous à la console Alibaba Cloud Elasticsearch. Sur la page Elasticsearch Clusters, cliquez sur Create pour accéder à la page d'achat du cluster. Configurez les paramètres clés suivants et laissez les autres paramètres avec leurs valeurs par défaut.
| Paramètre | Description |
| Billing Method | Paiement à l'utilisation. Vous pouvez libérer le cluster à tout moment. |
Région et zone |
Si vous conservez trois zones ou deux zones, le nombre de nœuds de données doit être d'au moins 3 et multiple de 3 ; vous ne pouvez donc pas utiliser les 2 nœuds de données configurés dans ce tutoriel. |
| Network Type | Sélectionnez le VPC et le vSwitch que vous avez créés. |
Cluster Type et Elasticsearch Version | Vector Enhanced Edition 8.17.0. Ce tutoriel est basé sur cette version. |
Scénario et fonctionnalités avancées | Conservez le scénario de récupération par défaut. Deux fonctionnalités d'amélioration avancées sont activées par défaut dans ce scénario. Traitez-les comme suit :
|
| Data Node Specifications |
|
Dedicated Master Node | Sélectionné par défaut, avec trois nœuds de 2 vCPU et 4 GiB de mémoire chacun. Ce tutoriel étant un scénario d'essai, décochez la case du nœud maître dédié pour réduire le coût. Un nœud maître dédié est responsable de la gestion du cluster, y compris les métadonnées du cluster. Après avoir décoché la case, la page indique un risque de split-brain pour les deux nœuds de données. Vous pouvez ignorer cet avertissement pour un essai fonctionnel court, mais assurez-vous d'activer le nœud maître dédié avant de lancer des charges de travail de production. |
| Kibana Node |
|
| Cluster Name | Définissez un mot de passe personnalisé. Vous utiliserez ce mot de passe ultérieurement pour vous connecter à Kibana afin de construire des index et d'explorer les données. |
Cliquez sur Password et attendez environ 20 minutes jusqu'à ce que l'état du cluster passe à Active. Vous pourrez alors passer à l'étape suivante.
Étape 2 : Configurez et connectez-vous à Kibana
Le point de terminaison public de Kibana est activé par défaut. Pour des raisons de sécurité, l'accès au réseau public refuse toutes les adresses IP par défaut. Pour accéder à Kibana, vous devez d'abord ajouter l'adresse IP de l'appareil que vous souhaitez utiliser à la liste d'autorisation.
L'authentification d'accès utilise une vérification à deux facteurs. Connectez-vous d'abord à votre compte Alibaba Cloud. Ensuite, effectuez une seconde connexion avec les identifiants d'accès du cluster ES, où le nom d'utilisateur est fixé à elastic avec son mot de passe de connexion correspondant.
Dans le volet de navigation de gauche, cliquez sur Buy Now. Dans la section Data Visualization, cliquez sur Kibana.
Dans la section Modify Configuration, configurez la liste d'autorisation d'accès public à Kibana.
Obtenez l'adresse IP de votre appareil
Obtenez l'adresse IP de l'appareil que vous souhaitez utiliser selon les scénarios suivants.
| Scénario | Adresse IP à obtenir | Comment l'obtenir |
|
Accédez à Kibana depuis un appareil local via Internet. |
L'adresse IP publique de l'appareil local. Si l'appareil se trouve sur un réseau domestique ou un réseau local d'entreprise (LAN), ajoutez plutôt l'adresse IP publique de sortie du LAN. |
Exécutez la commande |
|
Accédez à Kibana depuis une instance Elastic Compute Service (ECS) via Internet. |
Si l'instance ECS et le cluster ES se trouvent dans des VPC différents, vous pouvez accéder à Kibana via l'adresse IP publique de l'instance ECS. Obtenez l'adresse IP publique de l'instance ECS et ajoutez-la à la liste d'autorisation d'accès public du cluster ES. |
Connectez-vous à la console ECS et consultez l'adresse IP publique de l'instance dans la liste des instances. |
Ajoutez à la liste d'autorisation d'accès public
Obtenez l'adresse IP de votre appareil et ajoutez-la à la liste d'autorisation d'accès public.
-
Cliquez sur Network Access Configuration à droite du groupe default. Dans la boîte de dialogue qui s'affiche, ajoutez des adresses IP à la liste d'autorisation.
Type de configuration Format et exemple Remarques importantes Format d'adresse IPv4
Adresse IP unique :
192.168.0.1Bloc CIDR :
192.168.0.0/24. (Recommandé) Regroupez les adresses IP dispersées en blocs CIDR.
Un seul cluster prend en charge un maximum de 300 adresses IP ou blocs CIDR. Séparez plusieurs adresses IP ou blocs CIDR par des virgules (,), sans ajouter d'espaces avant ou après les virgules.
Adresse publique par défaut :
127.0.0.1, qui refuse l'accès depuis toutes les adresses IPv4.0.0.0.0/0: autorise l'accès depuis toutes les adresses IPv4.Ne configurez pas
0.0.0.0/0, car cela pose un risque de sécurité élevé.Certains clusters et régions ne prennent pas en charge
0.0.0.0/0. Reportez-vous à la console ou au message d'erreur pour obtenir des informations précises.
Une fois la configuration terminée, cliquez sur Configure.
Cliquez sur OK. Sur la page de connexion Kibana, saisissez le nom d'utilisateur et le mot de passe. Après une connexion réussie, vous accédez à la console Kibana et pouvez explorer les données ES.
Access over Internet : fixé à
elastic.Username : le mot de passe que vous avez défini lors de la création du cluster ES. Si vous l'avez oublié, vous pouvez réinitialiser le mot de passe.
Accédez à la console Password et exécutez la commande
GET /pour interroger les informations du cluster. Vérification : Si le volet de droite renvoie un objet JSON contenant des informations telles que le numéro de version et le nom du cluster, la connexion est réussie.
Étape 3 : Créez un index
Dans Kibana Developer Tools, exécutez une opération API RESTful pour créer un index (mapping) nommé product_info pour les données de produits de gestion de patrimoine.
PUT /product_info
{
"settings": {
"number_of_shards": 5,
"number_of_replicas": 1
},
"mappings": {
"properties": {
"productName": {
"type": "text",
"analyzer": "ik_smart"
},
"annual_rate":{
"type":"keyword"
},
"describe": {
"type": "text",
"analyzer": "ik_smart"
}
}
}
}
Descriptions des paramètres clés :
settings : définit la configuration des shards de l'index. Par exemple, cette configuration définit cinq shards primaires et un réplica pour chaque shard primaire. mappings : définit les champs de l'index. Par exemple, cette configuration définit trois champs : productName, annual_rate et describe. Les champs de type text prennent en charge la tokenisation et la recherche floue, tandis que les champs de type keyword sont utilisés pour la correspondance exacte de valeurs. Pour plus d'informations sur les types de champs, consultez Field data types. Vérification : Si la réponse contient "acknowledged": true et "shards_acknowledged": true, l'index a été créé avec succès.
Étape 4 : Insérez des données
Exécutez le code suivant pour insérer en masse des données de test :
POST /product_info/_bulk
{"index":{}}
{"productName":"Wealth Management Product A","annual_rate":"3.2200%","describe":"180-day fixed-term product. Minimum investment: 20,000. Stable returns. Optional push notifications."}
{"index":{}}
{"productName":"Wealth Management Product B","annual_rate":"3.1100%","describe":"90-day scheduled investment product. Minimum investment: 10,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product C","annual_rate":"3.3500%","describe":"270-day scheduled investment product. Minimum investment: 40,000. Daily push notifications for immediately credited returns."}
{"index":{}}
{"productName":"Wealth Management Product D","annual_rate":"3.1200%","describe":"90-day scheduled investment product. Minimum investment: 12,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product E","annual_rate":"3.0100%","describe":"Recommended 30-day scheduled investment product. Minimum investment: 8,000. Daily return message notifications."}
{"index":{}}
{"productName":"Wealth Management Product F","annual_rate":"2.7500%","describe":"Popular short-term product. 3-day term, without any service fee. Minimum investment: 500. Return notifications by SMS."}
Vérification : Si la réponse contient "errors": false, les données ont été insérées avec succès.
Étape 5 : Recherchez des données
Recherche d'index en texte intégral (correspondance floue)
Recherchez les produits de gestion de patrimoine dont le champ describe contient « credited returns » :
GET /product_info/_search
{
"query": {
"match": {
"describe": "Daily push notifications for credited returns"
}
}
}
Vérification : Les résultats sont triés par score de pertinence, les résultats ayant les scores les plus élevés apparaissant en premier.
Recherche conditionnelle (correspondance exacte)
Recherchez les produits de gestion de patrimoine dont le taux d'intérêt annualisé annual_rate est compris entre 3,00 % et 3,13 % :
GET /product_info/_search
{
"query": {
"range": {
"annual_rate": {
"gte": "3.0000%",
"lte": "3.1300%"
}
}
}
}
Vérification : La requête correspond exactement à la plage numérique et renvoie les résultats qui satisfont la condition. Pour plus d'informations sur les clauses de requête, consultez Query DSL.
Nettoyer les ressources et étapes suivantes
Supprimez les données et libérez le cluster ES
Exécutez le code suivant pour supprimer l'index de test que vous avez créé dans cette rubrique.
DELETE /product_info
La réponse suivante est renvoyée :
{
"acknowledged" : true
}
Revenez à la liste des clusters dans la console Elasticsearch.
Dans la liste des clusters, repérez le cluster que vous souhaitez libérer. Dans la colonne Developer Tools, cliquez sur , sélectionnez Release Cluster, puis cliquez sur Immediately Delete pour libérer le cluster. La libération d'un cluster supprime définitivement le cluster et toutes les données qu'il contient. Cette action est irréversible, procédez donc avec prudence.
Étapes suivantes
Pour en savoir plus sur ES, explorez les rubriques suivantes :
Ingestion ou migration de données : collectez ou migrez vos données métier vers ES. Avant la migration, évaluez votre volume de données pour déterminer si vous devez mettre à niveau la configuration du cluster.
Optimisation des performances : Explorez les techniques de conception d'index et d'optimisation des requêtes pour améliorer les performances du cluster.
Visualisation Kibana : Apprenez à utiliser les fonctionnalités Kibana telles que Discover et Dashboard pour créer des tableaux de bord de visualisation de données.