> ## 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.
# Azure Data Factory(ADF)를 Insights에 연결
> 레거시 PlayFab Insights에 대해 Azure Data Factory 파이프라인을 구축하여 다운스트림 시스템을 위한 대규모 데이터 이동을 오케스트레이션하고 게임 이벤트 데이터를 변환합니다.
# 자습서: Azure Data Factory(ADF)를 Insights에 연결
이 가이드는 Insights와 함께 Azure Data Factory(ADF)를 사용하기 시작하는 데 도움을 줍니다. 연결 후에는 Azure Data Factory를 사용하여 데이터 이동을 오케스트레이션하고 게임 데이터를 대규모로 변환하는 워크플로를 만들 수 있습니다. Insights와 연결할 수 있는 다른 도구에 대해 자세히 알아보려면 [외부 도구를 Insights에 연결](/services/playfab/data-analytics/legacy/connectivity)을 참조하세요.
이 자습서에서 학습할 내용:
\[!div class="checklist"] \* Azure에서 데이터 팩터리 만들기 \* 파이프라인 만들기
PlayFab Insights Management는 2026년 3월 31일에 지원이 중단되었습니다. 앞으로 성능과 비용을 관리하려면 [Azure Data Explorer(ADX) Connections](/services/playfab/data-analytics/export-data/data-connection-adx)를 사용하는 것이 좋습니다. 타이틀이 아직 **Insights**를 사용하고 있다면 구현 세부 정보는 이 문서를 계속 참고하세요. 자세한 내용은 [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/)를 참조하세요.
## 사전 요구 사항
### AAD로 인증된 PlayFab 계정
인증 공급자가 Microsoft로 설정된 PlayFab 계정이나 사용자가 필요합니다. Microsoft 인증 공급자는 Azure 서비스를 사용하는 데 필요한 Azure Active Directory(AAD)를 인증에 사용합니다. AAD로 인증된 계정 또는 사용자를 만드는 방법에 대한 지침은 [Game Manager용 Azure Active Directory 인증](/services/playfab/identity/dev-identity/authentication/aad-authentication)을 참조하세요.
계정 또는 사용자가 Microsoft 인증 공급자를 사용하도록 설정되어 있는지 확인하려면:
* [developer.playfab.com](https://developer.playfab.com)으로 이동합니다.
* **Sign in with Microsoft**를 선택하여 PlayFab 계정에 액세스합니다.
로그인할 수 있으면 계정이 Microsoft 인증 공급자를 사용하도록 설정된 것입니다.
### Insights에 대한 Game Manager 권한
다음 Game Manager 권한이 활성화된 [사용자 역할](/services/playfab/identity/dev-identity/permissions/playfab-user-roles)을 계정에 할당해야 합니다.
* Admin 상태.
* Explorer 탭 및 관련 데이터에 대한 액세스.
* Analytics 데이터에 대한 읽기 및 쓰기 액세스.
새 사용자 역할을 만들거나 기존 역할에 이러한 권한을 추가할 수 있습니다.
### 기타 사전 요구 사항
* [Azure Active Directory(AAD) 애플리케이션을 만들고 타이틀 데이터베이스에 연결](/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)
## 새 데이터 팩터리 만들기
새 데이터 팩터리를 만들려면:
1. [Azure portal](https://portal.azure.com)에 로그인합니다. 홈페이지의 **Azure Services** 아래에서 **Create a resource**를 선택합니다. **Data Factory**를 검색하여 선택한 다음 **Create**를 선택합니다. 
2. 필수 필드를 채웁니다.
* **Name**에는 데이터 팩터리의 이름을 선택합니다. 이름은 \_전역적으로 고유\_해야 합니다.
* **Subscription**에는 데이터 팩터리를 만들려는 Azure 구독을 선택합니다.
* **Resource Group**에는 다음 단계 중 하나를 사용합니다.
* **Use existing**을 선택하고 목록에서 기존 리소스 그룹을 선택합니다.
* **Create new**를 선택하고 리소스 그룹의 이름을 입력합니다.
* 지금은 GIT를 활성화할 필요가 없으므로 아래 상자의 선택을 해제합니다. 
3. **Create**를 선택합니다. 배포가 완료된 후 **Next steps** 아래에서 **Go to resource**를 선택합니다.
4. 별도의 탭에서 Data Factory UI를 열려면 **Author & Monitor**를 선택합니다.
## 파이프라인 만들기
이제 Insights에서 데이터를 가져오기 위한 새 파이프라인을 만들 것입니다. 파이프라인을 만들려면:
1. **Let's get started** 페이지에서 **Create pipeline**을 선택합니다.
2. **Activities** 패널의 **Azure Data Explorer** 아래에서, 빈 작업 영역에 **Azure Data Explorer Command**를 드래그 앤 드롭합니다. 하단 패널의 **General** 아래에서 이름과 설명을 채웁니다. 
3. **Connection** 탭을 선택하고 **New**를 선택합니다. 
4. **New linked service (Azure Data Explorer (Kusto))** 창에서 필드를 채웁니다.
* **Name**에는 Title ID를 사용합니다.
* **Account selection method**에는 **Enter manually**를 선택합니다.
* **Endpoint**에는 PlayFab API 엔드포인트인 `https://insights.playfab.com`을 사용합니다.
* **Service Principal ID**에는 Azure 앱의 Client ID를 입력합니다.
* **Service Principal Key**에는 Azure 앱의 Client secret을 입력합니다.
* **Database** 상자에 Title ID를 모두 대문자로 입력합니다. 
**Create**를 선택합니다. 이제 파이프라인이 준비되었습니다. 파이프라인 이름을 클릭하여 주 파이프라인 뷰로 돌아갈 수 있습니다.
5. 모든 정보가 올바른지 확인하려면 **Test connection**을 선택합니다. 모든 것이 올바르게 설정되어 있으면 Connection successful 응답을 반환합니다. 
6. 파이프라인을 검증하고 디버그하려면 작업 영역 위의 도구 모음에서 **Validate**를 선택한 다음 **Debug**를 선택합니다.
## 추가 리소스
* [Azure Data Factory(ADF) 문서](https://learn.microsoft.com/en-us/azure/data-factory/)
* Insights에 연결할 다른 도구에 대해 알아보려면 [외부 도구를 Insights에 연결](/services/playfab/data-analytics/legacy/connectivity)을 참조하세요.