> ## 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 Python ao Insights

> Consulte o PlayFab Insights herdado a partir do Python e de Jupyter Notebooks com o SDK do Azure Kusto para Python, usando a autenticação do Microsoft Entra ID para os dados do seu jogo.

# Tutorial: Conectando o Python ao Insights

Este guia ajuda você a começar a usar o Python com o Insights. Ele usa o SDK do Azure Kusto para Python. Após a conexão, você pode consultar os dados do seu jogo com Python e usar a biblioteca a partir de Jupyter Notebooks. Para saber mais sobre outras ferramentas que você pode conectar ao 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 o Azure AD

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 (Azure AD) 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 Azure AD.

Para verificar se a conta, ou o usuário, está definida para usar o provedor de autenticação da Microsoft:

* Acesse a [página de login](https://developer.playfab.com) do PlayFab.
* 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

* [Criar um aplicativo do Azure Active Directory (AAD) e conectá-lo ao banco de dados do seu título](/pt-BR/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Instalar pacotes do Python

1. Instale os seguintes pacotes do Python usando o [pip](https://pypi.org/project/pip/):
   * azure-kusto-data
   * azure-kusto-ingest
   * adal
2. Veja abaixo um script de exemplo para começar.

```python theme={null}
from azure.kusto.data.exceptions import KustoServiceError
from azure.kusto.data.request import KustoClient, KustoConnectionStringBuilder, ClientRequestProperties

from msal import ConfidentialClientApplication

cluster = "https://insights.playfab.com"

# These parameters are taken from your Azure app
client_id = "<Azure app client id>"
client_secret = "<Azure app client secret>" 
tenant = "<Azure app tenant id>"

authority_url = "https://login.microsoftonline.com/" + tenant

client_instance = ConfidentialClientApplication(
  client_id=client_id,
  client_credential=client_secret,
  authority=authority_url,
)

# Acquire a token from AAD to pass to PlayFab
_scopes = ["https://help.kusto.windows.net"]
token_response = client_instance.acquire_token_for_client(scopes=_scopes)

token = None
if token_response:
    if token_response['access_token']:
        token = token_response['access_token']

kcsb = KustoConnectionStringBuilder.with_aad_application_token_authentication(cluster, token)
client = KustoClient(kcsb)

db = "<title id>"
query = "['events.all'] | count"

# Force Kusto to use the v1 query endpoint
client._query_endpoint = cluster + "/v1/rest/query"

crp = ClientRequestProperties()
crp.application = "KustoPythonSDK"
response = client.execute(db, query)

# Response processing
print(response)
```

## Recursos adicionais

* [Documentação do SDK do Azure Kusto para Python](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/api/python/kusto-python-client-library)
* 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 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 Power BI ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-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)