Elasticsearch crée un alias

Puisque vous lisez un didacticiel sur Elasticsearch Index, les chances sont élevées que je n'ai pas besoin de plonger profondément dans ce qu'est Elastisarch, mais un bref rappel ne vous fera aucun mal.

Qu'est-ce que Elasticsearch?

Elasticsearch est un moteur de recherche et analytique libre et open source utilisé pour collecter, gérer et analyser les données.

Elasticsearch est un outil complet qui utilise Apache Lucene pour traiter les données géospatiales numériques, structurées et non structurées. Elasticsearch utilise une API REST simple et très puissante qui permet aux utilisateurs de le configurer et de le gérer. Lorsqu'il est associé à d'autres outils tels que Kibana et Logstash, c'est l'un des moteurs d'analyse en temps réel et de données les plus populaires.

Une fois les données collectées à partir de sources telles que les journaux système, les mesures, les données d'application, etc., Il est ajouté à Elasticsearch et indexé, vous permettant d'effectuer des requêtes de données complexes et de créer des résumés et des tableaux de bord informatifs à l'aide d'outils de visualisation comme Kibana.

Qu'est-ce que l'indice Elasticsearch?

Après avoir repris ce qu'est Elasticsearch, parlons de l'une des choses les plus importantes à propos de l'élastique: Un index.

Dans Elasticsearch, un index fait référence à une collection de documents étroitement liés sous forme de données JSON. Les données JSON corrèlent les clés avec les valeurs correspondantes à leurs clés.

Voici un exemple de document JSON:

"@timestamp": "2099-11-15T13: 12: 00",
"Message": "Obtenez / recherche http / 1.1 200 1070000 ",
"utilisateur":
"id": "json_doc"

Les index Elasticsearch sont sous la forme d'un index inversé, que la recherche Elasticsearch en utilisant des textes intégraux. Un index inversé fonctionne en répertoriant tous les mots uniques dans n'importe quel document Elasticsearch et correspond avec précision au document dans lequel le mot se transforme.

La fonction d'indexation inversée fournie par Elasticsearch permet également une recherche en temps réel et peut être mise à jour à l'aide de l'API d'indexation Elasticsearch.

Comment créer un alias d'index

Elasticsearch expose ses services et fonctionnalités en utilisant une API REST très puissante. En utilisant cette API, nous pouvons créer un alias pour un index Elasticsearch.

Qu'est-ce qu'un alias d'index?

Un alias index élastissearch est un nom ou un identifiant secondaire que nous pouvons utiliser pour référencer un ou plusieurs indices.

Une fois que vous avez créé un alias d'index, vous pouvez référencer l'index ou les indices dans les API Elasticsearch.

Un exemple d'index approprié serait des indices qui stockent les journaux système pour Apache. Si vous interrogez régulièrement les journaux Apache, vous pouvez créer un alias pour Apache_logs, et interroger et mettre à jour cet index spécifique.

Pour créer un alias pour un index particulier, nous utilisons la demande de put suivie du chemin de l'indice et de l'alias pour créer.

En repos, nous utilisons une méthode de put pour demander l'entité ou la valeur passée pour être stockée sur l'URL de la demande. Autrement dit, une méthode de put http vous permet de mettre à jour des informations sur une ressource ou de créer une nouvelle entrée si aucune n'existe.

Pour ce tutoriel, je suppose que vous avez installé Elasticsearch, et vous avez un client API ou un outil pour envoyer des demandes HTTP telles que Curl.

Commençons par créer un index simple sans alias ni paramètres.

Pour plus de simplicité, nous utiliserons Curl car nous supposons que vous n'avez installé Elasticsearch sans kibana. Cependant, si vous avez des erreurs Kibana installées ou rencontrées lorsque vous utilisez Curl, envisagez d'utiliser la console Kibana car elle est mieux adaptée aux demandes d'API Elasticsearch.

curl -x put "localhost: 9200 / my_index?joli"

Cette commande crée un index simple à l'aide de paramètres par défaut et renvoie ce qui suit.

«Reconnu»: vrai,
«Shards_ackNowledled»: vrai,
"index": "my_index"

Maintenant que nous avons un index dans Elasticsearch, nous pouvons créer un alias en utilisant la même demande de vente que:

Mettez localhost: 9200 / my_index / _alias / my_alias_1

Nous commençons par spécifier la méthode, dans ce cas, un put suivi de l'URL de l'index à laquelle nous voulons ajouter un alias. Le suivant est l'API que nous voulons utiliser, dans ce cas, l'API ALIAS INDEX (_alias) suivi du nom de l'alias que nous voulons attribuer à l'index.

Voici la commande Curl pour cela:

curl -x put "localhost: 9200 / my_index / _alias / my_alias_1?joli"

Cette commande doit répondre avec un statut de 200 OK et «reconnu»:

«Reconnu»: vrai

Vous pouvez également rencontrer une méthode pour ajouter un alias à un index comme:

Curl -x Post "LocalHost: 9200 / _aliases?joli "-h 'contenu-type: application / json' -d '

"Actions" : [
"add": "index": "my_index", "alias": "my_alias_1"
]]

À l'aide de l'API d'alias d'alias Index Elasticsearch, vous pouvez ajouter, mettre à jour et supprimer les alias index comme vous le voyez.

Comment obtenir des informations d'alias index

Lorsque vous créez des alias sophistiqués tels que ceux filtrés à un utilisateur spécifique, vous voudrez peut-être obtenir des informations sur l'index. Vous pouvez afficher les informations à l'aide de la méthode GET comme:

Get / my_index / _alias / my_alias_1

Voici la commande curl:

curl -x get "localhost: 9200 / my_index / _alias / my_alias_1?joli"

Cette commande affichera les informations concernant l'alias. Puisque nous n'avons ajouté aucune information, elle ressemblera généralement.

"my_index":
"alias":
"my_alias_1":

Assurez-vous que l'alias existe pour éviter d'obtenir une erreur 404 comme indiqué ci-dessous:

curl -x get "localhost: 9200 / my_index / _alias / do_not_exist?joli"

Le résultat sera un «alias n'existe ni manquant» comme:

"Error": "alias [DOED_NOT_EXIST] Missing",
"Statut": 404

Comment supprimer un alias d'index

Pour supprimer un alias existant d'un index, nous utilisons la méthode que nous avons utilisée pour ajouter un alias mais avec une demande de suppression à la place. Par exemple:

localhost: 9200 / my_index / _alias / my_alias_1

La commande Curl équivalente est:

curl -x supprimer "localhost: 9200 / my_index / _alias / my_alias_1?joli"

Elasticsearch devrait répondre avec 200 ok et reconnue: vrai

«Reconnu»: vrai

Il existe d'autres moyens de mettre à jour et de supprimer les alias d'un index dans Elasticsearch. Cependant, pour simplifier, nous sommes restés avec une seule demande.

Conclusion

Dans ce tutoriel simple, nous avons envisagé de créer un index Elasticsearch puis un alias. Nous avons également couvert comment supprimer un alias.

Il convient de noter que ce guide n'est pas le plus définitif au monde; Son objectif était de servir de guide de démarrage pour créer Elasticsearch, pas un guide complet.

Si vous souhaitez en savoir plus sur l'API Elastic Index, considérez les ressources ci-dessous.

Nous vous recommandons également d'avoir une connaissance de base de travailler avec Elasticsearch et API; Ce sera d'une grande aide lorsque vous travaillez avec la pile des wapitistes.

https: // www.élastique.co / guide / en / elasticsearch / référence / courant / indices-alias.html

https: // www.élastique.CO / Guide / EN / Elasticsearch / Reference / Current / Indices-Add-Alias.html