> ## 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.
# Tutorial do PlayFab e do Real-Time Analytics do Microsoft Fabric
> Tutorial completo para integrar o PlayFab ao Real-Time Analytics do Microsoft Fabric para transmitir eventos de jogo e explorar KPIs em um dashboard do Power BI.
Este tutorial explica as etapas completas de como integrar o **PlayFab** e o **Fabric Real-Time Analytics** para habilitar análises e insights em tempo real para o seu jogo. Seguindo as instruções passo a passo, você aprenderá a usar o serviço Data Connections do PlayFab para distribuir eventos de jogo ao Banco de Dados do Fabric Real-Time Analytics e a acessar o dashboard do Power BI no Fabric para explorar os principais KPIs do jogo. O tutorial inclui um dashboard de exemplo do Power BI e todos os recursos necessários para concluir a integração.
### Pré-requisitos
* Para concluir este tutorial com êxito, você precisa de uma [capacidade](https://learn.microsoft.com/en-us/fabric/enterprise/licenses#capacity) habilitada para Microsoft Fabric. Por tempo limitado, você pode [se inscrever na avaliação do Microsoft Fabric (versão prévia)](https://learn.microsoft.com/en-us/fabric/get-started/fabric-trial).
* Uma conta de desenvolvedor do PlayFab. Inscreva-se em [playfab.com](https://developer.playfab.com)
* Microsoft PowerBI Desktop instalado. Confira [Introdução ao Power BI Desktop](https://learn.microsoft.com/en-us/power-bi/fundamentals/desktop-getting-started#install-and-run-power-bi-desktop)
## Criar um workspace do Fabric
1. Acesse o [Microsoft Fabric](https://msit.powerbi.com/home).
2. Na barra de navegação do lado esquerdo, selecione **Workspaces** > **New workspace**.
3. Um painel será aberto no lado direito da tela.
4. Insira um nome para o workspace. O único campo obrigatório é **Name**. Exemplo: **PlayFabReports**.
5. Selecione **Apply** para salvar seu workspace.
Para obter detalhes, confira [Criar um workspace - Microsoft Fabric | Microsoft Learn](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)
## Criar um Banco de Dados KQL
Depois de configurar seu workspace, a próxima etapa é criar um Banco de Dados KQL, para onde todos os seus eventos do PlayFab fluirão.
1. Acesse o [Microsoft Fabric](https://msit.powerbi.com/home).
2. Na barra de navegação do lado esquerdo, selecione **Workspaces** > **Your Workspace**.
3. Selecione **New** > **More Options** > **KQL Database**.
4. Insira um nome no campo **KQL Database name** e selecione **New database** como **Type**.
5. Selecione **Create** para concluir a criação do Banco de Dados.
Para saber mais, confira [Análise em tempo real - Criar recursos](https://learn.microsoft.com/en-us/fabric/real-time-analytics/tutorial-1-resources).
## Criar uma Conexão de Dados do Microsoft Fabric
Depois de criado, o Banco de Dados KQL aparece no seu workspace, conforme mostrado na captura de tela abaixo.
Agora, crie uma Conexão de Dados para que todos os seus eventos possam fluir para o seu Banco de Dados KQL.
1. Acesse o [Microsoft Fabric](https://msit.powerbi.com/home).
2. Selecione **Workspaces** no painel esquerdo e selecione **Your Workspace**.
3. Copie o **Query URI** selecionando o ícone **Copy** ao lado do rótulo **Query URI**.
4. Acesse o **PlayFab** e entre no [Game Manager](https://developer.playfab.com/).
5. Selecione **Data** no menu à esquerda.
6. Selecione a guia **Data Connections**.
7. Selecione o botão **New connection**.
8. No menu suspenso **Destination type**, selecione a opção **Fabric KQL Database**.
9. Dê um nome à sua **Data Connection** no campo **Name**.
10. Verifique se a caixa **Enabled** está marcada.
11. Cole o **Query URI** obtido no Fabric no campo **Ingestion URI**.
12. No campo **Database**, insira o nome do **KQL Database** que você criou no Fabric.
13. Preencha o campo **Table** com um nome significativo. Exemplo: **Events**.
Há um conjunto de consultas na parte inferior da página. Na próxima seção, vamos copiar essas consultas para o Fabric.
## Juntando tudo
1. Volte para a página do seu **KQL Database** no **Fabric**.
2. Selecione **Explore your data**.
3. Copie e execute cada uma das consultas, uma por uma, selecionando o botão **Run** na parte superior do painel.
4. O resultado deve ser semelhante a este:
5. Volte para a guia **Data Connections** no **Game Manager**.
6. Selecione **Save**.
## Ver tudo em ação
Para obter os melhores resultados, siga estas etapas depois de concluir todas as instruções acima.
Agora, para fins de demonstração, vamos criar alguns novos Jogadores no Game Manager do PlayFab. Depois disso, você poderá ver os dados deles no Relatório do Power BI.
### Criar Jogadores no Game Manager
1. Acesse o **PlayFab** e entre no [Game Manager](https://developer.playfab.com/).
2. Selecione **Players** no menu à esquerda.
3. Selecione a guia **Players**.
4. Selecione **New player**.
5. Selecione **Create and login player**.
6. Repita essas etapas para criar quantos jogadores quiser!
### Carregar o modelo do Power BI do PlayFab no Microsoft Fabric
Há duas etapas nesse processo. Primeiro, baixe o modelo do Power BI do PlayFab e, em seguida, carregue-o no Microsoft Fabric.
#### Baixar o modelo do Power BI do GitHub
1. Acesse o [GitHub](https://github.com/) e entre.
2. Acesse o repositório [PlayFabPowerBITemplates](https://github.com/PlayFab/PlayFabPowerBITemplates).
3. Selecione o **botão de três pontos** no canto superior direito da página para baixar o modelo.
#### Abrir o modelo no Power BI Desktop e publicar no Microsoft Fabric
1. Abra o **PowerBI Desktop**.
2. Selecione a guia **File** na parte superior da tela.
3. Selecione **Browse this device** no canto inferior esquerdo da tela.
4. Procure o arquivo de modelo (.pbit) que você baixou, **selecione-o** e **abra-o**.
Altere o tipo de arquivo para Power BI Template Files (\*.pbit) no menu suspenso ao procurar o modelo baixado, pois o padrão é mostrar arquivos \*.pbix.
5. Preencha os parâmetros de conexão na janela **PlayfabReportTemplate**.
* Acesse o [Microsoft Fabric](https://msit.powerbi.com/home).
* Selecione **Workspaces** no painel esquerdo e selecione seu workspace.
* URI: copie o Query URI selecionando o **ícone Copy** ao lado do campo URI.
* Database: no campo **Database**, insira o nome do Banco de Dados KQL que você criou no Fabric.
* Insira em **Table** o nome da tabela que você criou em [Criar uma Conexão de Dados do Microsoft Fabric](#create-a-microsoft-fabric-data-connection). Se você usou o nome de exemplo acima, ele é **Events**.
6. Selecione **Load**.
7. Selecione **Publish** na parte superior da página.
8. Selecione **Save**.
9. Preencha o formulário **Save** this file. (Somente se você ainda não tiver salvo o arquivo).
* Dê ao Relatório um **Name** significativo para você. Exemplo: **OverviewReport**
* Selecione um **Location** onde salvá-lo.
* Selecione **Save**.
10. Preencha o formulário **Publish** selecionando seu **Microsoft Fabric Workspace**.
11. Selecione o link **Open OverviewReport.pbit in Power BI**. Isso abrirá o relatório de modelo no Fabric.
Depois de concluir essas etapas, selecione seu workspace no Fabric para encontrar a lista de bancos de dados e relatórios.
A quantidade de dados que você vê depende de quando a Conexão de Dados foi criada. O PlayFab não preenche dados retroativamente.
## Confira também
* [Terminologia do Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/get-started/fabric-terminology)
* [Criar um workspace](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)
* [Navegar até seus itens na página inicial do Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/get-started/fabric-home)
* [Tutoriais completos no Microsoft Fabric](https://learn.microsoft.com/en-us/fabric/get-started/end-to-end-tutorials)
## Related topics
- [Criar um aplicativo do Microsoft Entra ID para o PlayFab Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights.md)
- [Visão geral do serviço Real-Time Activity](/pt-BR/services/xbox-services/fundamentals/rta/live-real-time-activity-service-overview.md)
- [Início rápido das Conexões de Dados](/pt-BR/services/playfab/data-analytics/export-data/data-connection-quickstart.md)
- [Conceitos do serviço Real-Time Activity (RTA)](/pt-BR/services/xbox-services/fundamentals/rta/concepts/live-rta-concepts-nav.md)
- [Mensagens em tempo real para as APIs do Lobby e do Matchmaking](/pt-BR/services/playfab/multiplayer/real-time-messages/overview.md)
5. Selecione **Apply** para salvar seu workspace.
Para obter detalhes, confira [Criar um workspace - Microsoft Fabric | Microsoft Learn](https://learn.microsoft.com/en-us/fabric/get-started/create-workspaces)
## Criar um Banco de Dados KQL
Depois de configurar seu workspace, a próxima etapa é criar um Banco de Dados KQL, para onde todos os seus eventos do PlayFab fluirão.
1. Acesse o [Microsoft Fabric](https://msit.powerbi.com/home).
2. Na barra de navegação do lado esquerdo, selecione **Workspaces** > **Your Workspace**.
3. Selecione **New** > **More Options** > **KQL Database**.
4. Insira um nome no campo **KQL Database name** e selecione **New database** como **Type**.
5. Selecione **Create** para concluir a criação do Banco de Dados.
Para saber mais, confira [Análise em tempo real - Criar recursos](https://learn.microsoft.com/en-us/fabric/real-time-analytics/tutorial-1-resources).
## Criar uma Conexão de Dados do Microsoft Fabric
Depois de criado, o Banco de Dados KQL aparece no seu workspace, conforme mostrado na captura de tela abaixo.
Agora, crie uma Conexão de Dados para que todos os seus eventos possam fluir para o seu Banco de Dados KQL.
1. Acesse o [Microsoft Fabric](https://msit.powerbi.com/home).
2. Selecione **Workspaces** no painel esquerdo e selecione **Your Workspace**.
3. Copie o **Query URI** selecionando o ícone **Copy** ao lado do rótulo **Query URI**.
4. Acesse o **PlayFab** e entre no [Game Manager](https://developer.playfab.com/).
5. Selecione **Data** no menu à esquerda.
6. Selecione a guia **Data Connections**.
7. Selecione o botão **New connection**.
8. No menu suspenso **Destination type**, selecione a opção **Fabric KQL Database**.
9. Dê um nome à sua **Data Connection** no campo **Name**.
10. Verifique se a caixa **Enabled** está marcada.
11. Cole o **Query URI** obtido no Fabric no campo **Ingestion URI**.
12. No campo **Database**, insira o nome do **KQL Database** que você criou no Fabric.
13. Preencha o campo **Table** com um nome significativo. Exemplo: **Events**.
Há um conjunto de consultas na parte inferior da página. Na próxima seção, vamos copiar essas consultas para o Fabric.
## Juntando tudo
1. Volte para a página do seu **KQL Database** no **Fabric**.
2. Selecione **Explore your data**.
3. Copie e execute cada uma das consultas, uma por uma, selecionando o botão **Run** na parte superior do painel.
4. O resultado deve ser semelhante a este:
5. Volte para a guia **Data Connections** no **Game Manager**.
6. Selecione **Save**.
## Ver tudo em ação
Para obter os melhores resultados, siga estas etapas depois de concluir todas as instruções acima.
Agora, para fins de demonstração, vamos criar alguns novos Jogadores no Game Manager do PlayFab. Depois disso, você poderá ver os dados deles no Relatório do Power BI.
### Criar Jogadores no Game Manager
1. Acesse o **PlayFab** e entre no [Game Manager](https://developer.playfab.com/).
2. Selecione **Players** no menu à esquerda.
3. Selecione a guia **Players**.
4. Selecione **New player**.
5. Selecione **Create and login player**.
6. Repita essas etapas para criar quantos jogadores quiser!
### Carregar o modelo do Power BI do PlayFab no Microsoft Fabric
Há duas etapas nesse processo. Primeiro, baixe o modelo do Power BI do PlayFab e, em seguida, carregue-o no Microsoft Fabric.
#### Baixar o modelo do Power BI do GitHub
1. Acesse o [GitHub](https://github.com/) e entre.
2. Acesse o repositório [PlayFabPowerBITemplates](https://github.com/PlayFab/PlayFabPowerBITemplates).
3. Selecione o **botão de três pontos** no canto superior direito da página para baixar o modelo.
#### Abrir o modelo no Power BI Desktop e publicar no Microsoft Fabric
1. Abra o **PowerBI Desktop**.
2. Selecione a guia **File** na parte superior da tela.
3. Selecione **Browse this device** no canto inferior esquerdo da tela.
4. Procure o arquivo de modelo (.pbit) que você baixou, **selecione-o** e **abra-o**.