Microsoft Fabric 변수 라이브러리는 작업 영역의 다른 항목이 ALM(애플리케이션 수명 주기 관리)의 일부로 사용할 수 있는 변수 버킷입니다. 이는 릴리스 파이프라인의 각 단계에 대한 해당 값과 함께 변수 목록을 포함하는 작업 영역 내의 항목 역할을 합니다. 작업 영역 내에서 항목 구성을 효율적으로 관리하여 수명 주기 단계에서 확장성과 일관성을 보장하는 통합된 접근 방식을 제공합니다.
예를 들어 변수 라이브러리에는 다음 값을 포함하는 변수가 포함될 수 있습니다.
- 파이프라인의 대기 작업에 사용될 정수입니다.
- 복사 데이터 작업의 원본이 될 레이크하우스 참조입니다. 각 값은 파이프라인의 릴리스 단계에 따라 다른 파이프라인에서 사용됩니다.
- Notebook 기본 레이크하우스로 구성할 레이크하우스 참조입니다. 각 값은 Notebook의 릴리스 단계에 따라 다른 파이프라인에서 사용됩니다.
패브릭 변수 라이브러리:
- CI/CD(지속적인 통합 및 지속적인 업데이트) 프로세스와 호환됩니다. 이 호환성을 통해 Git와 통합 하고 배포 파이프라인을 통해 배포할 수 있습니다.
- Fabric 공용 API를 통한 자동화를 지원합니다.
- 소비자 제품의 가치 평가는 반드시 배포와 연관되어 있지 않습니다. 오히려 각 소비자 항목은 자체 컨텍스트에 따라 값을 확인합니다.
- 변수 라이브러리의 환경은 변수 형식에 따라 다르지만 모든 변수 라이브러리를 사용하면 다른 항목에서 사용할 수 있는 변수를 정의하고 관리할 수 있습니다.
혜택
변수 라이브러리를 사용하면 고객이 구성을 사용자 지정하고 공유할 수 있습니다.
구성 사용자 지정
릴리스 파이프라인 단계에 따라 변수 값을 구성할 수 있습니다. 값 집합을 사용하여 변수 라이브러리를 구성할 수 있습니다. 릴리스 파이프라인의 각 단계에 대해 하나의 값입니다. 그런 다음 각 스테이지에 대해 설정된 활성 값의 일회성 설정 후에는 파이프라인 단계에서 올바른 값이 자동으로 사용됩니다. 예를 들면 다음과 같습니다.
- 스테이지에 따라 항목의 연결을 변경합니다.
- 단계에 따라 다른 클라우드 데이터 원본으로 전환합니다.
- 단계에 따라 쿼리의 데이터 수량을 조정합니다.
설정 공유
변수 라이브러리는 작업 영역 항목 전반의 구성을 중앙에서 관리하는 방법을 제공합니다. 예를 들어 작업 영역에 여러 레이크하우스가 있고 각 레이크하우스에 동일한 데이터 원본을 사용하는 바로 가기가 있는 경우 해당 데이터 원본을 변수 중 하나로 사용하여 변수 라이브러리를 만들 수 있습니다. 이렇게 하면 데이터 원본을 변경하려면 변수 라이브러리에서 한 번만 변경해야 합니다. 각 레이크 하우스에서 별도로 변경할 필요가 없습니다.
변수 라이브러리 구조
패브릭의 변수 라이브러리는 작업 영역 및 배포 단계에서 구성 매개 변수를 관리하도록 설계된 구조화된 시스템입니다. 핵심은 기본 형식(예: 문자열, 정수, 부울) 또는 항목 참조와 같은 복합 형식일 수 있는 사용자 정의 변수입니다. 이러한 변수는 변수 라이브러리 항목 내에서 그룹화되며 동일한 작업 영역 내의 소비자 항목에서 참조할 수 있습니다.
동적 구성을 지원하기 위해 각 변수에는 여러 환경(예: 개발, 테스트, prod)에 맞게 조정된 여러 값 집합 또는 대체 값 집합이 있을 수 있습니다. 하나의 값 집합은 작업 영역당 "활성"으로 지정되어 런타임 중에 사용되는 값을 결정합니다.
사용자는 기본 제공 유효성 검사 및 권한 검사를 통해 패브릭 UI 또는 API를 통해 변수 및 값 집합을 만들고, 편집하고, 관리할 수 있습니다. 시스템은 CI/CD 워크플로를 지원하여 변수를 코드로 관리하고, Git과 통합하고, 파이프라인을 통해 배포할 수 있습니다. 이 구조는 복잡한 데이터 시스템에서 확장 가능하고 자동화되고 관리되는 구성 관리를 보장합니다.
지원되는 항목
다음 항목은 변수 라이브러리를 지원합니다.
명명 규칙
변수 라이브러리 항목 자체의 이름은 다음 규칙을 따라야 합니다.
- 비어 있지 않음
- 선행 또는 후행 공백이 없습니다.
- 문자로 시작
- 문자, 숫자, 밑줄, 하이픈 및 공백을 포함할 수 있습니다.
- 길이가 256자를 초과하지 않음
변수 라이브러리 이름은 대/소문 자를 구분하지 않습니다 .
고려 사항 및 제한 사항
변수에 대한 제한 사항
다음 두 요구 사항을 모두 충족 하는 한 최대 1,000개의 변수 와 최대 1,000개의 값 집합이 있을 수 있습니다.
- 대체 값 집합의 총 셀 수는 10,000개 미만입니다.
- 항목의 크기가 1MB를 초과하지 않습니다.
이러한 요구 사항은 변경 내용을 저장할 때 유효성을 검사합니다.
메모 필드에는 최대 2,048자까지 입력할 수 있습니다.
값 집합 설명 필드에는 최대 2,048자까지 입력할 수 있습니다.
대체 값 집합에 대한 제한 사항
- 변수 라이브러리의 대체 값 집합은 추가한 순서대로 표시됩니다. 현재는 UI에서 순서를 변경할 수 없습니다. 순서를 변경하려면 JSON 파일을 직접 편집합니다.
- 각 값 집합의 이름은 변수 라이브러리 내에서 고유해야 합니다.
- 변수 이름은 변수 라이브러리 내에서 고유해야 합니다. 다른 항목에 있는 경우 작업 영역에서 이름이 같은 두 개의 변수를 가질 수 있습니다.
- 변수 라이브러리에는 항상 한 번에 하나의 활성 값만 설정됩니다. 활성 상태인 동안에는 값 집합을 삭제할 수 없습니다. 삭제하려면 먼저 다른 값 집합을 활성으로 구성합니다. 배포 파이프라인의 각 단계에 대해 다른 활성 값을 설정할 수 있습니다.