​

자습서: Azure Data Factory(ADF)를 Insights에 연결

이 가이드는 Insights와 함께 Azure Data Factory(ADF)를 사용하기 시작하는 데 도움을 줍니다. 연결 후에는 Azure Data Factory를 사용하여 데이터 이동을 오케스트레이션하고 게임 데이터를 대규모로 변환하는 워크플로를 만들 수 있습니다. Insights와 연결할 수 있는 다른 도구에 대해 자세히 알아보려면 외부 도구를 Insights에 연결을 참조하세요. 이 자습서에서 학습할 내용:

​

사전 요구 사항

​

AAD로 인증된 PlayFab 계정

인증 공급자가 Microsoft로 설정된 PlayFab 계정이나 사용자가 필요합니다. Microsoft 인증 공급자는 Azure 서비스를 사용하는 데 필요한 Azure Active Directory(AAD)를 인증에 사용합니다. AAD로 인증된 계정 또는 사용자를 만드는 방법에 대한 지침은 Game Manager용 Azure Active Directory 인증을 참조하세요. 계정 또는 사용자가 Microsoft 인증 공급자를 사용하도록 설정되어 있는지 확인하려면:

• developer.playfab.com으로 이동합니다.
• Sign in with Microsoft를 선택하여 PlayFab 계정에 액세스합니다.

로그인할 수 있으면 계정이 Microsoft 인증 공급자를 사용하도록 설정된 것입니다.

​

Insights에 대한 Game Manager 권한

다음 Game Manager 권한이 활성화된 사용자 역할을 계정에 할당해야 합니다.

• Admin 상태.
• Explorer 탭 및 관련 데이터에 대한 액세스.
• Analytics 데이터에 대한 읽기 및 쓰기 액세스.

새 사용자 역할을 만들거나 기존 역할에 이러한 권한을 추가할 수 있습니다.

​

기타 사전 요구 사항

• Azure Active Directory(AAD) 애플리케이션을 만들고 타이틀 데이터베이스에 연결

​

새 데이터 팩터리 만들기

새 데이터 팩터리를 만들려면:

1. Azure portal에 로그인합니다. 홈페이지의 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) 문서
• Insights에 연결할 다른 도구에 대해 알아보려면 외부 도구를 Insights에 연결을 참조하세요.