Microsoft Fabric의 변수 라이브러리 항목에는 변수 목록과 해당 기본값이 포함됩니다. 또한 대체 값을 보유하는 다른 값 집합을 포함할 수도 있습니다.
변수 라이브러리의 각 변수에는 다음과 같은 속성이 있습니다.
- 이름
- 참고(선택 사항), 최대 2,048자
- 유형
- 기본값 설정
- 대체 값 집합(선택 사항)
명명 규칙
변수 라이브러리 이름
변수 라이브러리 항목 자체의 이름은 다음 규칙을 따라야 합니다.
- 비어 있지 않음
- 선행 또는 후행 공백이 없습니다.
- 문자로 시작
- 문자, 숫자, 밑줄, 하이픈 및 공백을 포함할 수 있습니다.
- 길이가 256자를 초과하지 않음
변수 라이브러리 이름은 대/소문 자를 구분하지 않습니다 .
변수 이름
변수 라이브러리 내의 변수 이름은 다음 규칙을 따라야 합니다.
- 비어 있지 않음
- 선행 또는 후행 공백이 없습니다.
- 문자 또는 밑줄로 시작
- 문자, 숫자, 밑줄 및 하이픈을 포함할 수 있습니다.
- 길이가 256자를 초과하지 않음
변수 이름은 대/소문자를 구분하지 않습니다.
값 집합 이름
값 집합 이름에는 변수 이름과 동일한 제한이 있습니다.
변수 유형
변수에 값을 추가하려면 먼저 변수 형식을 정의해야 합니다. 변수 라이브러리의 변수는 다음 형식 중 어느 것이든 될 수 있습니다.
문자열: 모든 문자입니다. 비어 있거나 비워 둘
null수 있습니다.부울:
True또는False.DateTime: ISO 8601 표준 yyyy-MM-ddTHH:mm:ss.xxxZ로 표시되는 날짜 및 시간, 여기서:
- yyyy-MM-dd 는 4자리 연도이며, 그 다음으로 두 자리 달과 두 자리의 날입니다.
- T 는 날짜와 시간을 구분합니다.
- HH:mm:ss.xxx 는 24시간 형식의 두 자리 시간이며, 그 뒤에 두 자리 분, 두 자리 초, 세 자리 밀리초가 잇습니다.
- Z 는 시간이 UTC(협정 세계시)에 있음을 나타냅니다.
예제는
2025-01-14T16:15:20.123Z입니다.숫자: 임의의 숫자입니다.
GUID: 전역적으로 고유한 식별자입니다.
정수: 양수, 음수 또는 0일 수 있는 정수입니다.
변수에 정의된 값이 있으면 해당 형식을 변경하려고 하면 동의 대화 상자가 나타납니다. 대화 상자는 모든 변수 값이 다시 설정되고 이 변경이 소비자 항목 쪽에서 호환성이 손상되는 변경이 될 수 있음을 경고합니다.
대체 값 집합
변수 라이브러리에 새 값 집합을 만들면 새 값이 기본값에 대한 포인터로 설정됩니다. 이를 고정 값으로 변경할 수 있습니다.
대체 값 집합에서 변수 값을 변경하면 값 집합에 대한 대체 값이 JSON 파일에 저장됩니다. 값 집합이 표시되는 순서를 변경하거나 Git의 이 JSON 파일에서 대체 값 집합의 변수 값을 변경할 수 있습니다.
고려사항 및 제한사항
크기 제한
다음 두 요구 사항을 모두 충족 하는 한 최대 1,000개의 변수 와 최대 1,000개의 값 집합이 있을 수 있습니다.
- 대체 값 집합의 총 셀 수는 10,000개 미만입니다.
- 항목의 크기가 1MB를 초과하지 않습니다.
이러한 요구 사항은 변경 내용을 저장할 때 유효성을 검사합니다.
메모 필드에는 최대 2,048자까지 입력할 수 있습니다.
값 집합 설명 필드에는 최대 2,048자까지 입력할 수 있습니다.
대체 값 집합에 대한 제한 사항
- 변수 라이브러리의 대체 값 집합은 추가한 순서대로 표시됩니다. 현재는 UI에서 순서를 변경할 수 없습니다. 순서를 변경하려면 JSON 파일을 직접 편집합니다.
- 각 값 집합의 이름은 변수 라이브러리 내에서 고유해야 합니다.
- 변수 이름은 변수 라이브러리 내에서 고유해야 합니다. 다른 항목에 있는 경우 작업 영역에서 이름이 같은 두 개의 변수를 가질 수 있습니다.
- 변수 라이브러리에는 항상 한 번에 하나의 활성 값만 설정됩니다. 활성 상태인 동안에는 값 집합을 삭제할 수 없습니다. 삭제하려면 먼저 다른 값 집합을 활성으로 구성합니다. 배포 파이프라인의 각 단계에 대해 다른 활성 값을 설정할 수 있습니다.