변수 라이브러리는 사용자가 작업 영역 수준에서 변수를 정의하고 관리할 수 있도록 하는 Microsoft Fabric의 새로운 항목 유형이므로 파이프라인, Notebook, Lakehouse용 바로 가기 등 다양한 작업 영역 항목에서 곧 사용할 수 있습니다. 구성을 관리하는 통합되고 중앙 집중화된 방법을 제공하여 하드 코딩된 값에 대한 필요성을 줄이고 CI/CD 프로세스를 간소화하여 다양한 환경에서 구성을 보다 쉽게 관리할 수 있습니다.
파이프라인과 함께 변수 라이브러리를 사용하는 방법
작업 영역으로 이동하여 새 항목을 만듭니다.
필터를 사용하여 변수 라이브러리를 찾거나 데이터 개발 섹션까지 아래로 스크롤합니다.
변수 라이브러리를 선택하여 새 변수 라이브러리를 만듭니다. 이름을 선택하고 만들기를 누릅니다.
변수 라이브러리가 만들어지면 홈페이지로 이동됩니다. + 새로 만들기를 클릭하여 새 변수를 추가합니다.
새 변수를 추가한 후에는 변수를 구성하고 이름, 형식 및 기본값 집합을 설정할 수 있습니다. 노트를 추가할 수도 있습니다.
필요에 따라 대체 값 집합을 추가합니다(예: 다른 배포 파이프라인 환경에 대한 다른 값). 이름을 설정하고 만들기를 클릭하면 변수 값을 편집하고 활성화할 값 집합을 선택할 수 있습니다.
완료되면 변경 내용을 저장합니다.
파이프라인에서 변수 라이브러리의 변수를 사용하세요.
파이프라인에서 변수 라이브러리 변수를 사용하려면 새 파이프라인을 만들거나 기존 파이프라인으로 이동합니다.
파이프라인에서 아래쪽 패널에서 변수 라이브러리 변수에 대한 참조를 만들어야 합니다.
+ 새로 만들기를 클릭하면 모든 변수 라이브러리를 보여 주는 팝업이 열립니다. 이 선택기를 사용하여 변수 라이브러리 변수를 선택하고 확인을 클릭할 수 있습니다.
라이브러리 변수 참조를 추가한 후 파이프라인 활동을 추가합니다. 활동 설정에서 매개 변수화하려는 설정에 대한 동적 콘텐츠 추가 를 클릭합니다.
식 작성기가 열립니다. 라이브러리 변수가 표시되지 않으면 함수 옆에 있는 3개의 점을 클릭하고 라이브러리 변수를 선택합니다.
라이브러리 변수 참조를 클릭하여 식 작성기에서 새 식을 추가합니다. 그런 다음 확인을 클릭하여 식을 추가합니다.
이제 동적 콘텐츠가 활동 설정에 추가되는 것을 볼 수 있습니다.
미리 보기 데이터를 클릭하여 데이터를 미리 볼 수 있습니다. 그러면 라이브러리 변수의 값을 표시하는 새 창이 열립니다. 확인을 클릭하여 데이터의 미리 보기를 가져옵니다.
파이프라인을 평소대로 저장하고 실행합니다. 당신의 변수 라이브러리에서 '활성'으로 설정된 값이 무엇이든 간에, 전달된 값이 표시됩니다.
알려진 제한 사항
다음 알려진 제한 사항은 Microsoft Fabric의 Data Factory 파이프라인에서 변수 라이브러리 통합에 적용됩니다.
- 변수 라이브러리는 부울, Datetime, Guid, 정수, 숫자 및 문자열을 데이터 형식으로 지원합니다. 파이프라인에서 Boolean은 Bool 형식으로, Datetime은 문자열 형식으로, Guid는 문자열 형식으로, 정수는 Int 형식으로, 문자열은 문자열 형식으로 표시됩니다. 숫자 형식은 파이프라인에서 지원되지 않습니다.
- 외부 연결 매개 변수화는 파이프라인과 통합된 변수 라이브러리에서 지원됩니다. 그러나 '설정 | 연결 및 게이트웨이 관리'에서 연결에 대한 GUID를 조회해야 합니다. 연결 이름 옆에 있는 설정을 선택하여 연결에 대한 GUID를 찾을 수 있습니다.