Настройка параметров задания

Статья
10/05/2024

В этой статье описаны функциональные возможности параметров задания и настройка параметров задания с помощью пользовательского интерфейса рабочей области Databricks. Кроме того, можно добавить параметры задания в определения JSON и YAML, используемые с REST API, CLI и DAOB. См . API заданий, что такое интерфейс командной строки Databricks? и что такое пакеты ресурсов Databricks?.

Что такое параметры задания?

Параметры задания — это пары "ключ-значение", позволяющие параметризировать задания со статическими или динамическими значениями по умолчанию. При активации нового запуска можно переопределить параметры, настроенные в задании. См. раздел "Запуск задания с разными параметрами".

Ключи параметров задания могут содержать _ - . только буквенно-цифровые символы. Значения параметров задаются как строки или динамические ссылки на значения. См . статью "Что такое ссылка на динамическое значение?".

Примечание.

В качестве значения параметра можно использовать любой допустимый JSON. Например, For each тип задачи может анализировать списки, такие как:

[1, 2, 3]
['a', 'b', 'c']

Добавление или изменение параметров задания

Используйте диалоговое окно "Параметры задания", чтобы добавить новые параметры, изменить существующие ключи и значения параметров или удалить параметры.

Чтобы изменить параметры с помощью пользовательского интерфейса рабочей области, выберите существующее задание, выполнив следующие действия.

Щелкните рабочие процессы на боковой панели.
В столбце Имя нажмите на имя задания.
На боковой панели сведений о задании нажмите кнопку "Изменить параметры". Откроется диалоговое окно параметров задания.
Добавление или изменение параметров с помощью полей "Ключ и значение ".
Щелкните, чтобы удалить параметр.
Щелкните Сохранить, чтобы применить изменения.

Примечание.

Щелкните { } для перечисления доступных динамических ссылок на значения. Выберите параметр из списка, чтобы вставить его в поле "Значение ".

Pushdown параметра задания

Параметры задания автоматически отправляются в качестве параметров "ключ-значение" для всех задач, которые принимают параметры "ключ-значение", которые включают следующие типы задач:

Записная книжка
Колесо Python (только при настройке с аргументами ключевых слов)
SQL-запрос, устаревшая панель мониторинга или файл
Выполнение задания

Параметры задания, передаваемые задачам, отображаются в конфигурации задачи в пользовательском интерфейсе вместе с настроенными параметрами задачи.

Внимание

Параметры задания имеют приоритет над параметрами задачи. Если параметр задания и параметр задачи имеют тот же ключ, параметр задания переопределяет параметр задачи.

Динамические ссылки на параметры задания

Все задачи, принимаюющие ссылки на динамические значения, могут получить доступ к параметрам задания.

Используйте ссылку {{job.parameters.<name>}}на динамическое значение, заменив <name>key ее идентификатором.

Выполнение задания с другими параметрами

Можно переопределить настроенные параметры задания или добавить новые при выполнении задания с разными параметрами. См. раздел "Запуск задания с разными параметрами".

При восстановлении задания можно также переопределить параметры задания. См. статью "Повторное выполнение неудачных и пропущенных задач".

Поделиться через