> ## 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.

# Conectando o Power BI ao Insights

> Conecte o Power BI Desktop ao PlayFab Insights herdado com a autenticação do Microsoft Entra ID e crie visualizações, painéis e relatórios com os dados do seu jogo.

# Tutorial: Conectando o Power BI ao Insights

Este guia ajuda você a começar a usar o Power BI com o Insights. Após a conexão, você pode usar o Power BI para criar visualizações dos dados do seu jogo e muito mais. Para saber mais sobre outras ferramentas às quais você pode conectar o Insights, confira [Conectando ferramentas externas ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity).

<Note>
  O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as [Conexões do Azure Data Explorer (ADX)](/pt-BR/services/playfab/data-analytics/export-data/data-connection-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](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## 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](/pt-BR/services/playfab/identity/dev-identity/authentication/aad-authentication) 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](https://developer.playfab.com).
* Selecione **Entrar com a Microsoft** para acessar sua conta do PlayFab.

Se você conseguir entrar, a conta está definida para usar o provedor de autenticação da Microsoft.

### Permissões do Game Manager para o Insights

Você precisa atribuir à sua conta uma [função de usuário](/pt-BR/services/playfab/identity/dev-identity/permissions/playfab-user-roles) 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.

Você pode criar uma nova função de usuário ou adicionar essas permissões a uma função existente.

### Outros pré-requisitos

* [Power BI Desktop](https://powerbi.microsoft.com/desktop/)

<Note>
  O Power BI Desktop é obrigatório. Este cenário não é compatível com o Portal Web do Power BI.
</Note>

## Conectar com o Power BI

No seu computador local, abra o Power BI.

1. Na janela do **Power BI Desktop**, selecione **Get Data** > **Azure Data Explorer (Kusto)**.
2. Na caixa de diálogo **Azure Data Explorer (Kusto)**, execute as seguintes etapas:
   * Em **Cluster**, insira o ponto de extremidade da API do PlayFab, que é `https://insights.playfab.com`.
   * Em **Database**, insira a ID do seu título toda em letras maiúsculas, pois os nomes de bancos de dados diferenciam maiúsculas de minúsculas.
   * Role para baixo e, em **Data Connectivity mode**, selecione **DirectQuery**. Opcionalmente, insira uma tabela ou consulta. Você pode definir limites para o número máximo de registros ou o tamanho máximo. Se a consulta exceder esses limites, ela retornará um erro `PartialQueryFailure` e uma mensagem informando que você excedeu os limites. O exemplo a seguir especifica uma consulta na tabela `events.all` que retorna eventos ocorridos nos últimos sete dias.
     <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/powerBI.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=1874cea29fc9f71339db111235c663cd" alt="Configuração do Power BI" width="1051" height="745" data-path="images/playfab/data-analytics/legacy/connectivity/powerBI.png" />
     <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/powerBI-2.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=a370a20780f205b0d747bb2560dc2f4f" alt="Configuração estendida do Power BI" width="1048" height="351" data-path="images/playfab/data-analytics/legacy/connectivity/powerBI-2.png" />
3. Selecione **OK**. Agora você pode executar consultas e comandos no banco de dados.

## Recursos adicionais

* [Documentação do Power BI](https://learn.microsoft.com/en-us/power-bi/)
* Para saber mais sobre outras ferramentas para se conectar ao Insights, confira [Conectando ferramentas externas ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity)


## Related topics

- [Conectando ferramentas externas ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Conectando o Python ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [Conectando o Grafana ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [Conectando o Kusto Explorer ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Conectando o Azure Data Explorer ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-explorer-to-insights.md)