> ## 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 Azure Data Explorer ao Insights

> Conecte o Azure Data Explorer (ADX) ao PlayFab Insights herdado usando a autenticação do Microsoft Entra ID para consultar a telemetria do jogo com a Linguagem de Consulta Kusto.

# Tutorial: Conectando o Azure Data Explorer ao Insights

Este guia ajuda você a começar a usar o Azure Data Explorer (ADX) com o Insights. Após a conexão, você pode usar o Azure Data Explorer para consultar os dados do seu jogo e descobrir insights relevantes. 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/).

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

### Outros pré-requisitos

> [!NOTE]
>
> O Insights só é compatível com o esquema de resposta de consulta V1. Você pode atualizar o esquema de resposta no Azure Data Explorer usando as etapas abaixo.

Navegue até o [Azure Data Explorer](https://dataexplorer.azure.com/).

1. Selecione o ícone de engrenagem ao lado do nome da sua conta de usuário no canto superior direito.
2. Selecione a seção de configuração **Connection**.
   * Defina **Server parser** como **V1** nas opções da lista suspensa. ![ADX usar o esquema de consulta V1](https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adx-settings-v1.png?fit=max\&auto=format\&n=MjJ0-cTsb1bpaMcX\&q=85\&s=72bd13c8c4dcbc0ff1522c4b6e197e85)

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

## Conectar com o Azure Data Explorer (ADX)

Para se conectar com o Azure Data Explorer:

1. Abra o [Azure Data Explorer](https://dataexplorer.azure.com/). Selecione **Add Cluster**. ![ADX Adicionar conexão](https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adx-add-cluster-button.png?fit=max\&auto=format\&n=MjJ0-cTsb1bpaMcX\&q=85\&s=16bc866ee7bd6649d7d3dd7cfef80ff9)
2. Insira o ponto de extremidade da API do PlayFab, que é `https://insights.playfab.com`.
3. Selecione **Add**. Agora você pode executar consultas ou comandos no banco de dados.

## Recursos adicionais

* [Documentação do Azure Data Explorer](https://learn.microsoft.com/en-us/azure/data-explorer/)
* 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 Kusto Explorer ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Conectando o Azure Data Factory (ADF) ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-factory-to-insights.md)
- [Conectando-se ao Azure Data Explorer](/pt-BR/services/playfab/data-analytics/export-data/data-connection-adx.md)
- [Conectando o Grafana ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)