다음을 통해 공유


변수 라이브러리란?

Microsoft Fabric 변수 라이브러리는 작업 영역의 다른 항목이 ALM(애플리케이션 수명 주기 관리)의 일부로 사용할 수 있는 변수 버킷입니다. 이는 릴리스 파이프라인의 각 단계에 대한 해당 값과 함께 변수 목록을 포함하는 작업 영역 내의 항목 역할을 합니다. 작업 영역 내에서 항목 구성을 효율적으로 관리하여 수명 주기 단계에서 확장성과 일관성을 보장하는 통합된 접근 방식을 제공합니다.

예를 들어 변수 라이브러리에는 다음 값을 포함하는 변수가 포함될 수 있습니다.

  • 파이프라인의 대기 작업에 사용될 정수입니다.
  • 복사 데이터 작업의 원본이 될 레이크하우스 참조입니다. 각 값은 파이프라인의 릴리스 단계에 따라 다른 파이프라인에서 사용됩니다.
  • Notebook 기본 레이크하우스로 구성할 레이크하우스 참조입니다. 각 값은 Notebook의 릴리스 단계에 따라 다른 파이프라인에서 사용됩니다.

소비자 제품의 가치 평가는 반드시 배포와 연관되어 있지 않습니다. 오히려 각 소비자 항목은 자체 컨텍스트에 따라 값을 확인합니다.

변수 라이브러리의 환경은 변수 형식에 따라 다르지만 모든 변수 라이브러리를 사용하면 다른 항목에서 사용할 수 있는 변수를 정의하고 관리할 수 있습니다.

패브릭 변수 라이브러리:

혜택

변수 라이브러리를 사용하면 고객이 구성을 사용자 지정하고 공유할 수 있습니다.

구성 사용자 지정

릴리스 파이프라인 단계에 따라 변수 값을 구성할 수 있습니다. 값 집합을 사용하여 변수 라이브러리를 구성할 수 있습니다. 릴리스 파이프라인의 각 단계에 대해 하나의 값입니다. 그런 다음 각 스테이지에 대해 설정된 활성 값의 일회성 설정 후에는 파이프라인 단계에서 올바른 값이 자동으로 사용됩니다. 예를 들면 다음과 같습니다.

  • 스테이지에 따라 항목의 연결을 변경합니다.
  • 단계에 따라 다른 클라우드 데이터 원본으로 전환합니다.
  • 단계에 따라 쿼리의 데이터 수량을 조정합니다.

설정 공유

변수 라이브러리는 작업 영역 항목 전반의 구성을 중앙에서 관리하는 방법을 제공합니다. 예를 들어 작업 영역에 여러 레이크하우스가 있고 각 레이크하우스에 동일한 데이터 원본을 사용하는 바로 가기가 있는 경우 해당 데이터 원본을 변수 중 하나로 사용하여 변수 라이브러리를 만들 수 있습니다. 이렇게 하면 데이터 원본을 변경하려면 변수 라이브러리에서 한 번만 변경해야 합니다. 각 레이크 하우스에서 별도로 변경할 필요가 없습니다.

변수 라이브러리 구조

변수 라이브러리에는 하나 이상의 변수가 포함되어 있습니다. 각 변수에는 이름, 형식 및 기본값이 있습니다. 각 변수에 해당 변수의 목적이나 사용 방법을 설명하는 메모를 추가할 수도 있습니다.

여러 변수와 해당 핵심 구성 요소가 있는 변수 라이브러리의 스크린샷

기본값

기본값은 다른 값을 구체적으로 정의하지 않는 한 사용되는 값입니다.

모든 변수에는 기본값이 있어야 합니다. 변수 형식이 문자열인 경우 기본값은 .일 수 있습니다 null.

대체 값 집합

값 집합은 변수 라이브러리에서 각 변수의 값을 정의합니다. 변수 라이브러리는 일반적으로 여러 값 집합을 포함합니다. 활성(또는 유효) 값 집합에는 소비자 항목이 해당 작업 영역에 대해 받는 값이 포함됩니다.

각 작업 영역에서 활성화할 값 집합을 선택합니다. Git에서 배포 또는 업데이트하는 동안 작업 영역의 활성 값 집합은 변경되지 않습니다.

여러 대체 값 집합이 있는 변수 라이브러리의 스크린샷

대체 값 집합을 만들면 각 변수의 기본값에 대한 포인터를 사용하여 새 값 집합이 만들어집니다. 그런 다음 새 값 집합에서 각 변수의 값을 변경할 수 있습니다.

지원되는 항목

다음 항목은 변수 라이브러리를 지원합니다.

고려 사항 및 제한 사항

크기 제한

  • 다음 두 요구 사항을 모두 충족 하는 한 최대 1,000개의 변수최대 1,000개의 값 집합이 있을 수 있습니다.

    • 대체 값 집합의 총 셀 수는 10,000개 미만입니다.
    • 항목의 크기가 1MB를 초과하지 않습니다.

    이러한 요구 사항은 변경 내용을 저장할 때 유효성을 검사합니다.

  • 메모 필드에는 최대 2,048자까지 입력할 수 있습니다.

  • 값 집합 설명 필드에는 최대 2,048자까지 입력할 수 있습니다.

대체 값 집합에 대한 제한 사항

  • 변수 라이브러리의 대체 값 집합은 추가한 순서대로 표시됩니다. 현재는 UI에서 순서를 변경할 수 없습니다. 순서를 변경하려면 JSON 파일을 직접 편집합니다.
  • 각 값 집합의 이름은 변수 라이브러리 내에서 고유해야 합니다.
  • 변수 이름은 변수 라이브러리 내에서 고유해야 합니다. 다른 항목에 있는 경우 작업 영역에서 이름이 같은 두 개의 변수를 가질 수 있습니다.
  • 변수 라이브러리에는 항상 한 번에 하나의 활성 값만 설정됩니다. 활성 상태인 동안에는 값 집합을 삭제할 수 없습니다. 삭제하려면 먼저 다른 값 집합을 활성으로 구성합니다. 배포 파이프라인의 각 단계에 대해 다른 활성 값을 설정할 수 있습니다.