변수 라이브러리의 변수 형식

Microsoft Fabric의 변수 라이브러리는 변수의 정의 및 관리를 중앙 집중화하여 작업 영역 및 항목 간에 확장 가능하고 자동화된 구성을 가능하게 하는 특수 항목입니다.

변수 라이브러리 내의 변수는 기본 또는 고급 형식일 수 있으며 각 변수는 라이브러리 항목 내의 이름으로 고유하게 식별됩니다.

변수 라이브러리의 기본 변수 형식에는 부울, DateTime(ISO 8601 UTC 형식), Guid, 정수, 숫자 및 문자열과 같은 간단한 데이터 형식이 포함됩니다. 이러한 값은 다양한 단계와 환경에서 직접 할당하고 사용할 수 있는 간단한 값입니다.
고급 변수 형식은 내부 패브릭 항목 또는 외부 연결 참조와 같은 보다 정교한 사용 사례를 위해 설계되었습니다. 여기에는 특정 패브릭 항목을 가리키도록 작업 영역 및 항목 ID를 저장하는 "항목 참조" 형식이 포함됩니다.

변수 라이브러리에서 지원되는 형식

변수 라이브러리 내의 변수에는 다음과 같은 지원되는 변수 형식이 있습니다.

TypeType	카테고리	Description
불리언 (Boolean)	기초	true/false 값을 나타냅니다.
정수	기초	소수점이 없는 정수입니다.
Number	기초	소수 자릿수를 포함한 숫자 값입니다.
String	기초	텍스트 값 또는 문자 시퀀스입니다.
DateTime	기초	ISO 8601 표준 yyyy-MM-ddTHH:mm:ss.xxxZ로 표시된 날짜 및 시간, 여기서: yyyy-MM-dd 는 4자리 연도이며, 그 다음으로 두 자리 달과 두 자리의 날입니다. T 는 날짜와 시간을 구분합니다. HH:mm:ss.xxx 는 24시간 형식의 두 자리 시간이며, 그 뒤에 두 자리 분, 두 자리 초, 세 자리 밀리초가 잇습니다. Z 는 시간이 UTC(협정 세계시)에 있음을 나타냅니다.
가이드	기초	고유 개체 식별에 사용되는 전역 고유 식별자입니다.
항목 참조	Advanced	패브릭 변수 라이브러리 내에서 작업 영역 ID 및 항목 ID를 저장하여 레이크하우스, Notebook 또는 데이터 파이프라인과 같은 기존 패브릭 항목에 대한 참조를 저장하는 데 사용됩니다.

변수 라이브러리의 각 변수에는 다음과 같은 속성이 있습니다.

재산	Description
이름	변수의 고유 식별자입니다. 스크립트 또는 워크플로에서 변수를 참조하는 데 사용됩니다.
참고(선택 사항)	변수에 대한 설명 주석입니다. 컨텍스트, 사용량 현황 정보 또는 특별 지침을 포함할 수 있습니다. 최대 길이: 2,048자.
유형	변수의 데이터 형식(예: 문자열, 정수, 부울, 배열)을 정의합니다. 값을 해석하고 유효성을 검사하는 방법을 결정합니다.
기본값 설정	다른 값이 제공되지 않을 때 변수에 할당된 초기 값입니다. 워크플로에서 일관된 동작을 보장합니다. 기본값 집합의 이름을 바꿀 수 없습니다.
대체 값 집합(선택 사항)	특정 조건 또는 시나리오에서 적용할 수 있는 미리 정의된 추가 값 집합입니다. 환경별 구성 또는 대체 옵션에 유용합니다.

변수 라이브러리 내의 변수 이름은 다음 규칙을 따라야 합니다.

변수 이름은 대/소문자를 구분하지 않습니다.

변수에 정의된 값이 있으면 해당 형식을 변경하려고 하면 동의 대화 상자가 나타납니다. 대화 상자는 모든 변수 값이 다시 설정되고 이 변경이 소비자 항목 쪽에서 호환성이 손상되는 변경이 될 수 있음을 경고합니다.

다음 두 요구 사항을 모두 충족 하는 한 최대 1,000개의 변수 와 최대 1,000개의 값 집합이 있을 수 있습니다.
- 대체 값 집합의 총 셀 수는 10,000개 미만입니다.
- 항목의 크기가 1MB를 초과하지 않습니다.
이러한 요구 사항은 변경 내용을 저장할 때 유효성을 검사합니다.
메모 필드에는 최대 2,048자까지 입력할 수 있습니다.
값 집합 설명 필드에는 최대 2,048자까지 입력할 수 있습니다.

이 페이지가 도움이 되었나요?