API для запуска задач анализа данных в формате DataFrame
Запускает задачу анализа данных в формате DataFrame.
Запрос
POST _ml/data_frame/analytics/<data_frame_analytics_id>/_start
Предварительные условия
Требуются следующие привилегии:
- cluster:
manage_ml(рольmachine_learning_adminпо умолчанию предоставляет эту привилегию) - индексы-источники:
read,view_index_metadata - индекс-назначения:
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:
resp = client.ml.start_data_frame_analytics(
id="loganalytics",
)
print(resp) const response = await client.ml.startDataFrameAnalytics({
id: "loganalytics",
});
console.log(response); 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/8.17/start-dfanalytics.html