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

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

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

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

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

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

Примечание.

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

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

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

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

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

  1. На боковой панели рабочей области Azure Databricks щелкните "Задания и конвейеры".
  2. При необходимости выберите фильтры "Задания " и " Принадлежащие мне ".
  3. Щелкните по ссылке с названием вашей работы.
  4. На боковой панели сведений о задании нажмите кнопку "Изменить параметры". Откроется диалоговое окно параметров задания .
  5. Добавление или изменение параметров с помощью полей "Ключ и значение ".
  6. Щелкните Корзина, чтобы удалить параметр.
  7. Нажмите кнопку "Сохранить", чтобы применить изменения.

Примечание.

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

Передача параметра задания

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

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

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

Внимание

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

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

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

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

Запуск задания с разными параметрами

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

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