« Dans Elasticsearch, un index fait référence à un autre nom attribué à une ressource Elasticsearch donnée, comme un index ou un flux de données. L'alias est un nom secondaire qui peut être transmis à divers points de terminaison de l'API Elasticsearch et effectuer l'action sur la ressource. L'objectif principal d'un alias est d'empêcher les collisions de noms, la commodité ou d'effectuer des opérations telles que la réindexation sans temps d'arrêt.
Bien que la plupart des points de terminaison d'API dans Elasticsearch prennent en charge l'utilisation d'alias, il existe quelques exceptions, telles que les API destructrices. Un exemple serait l'API de suppression d'index d'Elasticsearch.
Dans cet article, vous apprendrez à obtenir les alias d'un index ou d'un flux de données donné à l'aide de l'API Get Alias.
Explorons.
Elasticsearch Créer un alias d'index
Avant d'apprendre à récupérer les alias d'une ressource donnée, créons un simple alias pour un index. Nous utilisons l'API des alias et l'action ADD pour créer un alias pour une ressource donnée.
Par exemple, supposons que nous ayons un indice appelé 'tremblement de terre'. Pour ajouter un alias à l'index, nous pouvons exécuter la requête comme indiqué.
boucle -XPOST 'http://localhost:9200/_aliases' -H 'kbn-xsrf : création de rapports' -H 'Type de contenu : application/json' -ré '{
'Actions': [
{
'ajouter': {
'index': 'tremblement de terre',
'alias': 'tremblement'
}
}
]
}'
La requête ci-dessus crée un alias 'quake' pour l'index 'earthquake'. En cas de succès, la requête doit renvoyer true :
{
'reconnu' : vrai
}
Alias de cluster de vues Elasticsearch
Pour afficher les alias de votre cluster, nous pouvons utiliser l'API d'alias comme indiqué dans la syntaxe ci-dessous :
OBTENIR _alias
L'accès au point de terminaison _alias sans aucun paramètre renvoie tous les alias de votre cluster. Un exemple est comme indiqué:
La requête ci-dessus doit renvoyer tous les alias du cluster, comme indiqué dans l'exemple de sortie ci-dessous :
Comme vous pouvez le deviner, une ressource peut avoir plusieurs alias.
Nous pouvons également utiliser l'API cat pour obtenir la liste des alias de votre cluster. La syntaxe de la requête est la suivante :
OBTENIR _cat / pseudonymes
Par exemple, pour afficher tous les index du cluster sous une forme lisible par l'homme, nous pouvons exécuter la requête comme :
Sortie résultante :
Cela renvoie l'alias, l'index ou le flux de données auquel appartient l'alias, le statut d'écriture, etc.
Elasticsearch Afficher l'alias pour une ressource donnée
Pour afficher les alias associés à une ressource donnée, vous pouvez utiliser la syntaxe de la requête comme indiqué ci-dessous :
OBTENIR < Ressource >/ _alias
Où la ressource est soit un index existant, soit un flux de données.
Par exemple, pour afficher les alias de l'index kibana_event_log, nous pouvons exécuter :
boucle -XGET 'http://localhost:9200/.kibana-event-log-8.3.3/_alias?pretty' -H 'kbn-xsrf : création de rapports'
Cela devrait renvoyer les alias associés à l'index spécifié.
'.kibana-event-log-8.3.3-000001' : {
'alias' : {
'.kibana-event-log-8.3.3' : {
'is_write_index' : vrai ,
'est caché' : vrai
}
}
}
}
Elasticsearch Afficher les ressources associées à un alias donné
Vous pouvez également afficher les ressources auxquelles un alias spécifique est attribué à l'aide de la syntaxe de requête fournie ci-dessous :
OBTENIR _alias /< alias >
Par exemple, pour montrer quelle ressource utilise l'alias 'quake', nous pouvons exécuter :
La requête ci-dessus doit renvoyer la sortie comme :
'tremblement de terre' : {
'alias' : {
'tremblement' : { }
}
}
}
Cela indique que l'alias 'quake' est attribué à l'index 'earthquake'.
Conclusion
Dans cet article, vous avez découvert comment afficher tous les alias de votre cluster à l'aide des alias et de l'API cat. Vous avez également appris à récupérer les alias d'une ressource donnée et vice versa.
Merci d'avoir lu!!