Azure Data Factory의 전역 매개 변수

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

전역 매개 변수는 모든 식의 파이프라인에서 사용할 수 있는 데이터 팩터리 간의 상수입니다. 동일한 매개 변수 이름 및 값을 가진 파이프라인이 여러 개 있는 경우에 유용합니다. CI/CD(연속 통합 및 배포 프로세스)를 사용하여 데이터 팩터리를 승격하는 경우 각 환경에서 이러한 매개 변수를 재정의할 수 있습니다.

전역 매개 변수 만들기

전역 매개 변수를 만들려면 관리 섹션의 전역 매개 변수 탭으로 이동합니다. 새로 만들기를 선택하여 생성 측면 탐색을 엽니다.

측면 탐색에서 이름을 입력하고 데이터 형식을 선택하며 매개 변수 값을 지정합니다.

전역 매개 변수를 생성된 후에는 매개 변수의 이름을 클릭하여 해당 매개 변수를 편집할 수 있습니다. 한 번에 여러 매개 변수를 변경하려면 모두 편집을 선택합니다.

파이프라인에서 전역 매개 변수 사용

전역 매개 변수는 모든 파이프라인 식에서 사용할 수 있습니다. 파이프라인이 데이터 세트 또는 데이터 흐름과 같은 다른 리소스를 참조하는 경우 해당 리소스의 매개 변수를 통해 전역 매개 변수 값을 전달할 수 있습니다. 전역 매개 변수는 pipeline().globalParameters.<parameterName>으로 참조됩니다.

CI/CD의 전역 매개 변수

CI/CD 중에 ARM 템플릿에 전역 매개 변수를 포함하는 것이 좋습니다. 아래 그림과 같이 ARM 템플릿에 전역 매개 변수를 포함하는 새로운 메커니즘('허브 관리' -> 'ARM 템플릿' -> 'ARM 템플릿에 전역 매개 변수 포함')은 이전처럼 초기 설정과 충돌하거나 초기 설정을 재정의하지 않으므로 CI/CD 중에 전역 매개 변수 배포를 위한 추가 PowerShell이 필요하지 않습니다.

참고 항목

전역 매개 변수를 포함하는 UI 환경을 '전역 매개 변수' 섹션에서 관리 허브의 'ARM 템플릿' 섹션으로 이동했습니다. 이전 메커니즘('허브 관리' -> '전역 매개 변수' -> 'ARM 템플릿에 포함')을 이미 사용 중인 경우 계속할 수 있습니다. 이는 계속 지원될 예정입니다.

연속 통합 및 배포 솔루션에서 전역 매개 변수를 통합하는 이전 흐름을 사용하는 경우 계속 작동합니다.

• ARM 템플릿에 전역 매개 변수 포함('허브 관리' -> '전역 매개 변수' -> 'ARM 템플릿에 포함')

• PowerShell 스크립트를 통해 전역 매개 변수 배포

전역 매개 변수를 사용하면 CICD가 훨씬 더 간단해지고 쉽게 관리할 수 있게 되므로 ARM 템플릿에 전역 매개 변수를 포함하는 새로운 메커니즘('허브 관리' -> 'ARM 템플릿' -> 'ARM 템플릿에 전역 매개 변수 포함')을 사용하는 것이 좋습니다.

참고 항목

ARM 템플릿에 전역 매개 변수 포함 구성은 "Git 모드"에서만 사용할 수 있습니다. 현재 “라이브 모드” 또는 “Data Factory” 모드에서는 사용할 수 없습니다.

Warning

매개 변수 이름에는 ‘-’를 사용할 수 없습니다. "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}" 오류 코드가 수신됩니다. 그러나 매개 변수 이름에 '_'를 사용할 수 있습니다.

관련 콘텐츠

• Azure Data Factory의 연속 통합 및 배포 프로세스에 대해 알아보기
• 제어 흐름 식 언어를 사용하는 방법 알아보기