작업 매개 변수 구성
이 문서에서는 Databricks 작업 영역 UI를 사용하여 작업 매개 변수 기능 및 작업 매개 변수 구성에 대해 설명합니다. REST API, CLI 및 DAB와 함께 사용되는 JSON 및 YAML 정의에 작업 매개 변수를 추가할 수도 있습니다. 작업 API, Databricks CLI란? 및 Databricks 자산 번들이란?을 참조하세요.
작업 매개 변수란?
작업 매개 변수는 기본 정적 또는 동적 값으로 작업을 매개 변수화할 수 있는 키-값 쌍입니다. 필요에 따라 새 실행을 트리거할 때 작업에 구성된 매개 변수를 재정의할 수 있습니다. 다른 매개 변수를 사용하여 작업 실행을 참조하세요.
작업 매개 변수 키에는 _ - . 또는 영숫자 문자만 포함할 수 있습니다. 매개 변수 값은 문자열 또는 동적 값 참조로 설정됩니다. 동적 값 참조란?을 참조하세요.
참고 항목
유효한 JSON을 매개 변수 값으로 사용할 수 있습니다. 예를 들어 For each 태스크 유형은 다음과 같은 목록을 구문 분석할 수 있습니다.
[1, 2, 3]
['a', 'b', 'c']
작업 매개 변수 추가 또는 편집
작업 매개 변수 대화 상자를 사용하여 새 매개 변수를 추가하거나, 기존 매개 변수 키와 값을 편집하거나, 매개 변수를 삭제합니다.
작업 영역 UI를 사용하여 매개 변수를 편집하려면 다음 단계를 사용하여 기존 작업을 선택합니다.
- 사이드바에서
워크플로를 클릭합니다. - 이름 열에서 작업 이름을 클릭합니다.
- 작업 세부 정보 사이드바에서 매개 변수 편집을 클릭합니다. 작업 매개 변수 대화 상자가 나타납니다.
- 키 및 값 필드를 사용하여 매개 변수를 추가하거나 편집합니다.
- 매개 변수를 제거하려면
을(를) 클릭합니다. - 저장을 클릭하여 변경 내용을 적용합니다.
참고 항목
{ }를 클릭하여 사용 가능한 동적 값 참조를 나열합니다. 목록에서 옵션을 선택하여 값 필드에 삽입합니다.
작업 매개 변수 푸시다운
작업 매개 변수는 다음 작업 유형을 포함하는 키-값 매개 변수를 허용하는 모든 작업에 키-값 매개 변수로 자동으로 푸시다운됩니다.
- Notebook
- Python 휠(키워드 인수로 구성된 경우에만)
- SQL 쿼리, 레거시 대시보드 또는 파일
- 작업 실행
태스크에 전달된 작업 매개 변수는 UI 태스크 구성에서 태스크에 구성된 매개 변수와 함께 표시됩니다.
Important
작업 매개 변수는 태스크 매개 변수보다 우선합니다. 작업 매개 변수와 태스크 매개 변수의 키가 같으면 작업 매개 변수가 태스크 매개 변수를 재정의합니다.
작업 매개 변수에 대한 동적 값 참조
동적 값 참조를 허용하는 모든 작업은 작업 매개 변수에 액세스할 수 있습니다.
동적 값 참조 {{job.parameters.<name>}}을(를) 사용하여 <name>을(를) 매개 변수를 식별하는 key(으)로 바꿉니다.
다른 매개 변수를 사용하여 작업 실행
다른 매개 변수를 사용하여 작업을 실행할 때 구성된 작업 매개 변수를 재정의하거나 새 작업 매개 변수를 추가할 수 있습니다. 다른 매개 변수를 사용하여 작업 실행을 참조하세요.
작업 실행을 복구할 때 작업 매개 변수를 재정의할 수도 있습니다. 실패한 태스크 및 건너뛴 태스크 다시 실행을 참조하세요.