API для запуска задач анализа данных в формате DataFrame
Запускает задачу анализа данных в формате DataFrame.
Запрос
POST _ml/data_frame/analytics/<data_frame_analytics_id>/_start
Предварительные условия
Требуются следующие привилегии:
- cluster:
manage_ml(рольmachine_learning_adminпредоставляет эту привилегию) - source indices:
read,view_index_metadata - destination index:
read,create_index,manageиindex
Описание
Задача анализа данных в формате DataFrame может быть запущена и остановлена несколько раз на протяжении её жизненного цикла.
Если индекс назначения не существует, он создаётся автоматически при первом запуске задачи анализа данных в формате DataFrame. Параметры index.number_of_shards и index.number_of_replicas для индекса назначения копируются из исходного индекса. Если имеется несколько исходных индексов, в индекс назначения копируются наибольшие значения параметров. Карты индекса назначения также копируются из исходных индексов. При наличии конфликтов карт, запуск задачи не выполняется.
Если индекс назначения существует, он используется как есть. Таким образом, вы можете предварительно настроить индекс назначения с пользовательскими параметрами и картами.
Когда включены функции безопасности Elasticsearch, задача анализа данных в формате DataFrame запоминает пользователя, который её создал, и выполняет задачу с этими учетными данными. Если при создании задачи были предоставлены дополнительные заголовки авторизации, используются эти учетные данные.
Параметры пути
-
<data_frame_analytics_id> - (Обязательно, строка) Идентификатор задачи анализа данных в формате DataFrame. Этот идентификатор может содержать строчные буквенно-цифровые символы (a-z и 0-9), дефисы и символы подчеркивания. Он должен начинаться и заканчиваться буквенно-цифровыми символами.
Параметры запроса
-
timeout - (Необязательно, единицы времени) Управляет временем ожидания запуска задачи анализа данных в формате DataFrame. По умолчанию 20 секунд.
Тело ответа
-
acknowledged - (Булево) При успешном ответе это значение всегда
true. При ошибке возвращается исключение. -
node - (строка) Идентификатор узла, на котором была запущена задача. Если разрешено открытие задачи в режиме отложенного запуска и она ещё не назначена узлу, это значение пустая строка.
Примеры
Следующий пример запускает задачу анализа данных в формате DataFrame под названием loganalytics:
POST _ml/data_frame/analytics/loganalytics/_start
При запуске задачи анализа данных в формате DataFrame вы получите следующие результаты:
{
"acknowledged" : true,
"node" : "node-1"
}
© 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/7.17/start-dfanalytics.html