작업 실행에 대한 컨텍스트를 작업 태스크로 전달

동적 값 참조를 사용하여 작업 또는 작업 이름, 실행 식별자 또는 작업 실행의 시작 시간과 같은 작업 또는 작업 실행에 대한 컨텍스트를 전달할 수 있습니다. 동적 값 참조는 작업 태스크가 실행될 때 적절한 값으로 대체되는 템플릿 변수입니다. 작업이 실행되면 이중 중괄호로 묶은 태스크 매개 변수 변수가 바뀌어 값의 일부로 포함된 선택적 문자열 값에 추가됩니다. 예를 들어 작업 ID 6의 실행에 대해 값이 my-job-6인 MyJobId라는 매개 변수를 전달하려면 다음 태스크 매개 변수를 추가합니다.

{
  "MyJobID": "my-job-{{job.id}}"
}

이중 중괄호의 내용은 식으로 평가되지 않으므로 이중 중괄호로 작업 또는 함수를 수행할 수 없습니다.

사용자가 제공한 식별자(예: 작업 이름, 작업 값 키 또는 특수 문자가 포함된 작업 매개 변수 이름은 백틱(` `)로 식별자를 둘러싸고 이스케이프되어야 합니다. 이스케이프 없이 영숫자 및 밑줄 문자만 사용할 수 있습니다.

{
  "VariableWithSpecialChars": "{{job.parameters.`param$@`}}"
}

참조의 구문 오류(예: 누락된 중괄호)는 무시되고 값은 리터럴 문자열로 처리됩니다. 예를 들어 {{my.value} 문자열 "{{my.value}"로 전달됩니다. 그러나 알려진 네임스페이스에 속하는 잘못된 참조(예: {{job.naem}})를 입력할 수 없습니다. 알려진 네임스페이스에 속한 잘못된 참조를 UI에 입력하면 오류 메시지가 표시됩니다.

작업이 완료되면 실행 세부 정보 페이지의 매개 변수 아래에서 매개 변수에 대해 확인된 값을 볼 수 있습니다.

지원되는 값 참조

지원되는 동적 값 참조는 다음과 같습니다.

참조	설명
{{job.id}}	작업에 할당된 고유 식별자입니다.
{{job.name}}	작업 실행 시의 작업 이름입니다.
{{job.run_id}}	작업 실행에 할당된 고유 식별자입니다.
{{job.repair_count}}	현재 작업 실행에 대한 복구 시도 횟수입니다.
{{job.start_time.[argument]}}	작업 실행이 시작된 시간(UTC 표준 시간대)을 기반으로 하는 값입니다. 반환 값은 옵션에 따라 달라집니다 argument . 날짜 및 시간 값에 대한 옵션을 참조 하세요.
{{job.parameters.[name]}}	키가 [name]있는 작업 수준 매개 변수의 값입니다.
{{job.trigger.type}}	작업 실행의 트리거 유형입니다. 가능한 값은 periodic, onetime, run_job_taskfile_arrival, continuous및 table.
{{job.trigger.file_arrival.location}}	이 작업에 대해 파일 도착 트리거가 구성된 경우 스토리지 위치의 값입니다.
{{job.trigger.time.[argument]}}	작업 실행이 트리거된 시간(UTC 표준 시간대)을 기준으로 하는 값으로, cron 일정이 있는 작업에 대해 가장 가까운 분으로 반올림됩니다. 반환 값은 옵션에 따라 달라집니다 argument . 날짜 및 시간 값에 대한 옵션을 참조 하세요.
{{task.name}}	현재 작업의 이름입니다.
{{task.run_id}}	현재 작업 실행의 고유 식별자입니다.
{{task.execution_count}}	현재 작업이 실행된 횟수(재시도 및 복구 포함)입니다.
{{task.notebook_path}}	현재 Notebook 작업의 Notebook 경로입니다.
{{tasks.[task_name].run_id}}	작업 실행에 할당된 고유 식별자입니다 [task_name].
{{tasks.[task_name].result_state}}	작업의 [task_name]결과 상태입니다. 가능한 값은 success, ,failed, excludedcanceled, evictedtimedout, upstream_canceledupstream_evicted및 .upstream_failed
{{tasks.[task_name].error_code}}	태스크 [task_name] 를 실행하는 동안 오류가 발생한 경우 태스크에 대한 오류 코드입니다. 가능한 값의 예는 RunExecutionError, ResourceNotFound및 UnauthorizedError. 성공적인 작업의 경우 빈 문자열로 평가됩니다.
{{tasks.[task_name].execution_count}}	태스크 [task_name] 가 실행된 횟수(재시도 및 복구 포함)입니다.
{{tasks.[task_name].notebook_path}}	Notebook 작업의 [task_name]Notebook 경로입니다.
{{tasks.[task_name].values.[value_name]}}	작업에서 설정한 키가 [value_name] 있는 작업 [task_name]값입니다.
{{workspace.id}}	작업 영역에 할당된 고유 식별자입니다.
{{workspace.url}}	작업 영역의 URL입니다.

작업을 만들거나, 작업을 편집하거나, 다른 매개 변수를 사용하여 작업을 실행할 때 모든 작업에서 이러한 참조를 설정할 수 있습니다.

작업 값이 있는 작업의 작업 간에 매개 변수를 전달할 수도 있습니다. Azure Databricks 작업의 작업 간 정보 공유를 참조하세요.

날짜 및 시간 값에 대한 옵션

다음 인수를 사용하여 시간 기반 매개 변수 변수의 반환 값을 지정합니다. 모든 반환 값은 UTC 표준 시간대의 타임스탬프를 기반으로 합니다.

인수	설명
iso_weekday	타임스탬프의 요일을 나타내는 1에서 7까지의 숫자를 반환합니다.
is_weekday	타임스탬프가 평일인지를 반환 true 합니다.
iso_date	ISO 형식으로 날짜를 반환합니다.
iso_datetime	날짜 및 시간을 ISO 형식으로 반환합니다.
year	타임스탬프의 연도 부분을 반환합니다.
month	타임스탬프의 월 부분을 반환합니다.
day	타임스탬프의 일 부분을 반환합니다.
hour	타임스탬프의 시간 부분을 반환합니다.
minute	타임스탬프의 분 부분을 반환합니다.
second	타임스탬프의 두 번째 부분을 반환합니다.
timestamp_ms	타임스탬프를 밀리초 단위로 반환합니다.

사용되지 않는 매개 변수 변수

다음 매개 변수 변수는 더 이상 사용되지 않습니다. 여전히 지원되지만 기존 작업에 대한 새 작업 또는 업데이트는 지원되는 값 참조를 사용해야 합니다. 권장되는 대체 참조는 각 변수에 대한 설명에 포함됩니다.

변수	설명
{{job_id}}	작업에 할당된 고유 식별자입니다. 대신 job.id를 사용하세요.
{{run_id}}	작업 실행에 할당된 고유 식별자입니다. 대신 task.run_id를 사용하세요.
{{start_date}}	태스크 실행이 시작된 날짜. 형식은 UTC 표준 의 yyyy-MM-dd입니다. 대신 job.start_time.[argument]를 사용하세요.
{{start_time}}	클러스터가 만들어지고 준비된 후 실행의 실행이 시작된 타임스탬프. 형식은 System.currentTimeMillis()에서 반환하는 UTC 표준 시간대의 UNIX Epoch 이후 밀리초입니다. 대신 job.start_time.[format]를 사용하세요.
{{task_retry_count}}	첫 번째 시도가 실패하는 경우 태스크를 실행하려고 시도한 다시 시도 횟수. 값은 첫 번째 시도의 경우 0이고 다시 시도할 때마다 증분합니다. 대신 task.execution_count를 사용하세요.
{{parent_run_id}}	여러 태스크가 있는 작업의 실행에 할당된 고유 식별자입니다. 대신 job.run_id를 사용하세요.
{{task_key}}	여러 태스크가 있는 작업의 일부인 태스크에 할당된 고유 이름입니다. 대신 task.name를 사용하세요.