Tutorial: Conectando o Azure Data Factory (ADF) ao Insights
Este guia ajuda você a começar a usar o Azure Data Factory (ADF) com o Insights. Após a conexão, você pode usar o Azure Data Factory para criar fluxos de trabalho para orquestrar a movimentação de dados e transformar dados de jogos em escala. Para saber mais sobre outras ferramentas às quais você pode conectar o Insights, confira Conectando ferramentas externas ao Insights. Neste tutorial, você aprenderá a:[!div class=“checklist”] * Criar um data factory no Azure * Criar um pipeline
O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as Conexões do Azure Data Explorer (ADX) para gerenciar seu desempenho e custo daqui em diante. Se o seu título ainda estiver usando o Insights, continue consultando este artigo para obter detalhes de implementação. Para obter mais informações, confira PlayFab Digest: March feature updates.
Pré-requisitos
Conta do PlayFab autenticada com AAD
Você precisa de uma conta ou usuário do PlayFab cujo provedor de autenticação esteja definido como Microsoft. O provedor de autenticação da Microsoft usa o Azure Active Directory (AAD) para autenticação, o que é necessário para usar os serviços do Azure. Confira Autenticação do Azure Active Directory para o Game Manager para obter instruções sobre como criar uma conta ou usuário autenticado pelo AAD. Para verificar se a conta, ou o usuário, está definida para usar o provedor de autenticação da Microsoft:- Navegue até developer.playfab.com.
- Selecione Entrar com a Microsoft para acessar sua conta do PlayFab.
Permissões do Game Manager para o Insights
Você precisa atribuir à sua conta uma função de usuário com as seguintes permissões do Game Manager habilitadas:- Status de administrador.
- Acesso à guia Explorer e aos dados associados.
- Acesso de leitura e gravação aos dados de Analytics.
Outros pré-requisitos
Criar um novo data factory
Para criar um novo data factory:- Entre no portal do Azure. Na página inicial, em Azure Services, selecione Create a resource. Pesquise Data Factory, selecione-o e, em seguida, selecione Create.
- Preencha os campos obrigatórios:
- Em Name, escolha um nome para o seu data factory. O nome deve ser globalmente exclusivo.
- Em Subscription, selecione a assinatura do Azure na qual você deseja criar o data factory.
- Em Resource Group, use uma das seguintes etapas:
- Selecione Use existing e selecione um grupo de recursos existente na lista.
- Selecione Create new e insira o nome de um grupo de recursos.
- Você não precisa habilitar o GIT agora, portanto, desmarque a caixa abaixo.
- Selecione Create. Após a conclusão da implantação, em Next steps, selecione Go to resource.
- Para abrir a interface do usuário do Data Factory em uma guia separada, selecione Author & Monitor.
Criar um pipeline
Agora vamos criar um novo pipeline para obter dados do Insights. Para criar um pipeline:- Na página Let’s get started, selecione Create pipeline.
- No painel Activities, em Azure Data Explorer, arraste e solte um Azure Data Explorer Command no espaço de trabalho em branco. No painel inferior, em General, preencha o nome e a descrição.
- Selecione a guia Connection e selecione New.
- Na janela New linked service (Azure Data Explorer (Kusto)), preencha os campos:
- Em Name, use a ID do título.
- Em Account selection method, selecione Enter manually.
- Em Endpoint, use o ponto de extremidade da API do PlayFab, que é
https://insights.playfab.com. - Em Service Principal ID, insira a ID do cliente do seu aplicativo do Azure.
- Em Service Principal Key, insira o segredo do cliente do seu aplicativo do Azure.
- Na caixa Database, digite a ID do título toda em letras maiúsculas.
- Para verificar se todas as informações estão corretas, selecione Test connection. Se tudo estiver configurado corretamente, será retornada uma resposta Connection successful.
- Para validar e depurar o pipeline, na barra de ferramentas acima do espaço de trabalho, selecione Validate e, em seguida, selecione Debug.
Recursos adicionais
- Documentação do Azure Data Factory (ADF)
- Para saber mais sobre outras ferramentas para se conectar ao Insights, confira Conectando ferramentas externas ao Insights