팁 (조언)
CI/CD(연속 통합/지속적인 배포) 시나리오에서 이 기능을 활용하는 방법에 대한 자세한 내용은 Dataflow Gen2용 CI/CD 및 ALM 솔루션 아키텍처에 대한 문서와 매개 변수가 있는 Dataflow Gen2에 대한 엔드 투 엔드 자습서를 참조하세요.
Dataflow Gen2의 매개 변수를 사용하면 데이터 흐름을 동적으로 제어하고 사용자 지정할 수 있으므로 데이터 흐름 자체를 수정하지 않고도 다양한 입력 및 시나리오를 사용하도록 설정하여 데이터 흐름을 보다 유연하고 재사용할 수 있습니다. 여러 데이터 흐름의 필요성을 줄이고 매개 변수가 있는 단일 데이터 흐름 내에서 제어를 중앙 집중화하여 구성을 유지하는 데 도움이 됩니다.
Dataflow Gen2의 공용 매개 변수는 패브릭 REST API 또는 네이티브 패브릭 환경을 통해 파워 쿼리 편집기 외부에 매개 변수 값을 전달하여 데이터 흐름을 실행할 수 있는 새로운 모드입니다. 이를 통해 데이터 흐름 실행 방식에 영향을 주는 다양한 매개 변수를 사용하여 각 실행을 호출할 수 있는 데이터 흐름에 대한 보다 동적 환경을 사용할 수 있습니다.
필수 조건
- CI/CD를 지원하는 Dataflow Gen2
- 매개 변수는 데이터 흐름 내에서 설정해야 합니다.데이터 흐름에서 쿼리 매개 변수를 설정하는 방법에 대해 자세히 알아봅니다.
공용 매개 변수 모드 사용
데이터 흐름의 소유자로서 데이터 흐름을 엽니다. 리본 메뉴의 홈 탭 내에서 옵션 단추를 선택합니다.
단추를 선택하면 새 옵션 대화 상자가 열립니다. 세로 메뉴에서 데이터 흐름 그룹 내에 레이블 매개 변수가 있는 옵션을 선택합니다. 매개 변수 섹션 내에서 "매개 변수를 검색하고 실행을 위해 재정의" 라는 옵션을 사용하도록 설정하여 공용 매개 변수 모드를 사용하도록 설정할 수 있습니다.
확인 단추를 선택하여 이러한 변경 내용을 커밋합니다.
이 모드를 사용하도록 설정하면 매개 변수 관리 대화 상자의 맨 위에 "공용 매개 변수 모드 사용"이라는 알림이 표시됩니다.
공용 매개 변수 모드를 사용하도록 설정하면 데이터 흐름을 저장할 수 있습니다.
데이터 흐름 실행에 대한 사용자 지정 매개 변수 값 전달
공용 매개 변수 모드는 데이터 흐름 내에서 매개 변수 정의를 따르며, 필수 매개 변수와 비필수 매개 변수를 구분합니다.
- 필수 매개 변수: 매개 변수가 필요에 따라 설정된 경우 데이터 흐름을 실행하려면 값을 실행 작업에 전달해야 합니다. 필수로 설정된 매개 변수에 대해 값이 전달되지 않으면 실행이 실패합니다.
- 필수가 아닌 매개 변수: 선택 적 매개 변수라고도 하며 실행을 트리거하기 위해 값을 전달할 필요가 없습니다. 값이 전달되지 않으면 매개 변수 내에 정의된 현재 값 이 실행에 사용됩니다.
파이프라인 내에서 데이터 흐름 작업 사용
비고
모든 기능을 이해하려면 패브릭 파이프라인의 데이터 흐름 활동에 대해 자세히 읽어보는 것이 좋습니다.
패브릭에서 파이프라인을 만들 때 데이터 흐름 작업을 사용하여 공용 매개 변수 모드를 사용하도록 설정된 CI/CD 지원을 사용하여 Dataflow Gen2의 실행을 트리거할 수 있습니다.
사용할 데이터 흐름을 선택하고 데이터 흐름 매개 변수 섹션에서 사용하려는 매개 변수 를 설정할 수 있습니다.
데이터 흐름 매개 변수 섹션에서는 데이터 흐름에서 사용할 수 있는 모든 매개 변수와 값 섹션 내의 각 매개 변수의 기본값을 볼 수 있습니다.
필수 매개 변수는 이름 옆에 별표가 있지만 선택적 매개 변수는 그렇지 않습니다. 동시에 선택적 매개 변수를 그리드에서 제거할 수 있지만 필요한 매개 변수는 삭제할 수 없으며 데이터 흐름을 실행하려면 값을 전달해야 합니다.
새로 고침 단추를 선택하여 데이터 흐름에서 최신 매개 변수 정보를 요청할 수 있습니다.
지원되는 매개 변수 유형
팁 (조언)
검색 데이터 흐름 매개 변수 REST API를 읽고 사용합니다. 설명서는 사용 가능한 모든 매개 변수 형식과 예상 값을 제공하며 REST API는 데이터 흐름에서 매개 변수 정보를 가져오는 방법을 제공합니다.
다음 표에서는 REST API에서 예상하는 값을 이해하기 위해 현재 지원되는 매개 변수 형식과 REST API 정의에 대한 링크를 보여 줍니다.
| 데이터 흐름 매개 변수 형식 | REST API 정의 |
|---|---|
| 문자 메시지 | DataflowStringParameter |
| 정수(int64) | DataflowIntegerParameter |
| 10진수 | DataflowNumberParameter |
| 날짜 | DataflowDateParameter |
| DateTime | DataflowDateTimeParameter |
| 시간 | DataflowTimeParameter |
| DateTimeZone (데이트타임존) | DataflowDateTimeZoneParameter |
| 기간 | DataflowDurationParameter |
| 참/거짓 | DataflowBooleanParameter |
고려사항 및 제한사항
다음은 CI/CD와 함께 Dataflow Gen2에서 공용 매개 변수 모드를 사용하는 경우의 모든 고려 사항 및 제한 사항 목록입니다.
- 예약 및 수동 트리거: 필수 매개 변수를 설정하지 않는 한 공용 매개 변수가 있는 데이터 흐름은 패브릭을 통해 예약하거나 수동으로 트리거할 수 없습니다.
- 지원되지 않는 매개 변수화: 원본 또는 대상에 대한 리소스 경로를 변경하는 매개 변수는 지원되지 않습니다. 연결은 만든 경로에 고정됩니다.
- 증분 새로 고침: 공용 매개 변수 모드와 호환되지 않습니다.
- 논리 수정: 공용 매개 변수를 사용하면 액세스 권한이 있는 사용자가 값을 재정의할 수 있으므로 데이터 흐름 출력이 변경될 수 있습니다.
- 모니터링 허브: 모니터링 허브는 실행 중에 사용되는 매개 변수 값을 표시하지 않습니다.
- 스테이징 동작: 최신 실행만 스테이징 레이크하우스에 저장됩니다. 정의된 대상을 사용하여 데이터를 보존합니다.
- 중복 요청: 동일한 매개 변수 값이 여러 번 제출되는 경우 완료될 때까지 첫 번째 요청만 수락됩니다.
- 스키마 매핑: 매개 변수는 대상 스키마 매핑을 수정할 수 없습니다. 모든 매핑은 작성된 구성을 따릅니다. Dataflow Gen2의 데이터 대상 및 관리되는 설정에 대한 자세한 내용은 이 문서를 참조하세요.