매개변수는 전체 시각적 데이터 준비를 위해 정의된 이름 값입니다. SQL 및 Python 연산자 코드, 지원되는 연산자 구성 필드, 연산자를 활성화하거나 비활성화하는 표현식에서 매개변수를 참조할 수 있습니다. 매개변수를 사용하면 개발 중에는 테스트 카탈로그에 대해, 프로덕션 환경에서는 프로덕션 카탈로그에 대해 동일한 시각적 데이터 준비를 실행할 수 있습니다.
매개변수를 정의하세요
매개변수를 관리하려면 매개변수를 왼쪽 창에서 선택하세요. 각 매개 변수에는 정의할 때 설정한 값이 있습니다. 시각 데이터 준비가 일정에 따라 또는 작업으로 실행될 때는 그 값을 덮어쓸 수 있습니다. 프로덕션에서 매개변수 값 재정의를 참조하세요.
연산자로부터 매개변수를 참조하기
매개변수를 어떻게 참조할지는 어디에서 사용하느냐에 따라 다릅니다:
-
SQL 연산자: 명명된 매개 변수 표식 구문을 사용합니다(예:
:environment.). 명명된 매개 변수 표식 사용을 참조하세요. -
Python 연산자: 호출
dbutils.widgets.get()(예:dbutils.widgets.get("environment"). 위젯 도구(dbutils.widgets)를 참조하세요. -
지원되는 연산자 구성 필드: 연산자의 구성 창에서 오른쪽 상단의 매개변수 를 선택하세요. 필드를 선택하고 와 같은
:source_table식을 입력합니다. 지원되는 필드는 다음과 같습니다:- 출처: 테이블, 파일 경로, 파일 형식.
- 출력:카탈로그, 스키마, 테이블, 뷰, 볼륨, 파일 이름, 쓰기 모드.
- 제한: 제한.
- 결합: 연산 설정, 전략 병합, 이름별 합합, 누락된 열을 허용하기.
편집을 위해 SQL 또는 Python 연산자를 열면 Lakeflow Designer는 원본 편집기 위에서 사용 가능한 매개 변수를 참조하는 방법의 예를 보여 줍니다.
고정된 텍스트와 매개변수를 결합하세요
소스 또는 출력 연산자에 대한 매개변수 표현식에서는 전체 값을 대체하는 데 사용 :parameter_name 한다. 매개변수를 고정 텍스트와 결합하려면 해당 텍스트를 작은따옴표로 묶고 ||를 사용하세요. 예를 들어, 다음 소스 테이블 표현식은 완전 자격화된 테이블 이름을 만듭니다:
:catalog || '.' || :schema || '.' || :table
매개변수를 사용하여 연산자를 활성화하거나 비활성화하기
매개변수를 사용해 설정된 운영자를 활성화하거나 비활성화할 수 있습니다.
Parameters(매개변수) 창에서 Disabled를 선택하고 불리언 표현식을 입력하세요. 예를 들어, :skip_operator 매개변수가 일 true때 연산자를 비활성화합니다. 장애가 있는 연산자는 출력 행을 생성하지 않습니다.
운영자를 수동으로 활성화하거나 비활성화하려면 대신 '운영자 이름 변경, 복사, 삭제, 비활성화'를 참조하세요.
프로덕션에서 매개변수 값 오버라이드
실행 시 시각 데이터 준비는 인터랙티브든 작업으로 실행되든 매개변수를 동일하게 읽기 때문에, 동일한 파일이 모든 환경에서 변경 없이 작동합니다. 각 환경에 대해 다음과 같이 다른 값을 제공하세요:
-
UI에서 작업을 예약하는 경우: 각 일정에 대한 매개 변수 값을 재정의합니다. 예를 들어, 같은 시각적 데이터 준비를 매일 정오
environment에 매개변수를test로 설정한 상태로 실행하고, 오후 2시에environment를production로 설정하여 다시 실행하도록 일정 조정하세요. 작업으로 예약을(를) 참조하세요. -
번들을 사용하여 배포하는 경우: 작업을
parameters통해 매개 변수 값을 설정하고 번들 대상을 사용하여 환경별로 다른 값을 제공합니다. 번들 개발 및 프로덕션 대상을 사용하면 환경별 설정을 사용하여 별도의 환경에 동일한 작업을 배포할 수 있습니다. 선언적 자동화 번들 배포 모드 및선언적 자동화 번들 구성을 참조하세요.