> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# PlayFab 및 Microsoft Fabric 실시간 분석 자습서
> PlayFab을 Microsoft Fabric Real-Time Analytics와 통합하여 게임 이벤트를 스트리밍하고 Power BI 대시보드에서 KPI를 탐색하기 위한 종단 간 자습서입니다.
이 자습서는 게임에 대해 실시간 분석과 인사이트를 활성화하기 위해 **PlayFab**과 **Fabric Real-Time Analytics**를 통합하는 종단 간 단계를 설명합니다. 단계별 지침을 따라, PlayFab의 Data Connections 서비스를 사용하여 게임 이벤트를 Fabric Real-Time Analytics Database로 배포하는 방법과 Fabric Power BI 대시보드에 액세스하여 주요 게임 KPI를 탐색하는 방법을 배웁니다. 이 자습서에는 샘플 Power BI 대시보드와 통합을 완료하는 데 필요한 모든 리소스가 포함되어 있습니다.
### 사전 요구 사항
* 이 자습서를 성공적으로 완료하려면 Microsoft Fabric 사용 [capacity](https://learn.microsoft.com/en-us/fabric/enterprise/licenses#capacity)가 필요합니다. 제한된 시간 동안 [Microsoft Fabric(미리 보기) 평가판에 가입](https://learn.microsoft.com/en-us/fabric/get-started/fabric-trial)할 수 있습니다.
* PlayFab 개발자 계정. [playfab.com](https://developer.playfab.com)에서 가입하세요.
* Microsoft PowerBI Desktop 설치. [Power BI Desktop 시작하기](https://learn.microsoft.com/en-us/power-bi/fundamentals/desktop-getting-started#install-and-run-power-bi-desktop)를 참조하세요.
## Fabric 작업 영역 만들기
1. [Microsoft Fabric](https://msit.powerbi.com/home)으로 이동합니다.
2. 왼쪽 탐색 모음에서 **Workspaces** > **New workspace**를 선택합니다.
3. 화면 오른쪽에 창이 열립니다.
4. 작업 영역의 이름을 입력합니다. 필수 필드는 **Name**뿐입니다. 예: **PlayFabReports**.
5. **Apply**를 선택하여 작업 영역을 저장합니다.
자세한 내용은 [작업 영역 만들기 - Microsoft Fabric | Microsoft Learn](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)을 참조하세요.
## KQL 데이터베이스 만들기
작업 영역을 설정한 후, 다음 단계는 모든 PlayFab 이벤트가 흘러 들어갈 KQL 데이터베이스를 만드는 것입니다.
1. [Microsoft Fabric](https://msit.powerbi.com/home)으로 이동합니다.
2. 왼쪽 탐색 모음에서 **Workspaces** > **Your Workspace**를 선택합니다.
3. **New** > **More Options** > **KQL Database**를 선택합니다.
4. **KQL Database name** 필드에 이름을 입력하고 **Type**으로 **New database**를 선택합니다.
5. **Create**를 선택하여 데이터베이스 생성을 완료합니다.
자세히 알아보려면 [실시간 분석 - 리소스 만들기](https://learn.microsoft.com/en-us/fabric/real-time-analytics/tutorial-1-resources)를 참조하세요.
## Microsoft Fabric Data Connection 만들기
KQL 데이터베이스를 만들면 아래 스크린샷과 같이 작업 영역에 표시됩니다.
이제 모든 이벤트가 KQL 데이터베이스로 흘러 들어갈 수 있도록 Data Connection을 만들어 진행하세요.
1. [Microsoft Fabric](https://msit.powerbi.com/home)으로 이동합니다.
2. 왼쪽 패널에서 **Workspaces**를 선택하고 **Your Workspace**를 선택합니다.
3. **Query URI** 레이블 옆의 **Copy** 아이콘을 선택하여 **Query URI**를 복사합니다.
4. **PlayFab**으로 이동하여 [Game Manager](https://developer.playfab.com/)에 로그인합니다.
5. 왼쪽 메뉴에서 **Data**를 선택합니다.
6. **Data Connections** 탭을 선택합니다.
7. **New connection** 버튼을 선택합니다.
8. **Destination type** 드롭다운에서 **Fabric KQL Database** 옵션을 선택합니다.
9. **Name** 필드에 **Data Connection**의 이름을 지정합니다.
10. **Enabled** 상자가 선택되어 있는지 확인합니다.
11. Fabric에서 가져온 **Query URI**를 **Ingestion URI** 필드에 붙여넣습니다.
12. **Database** 필드에 Fabric에서 만든 **KQL Database**의 이름을 입력합니다.
13. **Table** 필드에 의미 있는 이름을 채웁니다. 예: **Events**.
페이지 하단에 쿼리 세트가 있습니다. 다음 섹션에서는 이러한 쿼리를 Fabric에 복사해 봅시다.
## 모두 결합하기
1. **Fabric**의 **KQL Database** 페이지로 돌아갑니다.
2. **Explore your data**를 선택합니다.
3. 창 상단의 **Run** 버튼을 선택하여 각 쿼리를 하나씩 복사하고 실행합니다.
4. 결과는 다음과 같아야 합니다.
5. **Game Manager**의 **Data Connections** 탭으로 돌아갑니다.
6. **Save**를 선택합니다.
## 모든 것을 실제로 확인
최상의 결과를 얻으려면 위의 모든 지침을 완료한 후 다음 단계를 따르세요.
이제 데모 목적으로 PlayFab의 Game Manager에서 새 플레이어를 몇 명 만든 다음, Power BI 보고서에서 해당 데이터를 볼 수 있어야 합니다.
### Game Manager에서 플레이어 만들기
1. **PlayFab**으로 이동하여 [Game Manager](https://developer.playfab.com/)에 로그인합니다.
2. 왼쪽 메뉴에서 **Players**를 선택합니다.
3. **Players** 탭을 선택합니다.
4. **New player**를 선택합니다.
5. **Create and login player**를 선택합니다.
6. 원하는 만큼 플레이어를 만들기 위해 이 단계를 반복하세요!
### Microsoft Fabric에 PlayFab의 Power BI 템플릿 업로드
이 프로세스에는 두 단계가 있습니다. 먼저 PlayFab의 Power BI 템플릿을 다운로드한 다음 Microsoft Fabric에 업로드합니다.
#### GitHub에서 Power BI 템플릿 다운로드
1. [GitHub](https://github.com/)로 이동하여 로그인합니다.
2. [PlayFabPowerBITemplates](https://github.com/PlayFab/PlayFabPowerBITemplates) 리포지토리로 이동합니다.
3. 템플릿을 다운로드하려면 페이지 오른쪽 상단의 **점 세 개 버튼**을 선택합니다.
#### Power BI Desktop에서 템플릿 열기 및 Microsoft Fabric에 게시
1. **PowerBI Desktop**을 엽니다.
2. 화면 상단의 **File** 탭을 선택합니다.
3. 화면 왼쪽 하단에서 **Browse this device**를 선택합니다.
4. 다운로드한 템플릿 파일(.pbit)을 찾아 **선택**하고 **엽니다**.
다운로드한 템플릿을 찾을 때 기본적으로 *.pbix 파일이 표시되므로 드롭다운에서 파일 형식을 Power BI Template Files (*.pbit)로 업데이트하세요.
5. **PlayfabReportTemplate** 창에서 연결 매개변수를 채웁니다.
* [Microsoft Fabric](https://msit.powerbi.com/home)으로 이동합니다.
* 왼쪽 패널에서 **Workspaces**를 선택하고 작업 영역을 선택합니다.
* URI: URI 필드 옆의 **Copy 아이콘**을 선택하여 Query URI를 복사합니다.
* Database: **Database** 필드에 Fabric에서 만든 KQL Database의 이름을 입력합니다.
* **Table** 아래 [Microsoft Fabric Data Connection 만들기](#create-a-microsoft-fabric-data-connection)에서 만든 테이블 이름을 입력합니다. 위의 예제 이름을 사용한 경우 **Events**입니다.
6. **Load**를 선택합니다.
7. 페이지 상단에서 **Publish**를 선택합니다.
8. **Save**를 선택합니다.
9. 이 파일 **Save** 양식을 채웁니다. (이전에 파일을 저장한 적이 없는 경우에만.)
* 보고서에 의미 있는 **Name**을 지정합니다. 예: **OverviewReport**
* 저장할 **Location**을 선택합니다.
* **Save**를 선택합니다.
10. **Microsoft Fabric Workspace**를 선택하여 **Publish** 양식을 채웁니다.
11. **Open OverviewReport.pbit in Power BI** 링크를 선택하면 Fabric에서 템플릿 보고서가 열립니다.
이 단계를 완료한 후 Fabric에서 작업 영역을 선택하여 데이터베이스와 보고서 목록을 찾습니다.
볼 수 있는 데이터의 양은 Data Connection이 만들어진 시점에 따라 다릅니다. PlayFab은 데이터를 소급 채우지 않습니다.
## 관련 항목
* [Microsoft Fabric 용어](https://learn.microsoft.com/en-us/fabric/get-started/fabric-terminology)
* [작업 영역 만들기](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)
* [Microsoft Fabric 홈페이지에서 항목으로 이동](https://learn.microsoft.com/en-us/fabric/get-started/fabric-home)
* [Microsoft Fabric의 종단 간 자습서](https://learn.microsoft.com/en-us/fabric/get-started/end-to-end-tutorials)
## Related topics
- [실시간 분석 핵심 개념](/ko/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Data Connections - 개요](/ko/services/playfab/data-analytics/export-data/data-connection-overview.md)
- [PlayFab 데이터 및 분석 문서](/ko/services/playfab/data-analytics/index.md)
- [세그먼트의 플레이어 수 계산 자습서](/ko/services/playfab/live-service-management/game-configuration/segmentation/segmentation-player-count.md)
- [Marketplace 통합 - Microsoft Store](/ko/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft.md)
5. **Apply**를 선택하여 작업 영역을 저장합니다.
자세한 내용은 [작업 영역 만들기 - Microsoft Fabric | Microsoft Learn](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)을 참조하세요.
## KQL 데이터베이스 만들기
작업 영역을 설정한 후, 다음 단계는 모든 PlayFab 이벤트가 흘러 들어갈 KQL 데이터베이스를 만드는 것입니다.
1. [Microsoft Fabric](https://msit.powerbi.com/home)으로 이동합니다.
2. 왼쪽 탐색 모음에서 **Workspaces** > **Your Workspace**를 선택합니다.
3. **New** > **More Options** > **KQL Database**를 선택합니다.
4. **KQL Database name** 필드에 이름을 입력하고 **Type**으로 **New database**를 선택합니다.
5. **Create**를 선택하여 데이터베이스 생성을 완료합니다.
자세히 알아보려면 [실시간 분석 - 리소스 만들기](https://learn.microsoft.com/en-us/fabric/real-time-analytics/tutorial-1-resources)를 참조하세요.
## Microsoft Fabric Data Connection 만들기
KQL 데이터베이스를 만들면 아래 스크린샷과 같이 작업 영역에 표시됩니다.
이제 모든 이벤트가 KQL 데이터베이스로 흘러 들어갈 수 있도록 Data Connection을 만들어 진행하세요.
1. [Microsoft Fabric](https://msit.powerbi.com/home)으로 이동합니다.
2. 왼쪽 패널에서 **Workspaces**를 선택하고 **Your Workspace**를 선택합니다.
3. **Query URI** 레이블 옆의 **Copy** 아이콘을 선택하여 **Query URI**를 복사합니다.
4. **PlayFab**으로 이동하여 [Game Manager](https://developer.playfab.com/)에 로그인합니다.
5. 왼쪽 메뉴에서 **Data**를 선택합니다.
6. **Data Connections** 탭을 선택합니다.
7. **New connection** 버튼을 선택합니다.
8. **Destination type** 드롭다운에서 **Fabric KQL Database** 옵션을 선택합니다.
9. **Name** 필드에 **Data Connection**의 이름을 지정합니다.
10. **Enabled** 상자가 선택되어 있는지 확인합니다.
11. Fabric에서 가져온 **Query URI**를 **Ingestion URI** 필드에 붙여넣습니다.
12. **Database** 필드에 Fabric에서 만든 **KQL Database**의 이름을 입력합니다.
13. **Table** 필드에 의미 있는 이름을 채웁니다. 예: **Events**.
페이지 하단에 쿼리 세트가 있습니다. 다음 섹션에서는 이러한 쿼리를 Fabric에 복사해 봅시다.
## 모두 결합하기
1. **Fabric**의 **KQL Database** 페이지로 돌아갑니다.
2. **Explore your data**를 선택합니다.
3. 창 상단의 **Run** 버튼을 선택하여 각 쿼리를 하나씩 복사하고 실행합니다.
4. 결과는 다음과 같아야 합니다.
5. **Game Manager**의 **Data Connections** 탭으로 돌아갑니다.
6. **Save**를 선택합니다.
## 모든 것을 실제로 확인
최상의 결과를 얻으려면 위의 모든 지침을 완료한 후 다음 단계를 따르세요.
이제 데모 목적으로 PlayFab의 Game Manager에서 새 플레이어를 몇 명 만든 다음, Power BI 보고서에서 해당 데이터를 볼 수 있어야 합니다.
### Game Manager에서 플레이어 만들기
1. **PlayFab**으로 이동하여 [Game Manager](https://developer.playfab.com/)에 로그인합니다.
2. 왼쪽 메뉴에서 **Players**를 선택합니다.
3. **Players** 탭을 선택합니다.
4. **New player**를 선택합니다.
5. **Create and login player**를 선택합니다.
6. 원하는 만큼 플레이어를 만들기 위해 이 단계를 반복하세요!
### Microsoft Fabric에 PlayFab의 Power BI 템플릿 업로드
이 프로세스에는 두 단계가 있습니다. 먼저 PlayFab의 Power BI 템플릿을 다운로드한 다음 Microsoft Fabric에 업로드합니다.
#### GitHub에서 Power BI 템플릿 다운로드
1. [GitHub](https://github.com/)로 이동하여 로그인합니다.
2. [PlayFabPowerBITemplates](https://github.com/PlayFab/PlayFabPowerBITemplates) 리포지토리로 이동합니다.
3. 템플릿을 다운로드하려면 페이지 오른쪽 상단의 **점 세 개 버튼**을 선택합니다.
#### Power BI Desktop에서 템플릿 열기 및 Microsoft Fabric에 게시
1. **PowerBI Desktop**을 엽니다.
2. 화면 상단의 **File** 탭을 선택합니다.
3. 화면 왼쪽 하단에서 **Browse this device**를 선택합니다.
4. 다운로드한 템플릿 파일(.pbit)을 찾아 **선택**하고 **엽니다**.