«В Elasticsearch под индексом понимается альтернативное имя, присвоенное данному ресурсу Elasticsearch, например индекс или поток данных. Псевдоним — это вторичное имя, которое можно передавать различным конечным точкам API Elasticsearch и выполнять действие над ресурсом. Основная цель псевдонима — предотвращение конфликтов имен, удобство или выполнение таких операций, как переиндексация, без простоев.
Хотя большинство конечных точек API в Elasticsearch поддерживают использование псевдонимов, есть несколько исключений, например деструктивные API. Примером может служить API удаления индекса Elasticsearch».
В этой статье вы узнаете, как получить псевдонимы заданного индекса или потока данных с помощью Get Alias API.
Давайте исследовать.
Elasticsearch Создать псевдоним индекса
Прежде чем научиться получать псевдонимы данного ресурса, давайте создадим простой псевдоним для индекса. Мы используем API псевдонимов и действие ADD для создания псевдонима для данного ресурса.
Например, предположим, что у нас есть индекс под названием «землетрясение». Чтобы добавить псевдоним в индекс, мы можем запустить запрос, как показано ниже.
завиток -XPOST «http://localhost:9200/_aliases» -ЧАС 'kbn-xsrf: отчетность' -ЧАС 'Тип контента: приложение/json' -д '{
'действия': [
{
'добавлять': {
'индекс': 'землетрясение',
'псевдоним': 'землетрясение'
}
}
]
}'
Приведенный выше запрос создает псевдоним «quake» для индекса «землетрясение». В случае успеха запрос должен вернуть true:
{
'признано' : истинный
}
Elasticsearch Просмотр псевдонимов кластера
Чтобы просмотреть псевдонимы в вашем кластере, мы можем использовать API псевдонимов, как показано в синтаксисе ниже:
ПОЛУЧИТЬ псевдоним
Доступ к конечной точке _alias без каких-либо параметров возвращает все псевдонимы в вашем кластере. Пример показан ниже:
Приведенный выше запрос должен возвращать все псевдонимы в кластере, как показано в примере ниже:
Как вы можете догадаться, ресурс может иметь более одного псевдонима.
Мы также можем использовать API-интерфейс cat для получения списка псевдонимов в вашем кластере. Синтаксис запроса показан ниже:
ПОЛУЧИТЬ _cat / псевдонимы
Например, чтобы отобразить все индексы в кластере в удобочитаемой форме, мы можем запустить запрос как:
Результирующий вывод:
Это возвращает псевдоним, индекс или поток данных, к которому принадлежит псевдоним, статус записи и т. д.
Elasticsearch Показать псевдоним для данного ресурса
Чтобы просмотреть псевдонимы, связанные с данным ресурсом, вы можете использовать синтаксис запроса, как показано ниже:
ПОЛУЧИТЬ < ресурс >/ _псевдоним
Где ресурс является либо существующим индексом, либо потоком данных.
Например, чтобы просмотреть псевдонимы индекса kibana_event_log, мы можем запустить:
завиток -XGET 'Ф339АДА9D2EC44E8E64F30875D7DA5CB3D2A11EA' -ЧАС 'kbn-xsrf: отчетность'
Это должно вернуть псевдонимы, связанные с указанным индексом.
'.kibana-журнал-событий-8.3.3-000001' : {
'псевдонимы' : {
'.kibana-журнал-событий-8.3.3' : {
'is_write_index' : истинный ,
'скрыт' : истинный
}
}
}
}
Elasticsearch Показать ресурсы, связанные с данным псевдонимом
Вы также можете показать, каким ресурсам назначен определенный псевдоним, используя приведенный ниже синтаксис запроса:
ПОЛУЧИТЬ псевдоним /< псевдоним >
Например, чтобы показать, какой ресурс использует псевдоним «quake», мы можем запустить:
Приведенный выше запрос должен возвращать результат в виде:
'землетрясение' : {
'псевдонимы' : {
'землетрясение' : { }
}
}
}
Это указывает на то, что псевдоним «землетрясение» присвоен индексу «землетрясение».
Вывод
В этой статье вы узнали, как просмотреть все псевдонимы в вашем кластере с помощью API псевдонимов и cat. Вы также узнали, как получить псевдонимы данного ресурса и наоборот.
Спасибо за чтение!!