Microsoft Fabric 변수 라이브러리를 사용하면 개발자가 콘텐츠 수명 주기 관리를 간소화하기 위해 작업 영역 내에서 항목 구성을 사용자 지정하고 공유할 수 있습니다. 이 문서에서는 변수 라이브러리를 만들고, 관리하고, 사용하는 방법을 설명합니다.
프로세스에 대한 자세한 연습은 변수 라이브러리 사용에 대한 자습서를 참조하세요.
Prerequisites
패브릭에서 변수 라이브러리 항목을 만들려면 다음이 필요합니다.
활성 구독이 있는 Fabric 테넌트 계정 무료로 계정을 만듭니다.
관리 포털에서 사용하도록 설정된 다음 테넌트 스위치 는 다음과 같습니다.
테넌트 관리자, 용량 관리자 또는 작업 영역 관리자는 조직의 설정에 따라 이러한 스위치를 사용하도록 설정할 수 있습니다.
패브릭 변수 라이브러리에 대한 보안 고려 사항 및 권한 관리
패브릭 변수 라이브러리는 여러 패브릭 항목에서 변수를 중앙 집중식으로 관리할 수 있는 강력한 구문입니다. 그러나 이러한 유연성은 중요한 보안 고려 사항을 도입합니다.
변수 라이브러리 자체는 패브릭 항목이므로 자체 권한 집합에 의해 제어됩니다. 이러한 권한 집합은 변수를 사용하는 항목과 다를 수 있습니다. 이러한 불일치로 인해 사용자가 변수 라이브러리에 대한 쓰기 액세스 권한이 있지만 소비 항목에 대한 액세스 권한이 없는 시나리오가 발생할 수 있습니다.
이러한 경우 권한이 없는 사용자는 종속 패브릭 항목의 동작을 의도적으로 또는 의도치 않게 변경하는 방식으로 변수 값을 수정할 수 있습니다. 이 기능은 공유 변수에 대한 악의적인 업데이트가 해당 항목의 무결성, 보안 또는 기능을 손상시킬 수 있는 잠재적인 공격 벡터를 만듭니다.
이러한 위험을 완화하려면 다음 주요 사례를 따르세요.
- 엄격한 권한 제어 채택: 관리자는 신뢰할 수 있는 사용자 또는 서비스만 수정할 수 있도록 변수 라이브러리에 대한 쓰기 권한을 신중하게 관리해야 합니다. 이 사례에는 지나치게 허용되는 액세스를 방지하고 정기적으로 권한 할당을 감사하는 것이 포함됩니다.
- 신뢰할 수 있는 라이브러리 참조 사용: 항목은 명시적으로 신뢰할 수 있는 것으로 지정된 라이브러리에서만 변수를 참조해야 합니다. 이 신뢰 모델은 개발 및 배포 중에 변수 참조의 원본에 대한 유효성을 검사하는 거버넌스 정책을 통해 적용되어야 합니다.
자세한 내용은 변수 라이브러리 권한을 참조하세요.
변수 라이브러리 항목 만들기
패브릭 홈페이지 또는 작업 영역 내에서 변수 라이브러리 항목을 만들 수 있습니다.
사이드바에서 만들기를 선택합니다. (없는 경우 세 개의 점을 선택한 다음 만들기를 선택합니다.)
Data Factory 섹션에서 변수 라이브러리를 선택합니다.
새 변수 라이브러리의 이름을 지정한 다음 만들기를 선택합니다. 이름이 필요한 명명 규칙을 준수하는지 확인합니다.
빈 변수 라이브러리가 나타납니다. 이제 변수를 추가할 수 있습니다.
변수 라이브러리 및 해당 변수 관리
위쪽 메뉴 모음에서 변수 라이브러리의 변수를 관리할 수 있습니다.
변수 추가
라이브러리에 새 변수를 추가하려면 다음을 수행합니다.
- + 새 변수를 선택합니다.
- 이름을 입력합니다. 명명 규칙을 따르는지 확인합니다.
- 드롭다운 목록에서 형식을 선택합니다. 지원되는 변수 형식 목록을 참조하세요.
- 기본값을 입력합니다.
- 변수의 용도 또는 사용 방법을 설명하는 메모를 추가합니다(선택 사항).
- 저장을 선택합니다.
변수 삭제 또는 편집
- 변수를 삭제하려면 하나 이상의 변수를 선택한 다음, 변수>저장 삭제를 선택합니다.
- 변수의 이름, 형식 또는 값 집합을 편집하려면 값을 변경한 다음 저장을 선택합니다.
- 다른 대체 값 집합을 추가하려면 값 집합 추가를 선택합니다.
Note
변수 라이브러리에서 변수를 편집한 후 저장 을 선택하면 오류 유효성 검사가 트리거되어 모든 변수 이름과 값이 유효한지 확인합니다. 변경 내용을 저장하기 전에 오류를 수정해야 합니다.
값 집합 추가
다른 단계에서 사용할 수 있는 다른 값 집합을 추가하려면 다음을 수행합니다.
값 집합 추가를 선택합니다.
값 집합의 이름을 지정합니다. 명명 규칙을 따르는지 확인합니다. 최대 2,048자의 설명(선택 사항)을 제공합니다.
이 값을 이 작업 영역에서 현재 활성 값 집합으로 사용하려면 활성으로 설정을 선택합니다.
변수 라이브러리의 모든 변수에 대한 값을 입력합니다.
저장을 선택합니다.
값 집합 편집
값 집합을 편집하려면 다음을 수행합니다.
값 집합의 이름 옆에 있는 세 개의 점을 선택합니다.
활성으로 설정(이 작업 영역의 경우), 이름 바꾸기 또는 삭제를 선택합니다.
저장을 선택합니다. 변경 내용은 저장한 후에만 적용됩니다.
각 변수의 값을 기본값으로 다시 설정하려면 다시 설정 단추를 선택합니다.
고려 사항 및 제한 사항
크기 제한 사항
다음 두 요구 사항을 모두 충족 하는 한 최대 1,000개의 변수 와 최대 1,000개의 값 집합이 있을 수 있습니다.
- 대체 값 집합의 총 셀 수는 10,000개 미만입니다.
- 항목의 크기가 1MB를 초과하지 않습니다.
이러한 요구 사항은 변경 내용을 저장할 때 유효성을 검사합니다.
메모 필드에는 최대 2,048자까지 입력할 수 있습니다.
값 집합 설명 필드에는 최대 2,048자까지 입력할 수 있습니다.
대체 값 집합에 대한 제한 사항
- 변수 라이브러리의 대체 값 집합은 추가한 순서대로 표시됩니다. 현재는 UI에서 순서를 변경할 수 없습니다. 순서를 변경하려면 JSON 파일을 직접 편집합니다.
- 각 값 집합의 이름은 변수 라이브러리 내에서 고유해야 합니다.
- 변수 이름은 변수 라이브러리 내에서 고유해야 합니다. 다른 항목에 있는 경우 작업 영역에서 이름이 같은 두 개의 변수를 가질 수 있습니다.
- 변수 라이브러리에는 항상 한 번에 하나의 활성 값만 설정됩니다. 활성 상태인 동안에는 값 집합을 삭제할 수 없습니다. 삭제하려면 먼저 다른 값 집합을 활성으로 구성합니다. 배포 파이프라인의 각 단계에 대해 다른 활성 값을 설정할 수 있습니다.