Что такое ссылка на динамическое значение?

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

Ссылки на динамические значения включают такие сведения, как:

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

Использование динамических ссылок на значения

Используйте динамические ссылки на значения при настройке заданий или задач. Вы не можете напрямую ссылаться на ссылки на динамические значения из ресурсов, настроенных с помощью таких задач, как записные книжки, запросы или JAR. Динамические ссылки на значения должны быть определены с помощью параметров или полей, которые передают контекст в задачи.

Ссылки на динамические значения используют двойные фигурные скобки ({{ }}). При выполнении задания или задачи строковый литерал заменяет ссылку на динамическое значение. Например, если настроить следующую пару "ключ-значение" в качестве параметра задачи:

{"job_run_id": "job_{{job.run_id}}"}

Если идентификатор выполнения имеет значение 550315892394120, значение для job_run_id которого вычисляется job_550315892394120.

Использование динамических ссылок на значения в пользовательском интерфейсе заданий

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

Использование динамических ссылок на значения в JSON задания

Используйте {{ }} синтаксис для использования динамических значений в определениях JSON задания, используемых интерфейсом командной строки Databricks и REST API.

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

В следующем примере показан частичный синтаксис JSON для настройки параметров задания с помощью динамических ссылок на значения:

{
  "parameters": [
    {
      "name": "my_job_id",
      "default": "{{job.id}}"
    },
    {
      "name": "run_date",
      "default": "{{job.start_time.iso_date}}"
    }
  ]
}

В следующем примере показан частичный синтаксис JSON для настройки параметров задачи записной книжки с помощью ссылки на динамическое значение:

{
  "notebook_task": {
    "base_parameters": {
      "workspace_id": "workspace_{{workspace.id}}",
      "file_arrival_location": "{{job.trigger.file_arrival.location}}"
    }
  }
}

Проверка параметров выполнения задания

После завершения задачи можно просмотреть разрешенные значения параметров в разделе "Параметры " на странице сведений о выполнении. С. статью Просмотр сведений о выполнении задания.

Поддерживаемые ссылки на значения

Поддерживаются следующие ссылки на динамические значения:

Эти ссылки можно задать с любой задачей. См. раздел "Настройка параметров задачи".

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

Параметры значений даты и времени

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

Нерекомендуемые ссылки на динамические значения

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