API синонимов
API управления синонимами предоставляет удобный способ определения и управления синонимами в индексе внутренней системы. Связанные синонимы могут быть сгруппированы в "наборе синонимов". Создавайте столько наборов синонимов, сколько вам нужно.
Это альтернатива:
- Определению встроенных синонимов в определении анализатора, что влияет на размер отображения и может привести к проблемам с производительностью.
- Использованию файлов синонимов, что подразумевает загрузку и управление согласованностью файлов на всех узлах кластера.
Наборы синонимов могут использоваться для настройки фильтров токенов синонимической графы и фильтров токенов синонимов. Эти фильтры применяются в рамках процесса анализа анализа анализатором поиска search_analyzer.
Наборы синонимов ограничены максимальным количеством 10 000 правил синонимов на набор. Если вам нужно управлять большим количеством правил синонимов, вы можете создать несколько наборов синонимов.
Наборы синонимов должны существовать перед добавлением их в индексы. Если индекс создаётся со ссылкой на несуществующий набор синонимов, индекс останется в частично созданном и неработоспособном состоянии. Единственный способ восстановить эту ситуацию — убедиться в существовании набора синонимов, а затем либо удалить и пересоздать индекс, либо закрыть и открыть индекс.
Некорректные правила синонимов могут вызывать ошибки при применении изменений анализатора. Для перезагружаемых анализаторов это препятствует перезагрузке и применению изменений. Вы должны исправить ошибки в правилах синонимов и перезагрузить анализатор.
Индекс с некорректными правилами синонимов не может быть повторно открыт, что делает его неработоспособным в следующих случаях:
- Когда узел, содержащий индекс, начинает работу
- Когда индекс открывается из закрытого состояния
- При перезагрузке узла (что приводит к повторному открытию фрагментов, назначенных узлу)
API наборов синонимов
Вы можете использовать эти API для динамического обновления наборов синонимов, используемых во время поиска. Результаты поиска немедленно будут отражать изменения в наборе синонимов.
Используйте следующие API для управления наборами синонимов:
API правил синонимов
Наборы синонимов состоят из правил синонимов. Каждое правило синонимов определяет группу слов, которые действуют как синонимы. Вы можете обновлять отдельные правила синонимов для определенного набора синонимов вместо обновления всего набора синонимов.
Используйте следующие API для управления отдельными правилами синонимов в наборе синонимов:
© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/synonyms-apis.html
