항목 참조 변수 형식(미리 보기)

유연성과 확장성을 향상시키기 위해 기존 기본 변수 형식과 함께 고급 변수를 도입하고 있습니다. 이러한 고급 변수는 외부 및 내부 연결 매개 변수화(예: Snowflake, AWS, OneLake)와 같은 주요 요구 사항을 충족하도록 설계되었습니다.

항목 참조 변수는 작업 영역 ID 및 항목 ID를 저장하여 기존 패브릭 항목(예: Lakehouse, Notebook 또는 데이터 파이프라인)에 대한 참조를 보유하기 위해 패브릭 변수 라이브러리 내에서 사용되는 고급 변수 형식입니다. 이 유형의 변수를 사용하면 내부 연결 매개 변수화가 가능하므로 개발자는 배포 단계 또는 작업 영역 컨텍스트에 따라 항목을 특정 패브릭 항목에 동적으로 연결할 수 있습니다.

사용 방법

항목 참조 변수는 변수 라이브러리의 다른 변수와 마찬가지로 사용할 수 있습니다.

Microsoft Fabric에 로그인
작업 영역 및 변수 라이브러리로 이동합니다.
맨 위에서 + 새 변수를 선택합니다.
변수의 이름을 입력하고 형식에 대한 항목 참조 를 선택한 다음 ... 를 클릭하여 값을 선택합니다.
그러면 대화 상자가 열리고 원하는 항목이 선택됩니다. 사용 권한이 있는 모든 항목이 선택 가능하게 표시됩니다. 왼쪽의 탐색기를 사용하여 작업 영역별로 목록을 필터링합니다. 오른쪽 위 모서리에 있는 필터를 사용하여 형식별로 필터링합니다.

6. 선택하면 varlib 페이지에 다음과 같이 표시됩니다. 항목의 이름을 표시하는 읽기 전용 구성 요소로 표시됩니다.

항목 참조를 편집해야 하거나 값을 다시 확인해야 하는 경우:

추가 세부 정보를 보려면 값을 클릭합니다.
이 값 또는 다른 값 집합의 값을 편집하려면 값 옆의 단추를 클릭합니다.

작동 방식

항목 참조 변수의 값은 기본적으로 작업 영역 ID + 항목 ID로 식별되는 패브릭 항목에 대한 정적 포인터입니다. 값은 대상 항목의 작업 영역 및 항목 자체에 해당하는 GUID 쌍으로 저장됩니다. 예를 들어 참조는 다음과 같이 내부적으로 저장될 수 있습니다.

WorkspaceID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

이러한 두 ID는 함께 참조된 항목을 고유하게 식별합니다.

항목 참조로 작업할 때는 다음 사항에 유의하세요.

항목 참조를 사용하면 내부 연결 매개 변수화를 사용할 수 있으므로 개발자는 배포 단계 또는 작업 영역 컨텍스트에 따라 항목을 특정 패브릭 리소스에 동적으로 연결할 수 있습니다.
참조는 정적이며 특정 항목을 가리키며 환경 간에 자동으로 조정되지 않습니다.
스테이지별 변형의 경우 각 집합이 다른 정적 항목(예: 스테이지당 다른 레이크하우스)을 가리킬 수 있는 값 집합을 사용합니다.
호환성을 보장하고 런타임 오류를 방지하려면 값 집합의 모든 값이 동일한 항목 형식 이어야 합니다 . 그러나 값 집합 간에 동일한 항목 형식을 적용하지는 않습니다.

지원되는 항목

다음은 항목 참조를 사용하여 현재 지원되는 항목 목록입니다.

비고

%%configure을 통해 전자 필기장이 지원되지 않습니다.

제한점

현재 패브릭 항목 및 의미 체계 모델만 참조할 수 있습니다. Datamarts와 같은 다른 Power BI 항목인 Dataflow Gen1은 현재 지원되지 않습니다.

항목 참조를 만들거나 사용하는 데 필요한 권한

항목 참조 변수를 사용하려면 다음 두 가지 권한 계층이 포함됩니다.

만들기/편집 - 모든 작업 영역 참가자가 변수 값을 수정할 수 있지만 항목 참조 변수는 사용자가 읽기 권한이 있는 값 항목으로만 설정할 수 있도록 허용합니다. 이는 모든 값, 기본 활성 값 집합 또는 기타 값 집합에 적용됩니다. 변수 라이브러리 항목을 저장하는 동안 해당 값이 변경되지 않은 상태로 유지되더라도 항목을 저장하는 사용자에 대한 항목 참조 변수의 활성 값에 대한 권한 검사가 수행됩니다.
항목 참조 변수 사용 - 소비자 항목에서 변수에 대한 참조를 만들거나 업데이트하는 경우 활성 값 집합의 항목에 대한 읽기 권한이 없으면 사용자는 항목 참조 변수에 대한 참조를 설정할 수 없습니다.

권한 유효성 검사

권한 유효성 검사는 다음과 같은 사용 사례에서 트리거됩니다.

편집할 때 항목 참조 변수가 있는 변수 라이브러리 항목을 편집합니다. 다음 시나리오에서는 참조된 항목이 존재하고 사용자가 활성 값 집합의 모든 항목 참조 값에 대해 최소한 읽기 권한이 있는지 확인합니다.
UI - 변수 라이브러리 항목을 저장하는 동안 해당 값이 변경되지 않은 상태로 유지되더라도 항목을 저장하는 사용자에 대한 항목 참조 변수의 활성 값에 대한 권한 검사가 수행됩니다.
API/Git 업데이트 - 업데이트 중에 사용 권한 유효성 검사가 수행되며 업데이트된 작업 영역의 항목 참조 활성 값에 대한 읽기 권한이 없으면 실패합니다.
배포 - 대상 작업 영역의 Item ref 활성 값에 대한 읽기 권한이 없으면 변수 라이브러리 항목의 배포가 실패합니다.
변수 라이브러리 페이지(UI 전용)에서 항목 참조 추가 세부정보를 확인합니다. 변수 라이브러리(WS 뷰어 이상의 권한 수준)에 액세스할 수 있는 사용자는 참조된 항목 변수에 대한 권한이 없는 경우, UI에서 해당 세부 정보가 표시되지 않습니다. 대신 세부 정보 구성 요소가 아닌 호버 메시지와 함께 항목 ID가 표시됩니다.

항목 참조 변수 만들기/편집
- UI - 모든 값 집합의 값(기본값 또는 기타)을 업데이트할 때 사용자는 적어도 읽기 권한이 있는 항목만 표시하는 목록에서 항목을 선택할 수 있습니다.
- API/Git 업데이트 또는 배포 - 위의 변수 라이브러리 편집 항목을 참조하세요.
소비자 항목에서 항목 참조 변수 사용
- UI - 변수에 대한 참조 만들기 - '변수 선택' UI 대화 상자를 사용하여 항목에서 '항목 참조' 변수에 대한 참조를 만들 때(예: Lakehouse 및 데이터 파이프라인의 바로 가기) 참조를 만드는 사용자에게 'item reference' 변수의 항목에 대한 읽기 권한이 있는지 확인합니다(유효성 검사는 활성 값에만 해당). 그렇지 않은 경우 사용자에게 항목의 ID만 표시됩니다.

CI/CD 파이프라인 및 배포 단계 간 동작

변수 라이브러리를 사용하면 단계별 구성에 항목 참조 변수를 사용하여 환경(개발, 테스트, Prod)에서 패브릭 콘텐츠에 대한 CI/CD를 사용할 수 있습니다. 다음 사항을 염두에 두십시오.

정적 참조

항목 참조는 특정 작업 영역 및 항목 ID에 연결됩니다.
새 단계에 배포하는 경우 이러한 참조는 수동으로 업데이트하지 않는 한 원래 작업 영역을 가리킵니다.
각 스테이지에 대해 여러 Value-Sets 사용하고 수동으로 또는 API 스크립트를 통해 올바른 집합을 활성화합니다.

자세한 내용은 변수 라이브러리의 값 집합을 참조하세요.

Git 및 API의 표현

변수 라이브러리는 코드로 관리됩니다. Git 또는 REST API를 사용하여 항목 참조 변수에는 명확한 JSON 형식이 있습니다. 모든 변수는 변수 라이브러리의 정의 파일(일반적으로 .jsonGit에 저장됨)에 이름, 형식 및 값과 같은 속성을 나열합니다.

항목 참조(정적) 변수의 경우 값은 작업 영역 및 항목 ID에 대한 구조화된 데이터입니다. 예제:


{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

API를 통해 작업할 때 다음 사항을 기억하세요.

ID만 저장됩니다. 이름 및 메타데이터는 런타임에 검색되거나 Fabric에서 캐시됩니다.
API를 통해 생성/업데이트하면 작업 영역 및 항목 ID를 제공합니다. 잘못된 ID로 인해 오류가 발생합니다.

변수 라이브러리 개요
변수 형식
값 집합
변수 라이브러리 권한](./variable-library-permissions.md)

피드백

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

Last updated on 2026-01-29