Параметризация заданий

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

Ниже приведены основные понятия для понимания параметров заданий:

• Параметр задания: пара "ключ-значение", определенная на уровне задания и передаваемая задачам. См. раздел Настройка параметров задания.
• Параметр задачи: пара "ключ-значение" или массив JSON, определенный на уровне задачи. См. настройка параметров задачи.
• ссылки на динамические значения: синтаксис для ссылок на условия задания, метаданные и параметры при настройке задач. См . статью "Что такое ссылка на динамическое значение?".
• значения задач: синтаксис для записи и ссылки на значения, созданные во время выполнения задачи. См. раздел Использование значений задач для передачи сведений между задачами.

Что можно сделать с параметрами?

Добавьте параметры в задания и задачи для расширенных вариантов использования, включая следующие:

• Добавьте расширяемую логику в ресурсы кода.
• Сделать запуски условными.
• Используйте общие параметры в нескольких задачах.
• Используйте сведения, созданные в одной задаче в другой задаче.
• Ссылки на метаданные и сведения о состоянии процесса выполнения задания.

Какова разница между параметрами задания и задачи?

Параметры задания — это пары "ключ-значение", определенные на уровне задания. Вы можете переопределить параметры по умолчанию для параметров задания, если запустить сейчас с различными параметрами или активировать выполнение задания с помощью REST API. Параметры задания передаются в задачи, использующие параметры "ключ-значение". Другие задачи могут ссылаться на параметры задания с помощью динамических ссылок на значения.

Параметры задачи — это пары "ключ-значение" массивов JSON, определенных на уровне задачи. Каждый тип задачи передает значения задач в настроенные ресурсы кода по-разному. Например, задачи записной книжки используют подмодул dbutils.widgets, а скрипты Python передают значения в качестве аргументов в скрипт, как если бы он был вызван из командной строки. Подчиненные задачи могут ссылаться на параметры задачи из вышестоящих задач с помощью динамических ссылок на значения. См. как получить значения параметров из задачи.

Примечание.

Некоторые задачи не имеют выделенного поля параметров, но позволяют ссылаться на значения задач или ссылки на динамические значения в других полях. Смотрите примеры параметризованных команд dbt и добавьте логику ветвления в задание с задачей If/else.

Создание рабочих процессов с помощью динамических значений

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

Используйте динамические ссылки на значения при определении параметров задачи для реализации шаблонов, таких как:

• Используйте параметр задания в качестве output_table одной задачи и input_table другой.
• Захватить выходные данные запроса записной книжки в виде списка и циклировать его в для каждой задачи.
• Создание форкинга на основе количества обработанных записей с помощью задачи условия if/else.
• Ознакомьтесь с параметрами других задач.

См . статью "Что такое ссылка на динамическое значение?".