변수 라이브러리를 사용하는 방법 알아보기 - Microsoft Fabric

이 자습서에서는 Microsoft Fabric 파이프라인에서 동적 콘텐츠를 사용하는 방법을 보여 줍니다. 변수 라이브러리 항목을 만들고 변수를 추가할 때 배포 파이프라인의 다양한 단계에 대한 값을 자동화할 수 있습니다. 이 자습서에서는 한 레이크하우스에서 다른 레이크하우스로 데이터를 복사합니다. 그런 다음 변수 라이브러리를 사용하여 복사 작업의 원본 및 대상 값을 설정합니다.

이 자습서에서는 다음을 수행합니다.

변수 라이브러리를 만듭니다.
라이브러리에 변수를 추가합니다.
변수에 대한 추가 값 집합을 정의합니다.
작업 영역의 다른 항목(파이프라인)에서 변수를 사용합니다.
Git 리포지토리에서 변수를 편집합니다.
배포 파이프라인을 만들고 변수 라이브러리를 배포합니다.
배포 파이프라인의 대상 단계에서 설정된 활성 값을 변경합니다.
변수의 값이 각 단계에서 설정된 활성 값을 준수하는지 표시합니다.

다음 다이어그램은 이 자습서의 작업 영역 레이아웃을 보여줍니다.

필수 조건

활성 구독이 있는 Fabric 테넌트 계정 무료로 계정을 만듭니다.
다음 테넌트 스위치 는 관리 포털에서 사용하도록 설정됩니다.
- 사용자가 패브릭 항목을 만들 수 있습니다.
테넌트 관리자, 용량 관리자 또는 작업 영역 관리자는 조직의 설정에 따라 이러한 스위치를 사용하도록 설정할 수 있습니다.

단계 LH 작업 영역 만들기, 샘플 데이터로 레이크하우스 SourceLH_Stage 및 파이프라인 Pipeline_Stage

먼저 초기 준비 데이터로 사용할 작업 영역 및 레이크하우스를 만듭니다.

Power BI로 이동합니다.
사이드바에서 작업 영역을 선택합니다.
작업 영역을 만듭니다. 스테이지 LH를 호출합니다.
레이크하우스를 만듭니다.
1. 작업 영역 맨 위에서 새 항목을 선택합니다.
2. Store 데이터에서 Lakehouse를 선택합니다.
3. 이름 SourceLH_Stage 입력한 다음 만들기를 선택합니다.
파이프라인 만들기:
1. 레이크하우스에서 새 파이프라인을 선택합니다.
2. 이름 Pipeline_Stage 입력한 다음 만들기를 선택합니다.
3. Lakehouse에 데이터 복사 마법사의 데이터 원본 선택 페이지에서 샘플 데이터를 선택합니다.
4. 공휴일을 선택합니다.
5. 샘플 데이터 로드가 완료되면 다음을 선택합니다.
6. 데이터 대상에 연결 페이지에서 다음을 선택합니다.
7. 검토 + 저장 페이지에서 저장 + 실행을 선택합니다.

변수 작업 영역을 사용하여 원본 LH 만들기

이제 변수 라이브러리에서 작업하고 사용할 작업 영역을 만듭니다.

Power BI로 이동합니다.
사이드바에서 작업 영역을 선택합니다.
작업 영역을 만듭니다. 변수를 사용하여 원본 LH를 호출합니다.

SourceLH_Dev, SourceLH_Test 및 SourceLH_Prod 레이크하우스 만들기

다음으로, 변수 라이브러리와 함께 사용할 세 개의 레이크하우스를 만듭니다.

첫 번째 레이크하우스를 만듭니다.
1. 사이드바에서 변수 작업 영역이 있는 원본 LH를 선택합니다.
2. 새 항목을 선택합니다.
3. Store 데이터에서 Lakehouse를 선택합니다.
4. 이름 SourceLH_Dev 입력한 다음 만들기를 선택합니다.
이전 단계에 따라 두 번째 레이크하우스를 만듭니다. 이름을 SourceLH_Test.
이전 단계에 따라 세 번째 레이크하우스를 만듭니다. 이름을 SourceLH_Prod.
사이드바에서 변수 작업 영역이 있는 원본 LH를 선택하고 새로 만든 모든 레이크하우스가 포함되어 있는지 확인합니다.

lakehouses에 대한 작업 영역 ID 및 개체 ID 가져오기

다음 단계에서는 변수 라이브러리에서 사용할 고유 식별자를 가져옵니다.

Power BI의 사이드바에서 LH 단계 작업 영역을 선택합니다.
작업 영역에서 SourceLH_Stage Lakehouse를 선택합니다.
URL에서 작업 영역 ID 및 Lakehouse 개체 ID를 복사합니다.
변수 작업 영역이 있는 원본 LH의 SourceLH_Dev 및 SourceLH_Test 레이크하우스에 대해 이전 단계를 반복합니다.

변수가 있는 변수 라이브러리 만들기

이제 변수 라이브러리를 만듭니다.

변수 작업 영역 이 있는 원본 LH 에서 새 항목을 선택합니다.
데이터 개발에서 **변수 라이브러리 **를 선택합니다.
라이브러리 WS 변수의 이름을 지정한 다음 만들기를 선택합니다.
새 변수를 선택합니다.

다음 변수를 만듭니다.

이름	유형	기본값 집합
`Source_LH`	String	<SourceLH_Stage 레이크하우스의 GUID>
`Source_WSID`	String	<SourceLH_Stage 작업 영역의 GUID>
`Destination_LH`	String	<SourceLH_Dev 레이크하우스의 GUID>
`Destination_WSID`	String	<SourceLH_Dev 작업 영역의 GUID>
`SourceTable_Name`	String	`Processed`
`DestinationTable_Name`	String	`DevCopiedData`

저장을 선택합니다.

대체 값 집합 만들기

다음 단계에서는 변수 라이브러리에 대체 값 집합을 추가합니다.

첫 번째 값 집합을 만듭니다.

WS 변수 변수 라이브러리에서 값 집합 추가를 선택합니다.
이름에 대해 테스트 VS 를 입력한 다음 만들기를 선택합니다.

다음 변수를 만듭니다.

이름	유형	기본값 집합
`Source_LH`	String	<SourceLH_Dev 레이크하우스의 GUID>
`Source_WSID`	String	<SourceLH_Dev 작업 영역의 GUID>
`Destination_LH`	String	<SourceLH_Test 레이크하우스의 GUID>
`Destination_WSID`	String	<SourceLH_Test 작업 영역의 GUID>
`SourceTable_Name`	String	`DevCopiedData`
`DestinationTable_Name`	String	`TestCopiedData`

[동의>]을 선택합니다.

두 번째 값 집합을 만듭니다.

값 집합 추가를 선택합니다.
이름에 Prod VS 를 입력한 다음 만들기를 선택합니다.

다음 변수를 만듭니다.

이름	유형	기본값 집합
`Source_LH`	String	<SourceLH_Test 레이크하우스의 GUID>
`Source_WSID`	String	<SourceLH_Test 작업 영역의 GUID>
`Destination_LH`	String	<SourceLH_Prod 레이크하우스의 GUID>
`Destination_WSID`	String	<SourceLH_Prod 작업 영역의 GUID>
`SourceTable_Name`	String	`TestCopiedData`
`DestinationTable_Name`	String	`ProdCopiedData`

[동의>]을 선택합니다.

Pipeline_Deploy 파이프라인 만들기 및 변수 선언

다음 단계에서는 파이프라인을 만들고 변수를 선언합니다.

변수 작업 영역 이 있는 원본 LH 에서 새 항목을 선택합니다.
데이터 가져오기에서 파이프라인을 선택합니다.
이름 Pipeline_Deploy 입력한 다음 만들기를 선택합니다.
캔버스에 데이터 >추가 복사를 선택합니다.
데이터 복사에서 포커스가 없도록 캔버스를 선택합니다.
**라이브러리 변수 **를 선택합니다.

새로 만들기를 선택한 다음, 다음 변수를 추가합니다.

이름	라이브러리	변수 이름	유형
`SourceLH`	WS 변수	`Source_LH`	String
`SourceWSID`	WS 변수	`Source_WSID`	String
`DestinationLH`	WS 변수	`Destination_LH`	String
`DestinationWSID`	WS 변수	`Destination_WSID`	String
`SourceTableName`	WS 변수	`SourceTable_Name`	String
`DestinationTableName`	WS 변수	`DestinationTable_Name`	String

저장을 선택합니다.

Pipeline_Deploy 파이프라인에 대한 원본 연결 구성

다음 단계에서는 파이프라인에 대한 원본 연결을 구성합니다.

변수 작업 영역이 있는 원본 LH 에서 Pipeline_Deploy 이동합니다.
캔버스에서 데이터 복사 에 포커스가 있도록 데이터 복사를 선택합니다.
원본을 선택합니다.
SourceLH 구성:
1. 원본>연결에서 동적 콘텐츠 추가를 선택합니다.
2. 줄임표(...)를 선택한 다음 ** 라이브러리 변수 **를 선택합니다.
3. SourceLH를 선택합니다. 상자를 으로 @pipeline().libraryVariables.SourceLH채웁니다. 확인을 선택합니다.
SourceWSID 구성:
1. 원본>작업 영역 ID에서 동적 콘텐츠 추가를 선택합니다.
2. 줄임표(...)를 선택한 다음 ** 라이브러리 변수 **를 선택합니다.
3. SourceWSID를 선택합니다. 상자를 으로 @pipeline().libraryVariables.SourceWSID채웁니다. 확인을 선택합니다.
SourceTableName 구성:
1. 원본>테이블에서수동으로 Enter 키를 선택하고 테이블 이름을 선택한 다음 동적 콘텐츠 추가를 선택합니다.
2. 줄임표(...)를 선택한 다음 ** 라이브러리 변수 **를 선택합니다.
3. SourceTableName을 선택합니다. 상자를 으로 @pipeline().libraryVariables.SourceTableName채웁니다. 확인을 선택합니다.
원본 연결이 설정되었으므로 테스트할 수 있습니다. 미리 보기 데이터를 선택한 다음 플라이아웃에서 확인을 선택합니다. 데이터가 채워지면 데이터 미리 보기를 닫을 수 있습니다.

Pipeline_Deploy 파이프라인에 대한 대상 연결 구성

다음 단계에서는 파이프라인에 대한 대상 연결을 구성합니다.

변수 작업 영역이 있는 원본 LH 에서 Pipeline_Deploy 이동합니다.
캔버스에서 데이터 복사 에 포커스가 있도록 데이터 복사를 선택합니다.
대상을 선택합니다.
SourceLH 구성:
1. 대상>연결에서 동적 콘텐츠 추가를 선택합니다.
2. 줄임표(...)를 선택한 다음 ** 라이브러리 변수 **를 선택합니다.
3. SourceLH를 선택합니다. 상자를 으로 @pipeline().libraryVariables.DestinationLH채웁니다. 확인을 선택합니다.
DestinationWSID 구성:
1. 대상>작업 영역 ID에서 동적 콘텐츠 추가를 선택합니다.
2. 줄임표(...)를 선택한 다음 ** 라이브러리 변수 **를 선택합니다.
3. DestinationWSID를 선택합니다. 상자를 으로 @pipeline().libraryVariables.DestinationWSID채웁니다. 확인을 선택합니다.
DestinationTableName 구성:
1. 대상>테이블에서수동으로 Enter 키를 선택하고 테이블 이름을 선택한 다음 동적 콘텐츠 추가를 선택합니다.
2. 줄임표(...)를 선택한 다음 ** 라이브러리 변수 **를 선택합니다.
3. DestinationTableName을 선택합니다. 상자를 으로 @pipeline().libraryVariables.DestinationTableName채웁니다. 확인을 선택합니다.
이제 대상 연결이 설정되었으므로 파이프라인을 저장하고 실행을 선택합니다. 성공적으로 실행되었는지 확인합니다.

배포 파이프라인 만들기

이제 배포 파이프라인을 만듭니다.

변수 작업 영역이 있는 원본 LH 에서 배포 파이프라인 만들기를 선택합니다.
파이프라인 이름을 Deployment_Pipeline_Var 다음을 선택합니다.
배포 파이프라인에서 만들기를 선택하고 계속합니다.
개발 단계의 경우:
1. 드롭다운 목록에서 작업 영역에 대한 변수가 있는 원본 LH 를 선택합니다. 그런 다음 , 확인 표시 할당 을 선택합니다.
2. 계속을 선택합니다. 이제 스테이지가 작업 영역의 항목으로 채워집니다.
테스트 단계의 경우:
1. 맨 위에 있는 확인란을 선택하여 모든 항목을 선택합니다. 그런 다음 SourceLH_Dev 레이크 하우스에 대한 확인란의 선택을 취소합니다.
2. 배포 단추를 선택합니다. 배포를 다시 선택합니다. 이제 테스트 스테이지가 채워집니다.
프로덕션 단계의 경우:
1. 맨 위에 있는 확인란을 선택하여 모든 항목을 선택합니다. 그런 다음 SourceLH_Test 레이크 하우스에 대한 확인란의 선택을 취소합니다.
2. 배포 단추를 선택합니다. 배포를 다시 선택합니다. 이제 프로덕션 단계가 채워집니다.

각 단계에 대해 변수 라이브러리의 활성 집합 설정

다음 단계에서는 배포 파이프라인의 각 단계에 대한 활성 집합을 구성합니다.

테스트 단계에 대한 활성 집합을 구성합니다.
1. 사이드바에서 Deployment_Pipeline_Var 파이프라인을 선택합니다.
2. 테스트 단계를 선택합니다.
3. WS 변수를 선택합니다.
4. 줄임표(...)를 선택한 다음 활성으로 설정을 선택합니다. 활성으로 설정 단추를 선택합니다.
  
  이제 활성 집합이 구성되었습니다.
5. [동의>]을 선택합니다.
Prod 단계에 대한 활성 집합을 구성합니다.
1. 사이드바에서 Deployment_Pipeline_Var 파이프라인을 선택합니다.
2. Prod 단계를 선택합니다.
3. WS 변수를 선택합니다.
4. 줄임표(...)를 선택한 다음 활성으로 설정을 선택합니다. 활성으로 설정 단추를 선택합니다.
5. [동의>]을 선택합니다.

변수 라이브러리 확인 및 테스트

이제 변수 라이브러리를 설정하고 배포 파이프라인의 각 단계에 대해 모든 활성 집합을 구성했으므로 다음을 확인할 수 있습니다.

SourceLHs_Dev 레이크하우스를 확인합니다.
1. 변수 작업 영역이 있는 원본 LH 에서 SourceLHs_Dev 레이크하우스를 선택합니다.
2. Lakehouse에서 SQL 분석 엔드포인트로 연결을 변경합니다.
3. 탐색기에서 스키마>>.
4. DevCopiedData 테이블이 표시되는지 확인합니다.
SourceLHs_Test 레이크하우스로 전환하고 이전 단계를 반복합니다.

Test VS 활성 집합을 사용하여 파이프라인을 아직 실행하지 않았기 때문에 TestCopiedData 테이블이 표시되지 않아야 합니다.
SourceLHs_Prod 레이크하우스로 전환하고 이전 단계를 반복합니다.

Prod VS 활성 집합을 사용하여 파이프라인을 아직 실행하지 않았으므로 ProdCopiedData 테이블이 표시되지 않아야 합니다.
Deployment_Pipeline_Var 파이프라인의 테스트 단계를 확인합니다.
1. Deployment_Pipeline_Var 파이프라인으로 전환하고 테스트 단계를 선택합니다.
2. Pipeline_Deploy 파이프라인을 선택합니다.
3. 실행을 선택합니다. 이 프로세스는 성공적으로 완료되어야 합니다.
SourceLHs_Test 레이크하우스를 다시 확인합니다.
1. SourceLHs_Test 레이크하우스로 전환합니다.
2. Lakehouse에서 SQL 분석 엔드포인트로 연결을 변경합니다.
3. 탐색기에서 스키마>>.
4. TestCopiedData 테이블이 표시되는지 확인합니다.
Deployment_Pipeline_Var 파이프라인의 프로덕션 단계를 확인합니다.
1. Deployment_Pipeline_Var 파이프라인으로 전환하고 프로덕션 단계를 선택합니다.
2. Pipeline_Deploy 파이프라인을 선택합니다.
3. 실행을 선택합니다. 이 프로세스는 성공적으로 완료되어야 합니다.
SourceLHs_Prod 레이크하우스를 다시 확인합니다.
1. SourceLHs_Prod 레이크하우스로 전환합니다.
2. Lakehouse에서 SQL 분석 엔드포인트로 연결을 변경합니다.
3. 탐색기에서 스키마>>.
4. ProdCopiedData 테이블이 표시되는지 확인합니다.

Git에서 변수 값 사용자 지정(선택 사항)

변수 라이브러리가 Git에 표시되는 방식을 확인하거나 Git 리포지토리에서 변수를 편집하려면 다음을 수행합니다.

작업 영역에서 원본 제어 를 선택하고 작업 영역을 Git 리포지토리에 연결합니다.
소스 제어 창에서 커밋을 선택하여 작업 영역 콘텐츠를 Git 리포지토리에 푸시합니다.

Git 리포지토리에는 작업 영역의 각 항목에 대한 폴더가 있습니다. WS 변수라는 폴더입니다. VariableLibrary는 변수 라이브러리 항목을 나타냅니다. 이 폴더의 내용에 대한 자세한 내용은 변수 라이브러리 CI/CD를 참조하세요.

valueSets 폴더의 ProdVS.json 및 TestVS.json 파일을 비교합니다. 변수가 overrides 다른 값으로 설정되어 있는지 확인합니다. 이러한 값은 UI에서 직접 편집하거나 Git에서 이 파일을 편집하고 작업 영역으로 업데이트하여 편집할 수 있습니다.

{
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

{
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

피드백

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

Last updated on 2025-09-26

다음을 통해 공유

자습서: 변수 라이브러리를 사용하여 항목 구성 사용자 지정 및 공유

필수 조건

단계 LH 작업 영역 만들기, 샘플 데이터로 레이크하우스 SourceLH_Stage 및 파이프라인 Pipeline_Stage

변수 작업 영역을 사용하여 원본 LH 만들기

SourceLH_Dev, SourceLH_Test 및 SourceLH_Prod 레이크하우스 만들기

lakehouses에 대한 작업 영역 ID 및 개체 ID 가져오기

변수가 있는 변수 라이브러리 만들기

대체 값 집합 만들기

Pipeline_Deploy 파이프라인 만들기 및 변수 선언

Pipeline_Deploy 파이프라인에 대한 원본 연결 구성

Pipeline_Deploy 파이프라인에 대한 대상 연결 구성

배포 파이프라인 만들기

각 단계에 대해 변수 라이브러리의 활성 집합 설정

변수 라이브러리 확인 및 테스트

Git에서 변수 값 사용자 지정(선택 사항)

관련 콘텐츠

피드백

추가 리소스