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