빠른 시작 - 워크로드 샘플 실행
이 빠른 시작 가이드에서는 샘플 워크로드를 사용하여 Microsoft Fabric 워크로드를 만들고 실행하는 방법을 보여 줍니다.
이 샘플에서는 레이크하우스에서 데이터를 저장하고 읽는 방법을 보여 줍니다. 이렇게 하려면 On-Behalf-Of(OBO) 흐름에서Azure Storage 서비스에 대한 토큰을 생성해야 합니다.
필수 조건
워크로드 개발을 위해 설정된 환경입니다.
Azure Storage 이 테넌트에 설치되지 않은 경우, 테넌트의 전역 관리자 가 되어야 합니다.
ASP.NET Core 런타임 6.0 - ASP.NET Core는 샘플 워크로드를 빌드하는 데 사용됩니다.
.NET 6.0 런타임 - .NET은 샘플 워크로드를 빌드하는 데 사용됩니다.
1단계: Azure Storage 설정
Azure Storage를 사용하려면 동의가 필요합니다. 이 단계에서는 Azure Storage가 테넌트에 설치되어 있는지 확인하고, 설치되어 있지 않으면 설치합니다.
Azure Portal
로그인합니다. Enterprise 애플리케이션을 검색하여 검색 결과에서을 선택합니다.
애플리케이션 유형 필터 드롭다운 목록에서 모든 애플리케이션 을 선택한 다음, 적용을 선택합니다.
애플리케이션 이름 또는 개체 ID로 검색 검색 상자에 Azure Storage를 입력합니다.
Azure Storage가 나열되지 않은 경우, 관리자 권한으로 PowerShell을 열고 다음 명령을 실행합니다.
Install-Module az Import-Module az Connect-AzureAD New-AzureADServicePrincipal -AppId e406a681-f3d4-42a8-90b6-c2b029497af1
2단계: 샘플 다운로드
샘플 워크로드를 실행하려면 다음 단계를 수행합니다.
샘플 프로젝트 디렉터리 리포지토리로 이동하여 코드를 선택한 후, ZIP다운로드를 선택합니다.
zip 파일의 내용을 컴퓨터의 로컬 디렉터리에 추출합니다. microsoft-Fabric-workload-development-sample-main라는 새 폴더가 생성됩니다.
3단계: 테넌트 ID 가져오기
테넌트 ID를 가져오려면 다음 단계를 수행합니다.
워크로드를 만드는 데 사용할 사용자로 Fabric에 로그인합니다.
도움말 & 지원(물음표 ?)을 선택한 다음 정보선택합니다.
테넌트 URL에서
https://app.powerbi.com/home?ctid=뒤에 있는 숫자와 문자로 된 문자열을 복사합니다. 테넌트 ID입니다.예를 들어 테넌트 URL이
https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff경우 테넌트 ID는bbbbcccc-1111-dddd-2222-eeee3333ffff.
4단계: Microsoft Entra ID 애플리케이션 만들기
제공된 스크립트를 사용하여 Azure Entra ID 애플리케이션을 만듭니다.
PowerShell열기.
Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication 폴더로 이동합니다.
이 단계에서 명령을 실행합니다. 인증하려면 사용 중인 사용자의 자격 증명을 사용하여 워크로드를 만듭니다.
.\CreateDevAADApp.ps1 -applicationName "myWorkloadApp" -workloadName "Org.WorkloadSample" -tenantId "<your-tenant-id>"스크립트의 출력에서 다음 세부 정보를 복사합니다.
-
ApplicationIdUri / 대상 - 예를 들어
api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR -
RedirectURI -
http://localhost:60006/close -
애플리케이션 ID - 예를 들어
00001111-aaaa-2222-bbbb-3333cccc4444 -
비밀 - 예를 들면
aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2
-
ApplicationIdUri / 대상 - 예를 들어
5단계: .env.dev 파일 업데이트
Microsoft-Fabric-workload-development-sample-main 폴더로 이동한 다음 프론트엔드 폴더로 이동합니다.
텍스트 편집기를 사용하여 파일 .env.dev 엽니다.
다음 세부 정보를 입력합니다.
-
DEV_AAD_CONFIG_AUDIENCE= - 스크립트 출력의 대상 그룹입니다. 예를 들어
DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR. -
DEV_AAD_CONFIG_APPID= - 스크립트 출력의 애플리케이션 ID입니다. 예를 들어
DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.
-
DEV_AAD_CONFIG_AUDIENCE= - 스크립트 출력의 대상 그룹입니다. 예를 들어
.env.dev 파일을 저장합니다.
6단계: 프런트 엔드 실행
PowerShell 열고 다음을 수행합니다.
Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend 폴더로 이동합니다.
종속성을 설치하려면
npm install명령을 실행합니다. node_modules라는 새 폴더가 만들어집니다.프런트 엔드를 시작하려면
npm start명령을 실행합니다.프런트 엔드가 성공적으로 실행되면, PowerShell에서 가과 함께 성공적으로 포함된 메시지가 표시되며, 웹 브라우저가
http://localhost:60006/URL로 자동으로 열립니다. 프런트엔드가 성공적으로 실행되고 있는지 확인하려면, 브라우저에서http://localhost:60006/manifests페이지로 이동합니다.
7단계: Visual Studio 2022 열기
이 빠른 시작의 나머지 단계는 Visual Studio 2022에서 수행됩니다. 이 단계를 사용하여 Visual Studio 2022에서 솔루션을 엽니다. 솔루션이 열려 있으면 나머지 단계를 완료하는 동안 Visual Studio를 열어 둘 수 있습니다.
Microsoft-Fabric-workload-development-sample-main 폴더로 이동한 후, 백엔드 폴더로 이동합니다.
Visual Studio 2022에서
파일 Fabric_Extension_BE_Boilerplate.sln 을 엽니다.
8단계: 백 엔드 파일 업데이트
솔루션 탐색기에서 Fabric_Extension_BE_Boilerplate 을 확장하고, appsettings.json 파일을 열어 다음 필드를 채우세요.
-
PublisherTenantId - 귀하의 테넌트 ID입니다. 예를 들어
PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff". -
ClientId - 스크립트 출력의 애플리케이션 ID입니다. 예를 들어
ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444". -
ClientSecret - 스크립트의 출력에서 얻은 키. 예를 들어
ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2". -
대상 - 스크립트 출력의 ApplicationIdUri/대상. 예를 들어
Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".
-
PublisherTenantId - 귀하의 테넌트 ID입니다. 예를 들어
appsettings.json 파일을 저장합니다.
솔루션 탐색기에서 패키지 > 매니페스트 폴더를 확장하고, WorkloadManifest.xml 파일을 열어 다음 필드를 채우세요.
-
AppID - 앱 ID입니다. 예를 들어
<AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>. -
RedirectUri - 리디렉션 URI입니다.
<RedirectUri>http://localhost:60006/close</RedirectUri>. -
ResourceId - 스크립트의 출력에서 ApplicationIdUri/대상. 예를 들어
<ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.
-
AppID - 앱 ID입니다. 예를 들어
WorkloadManifest.xml 파일을 저장합니다.
9단계: NuGet 패키지 빌드
Visual Studio 메뉴에서 빌드 > 빌드 솔루션를 선택합니다. 빌드는 프런트 엔드 및 백 엔드 XML 및 JSON 파일을 포함하는 NuGet 패키지를 만듭니다.
출력 창에서, 1로 시작하는 행에 나열된 경로를 가져옵니다.>패키지가성공적으로 생성되었습니다.
이 출력 예제에서는 경로가 굵게 강조 표시됩니다.
1>Successfully created packageC:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg.
10단계: 로컬 드라이브에 복사
솔루션 탐색기에서 workload-dev-mode.json 파일을 엽니다.
다음 필드를 입력합니다.
WorkspaceGuid - 귀하의 패브릭 작업 영역 ID입니다.
패브릭에서 사용 중인 작업 영역으로 이동하여 작업 영역 ID를 찾을 수 있습니다. 작업 영역에 있으면 URL에서
https://app.powerbi.com/groups/뒤에 있는 숫자와 문자로 된 문자열을 복사합니다. 작업 영역 ID는 앞슬래시로 끝납니다. 예를 들어 작업 영역 URL이https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi이면 작업 영역 ID는bbbbcccc-1111-dddd-2222-eeee3333ffff입니다.ManifestPackageFilePath - 매니페스트 패키지 파일의 경로(9단계)입니다. 예를 들어
"ManifestPackageFilePath": "C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg"
workload-dev-mode.json 파일을 저장합니다.
workload-dev-mode.json 파일을 src/Config에서
C:\로 복사합니다.
11단계: 상용구 실행
Visual Studio 2022의 메뉴에서 IIS Express 옆에 있는 화살표를 선택한 다음 드롭다운 메뉴에서 Boilerplate를 선택합니다.
상용구 선택하고 Visual Studio의 요청에 권한을 부여합니다. 실행 중인 솔루션에 대한 정보가 포함된 명령 프롬프트가 열립니다.
12단계: DevGateway 파일 실행
PowerShell 열고 DevGateway 폴더로 이동합니다.
PowerShell에서
.\Microsoft.Fabric.Workload.DevGateway.exe명령을 실행합니다. 출력에 메시지 정보가 표시되면 DevGateway가시작했습니다. 워크로드가 성공적으로 실행되고 있습니다.
13단계: Fabric에서 샘플 워크로드 열기
팁
패브릭에서 샘플 워크로드를 열려면 세 개의 PowerShell 창을 열고 실행해야 합니다.
Microsoft Fabric을 엽니다.
개발에 사용하는 작업 영역으로 이동합니다.
새 항목선택합니다.
샘플 항목을 엽니다(미리 보기).