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

# Connexion de Python à Insights

> Interrogez l'ancien PlayFab Insights à partir de Python et de Jupyter Notebooks avec le SDK Python Azure Kusto, au moyen de l'authentification Microsoft Entra ID pour les données de votre jeu.

# Tutoriel : Connexion de Python à Insights

Ce guide vous aide à commencer à utiliser Python avec Insights. Il utilise le SDK Python Azure Kusto. Une fois la connexion établie, vous pouvez interroger les données de votre jeu avec Python et utiliser la bibliothèque à partir de Jupyter Notebooks. Pour en savoir plus sur les autres outils que vous pouvez connecter à Insights, consultez [Connexion d'outils externes à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity).

<Note>
  PlayFab Insights Management a été mis hors service le 31/03/2026. Nous vous recommandons d'utiliser les [connexions Azure Data Explorer (ADX)](/fr-CA/services/playfab/data-analytics/export-data/data-connection-adx) pour gérer votre rendement et vos coûts à l'avenir. Si votre titre utilise encore **Insights**, continuez à consulter cet article pour les détails de mise en œuvre. Pour plus d'informations, consultez [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).
</Note>

## Prérequis

### Compte PlayFab authentifié avec Azure AD

Vous avez besoin d'un compte ou d'un utilisateur PlayFab dont le fournisseur d'authentification est défini sur Microsoft. Le fournisseur d'authentification Microsoft utilise Azure Active Directory (Azure AD) pour l'authentification, ce qui est requis pour utiliser les services Azure. Consultez [Authentification Azure Active Directory pour Game Manager](/fr-CA/services/playfab/identity/dev-identity/authentication/aad-authentication) pour obtenir des instructions sur la création d'un compte ou d'un utilisateur authentifié par Azure AD.

Pour vérifier que le compte, ou l'utilisateur, est configuré pour utiliser le fournisseur d'authentification Microsoft :

* Visitez la [page de connexion](https://developer.playfab.com) de PlayFab.
* Sélectionnez **Sign in with Microsoft** pour accéder à votre compte PlayFab.

Si vous pouvez vous connecter, le compte est configuré pour utiliser le fournisseur d'authentification Microsoft.

### Autorisations Game Manager pour Insights

Vous devez attribuer à votre compte un [rôle d'utilisateur](/fr-CA/services/playfab/identity/dev-identity/permissions/playfab-user-roles) avec les autorisations Game Manager suivantes activées :

* Statut d'administrateur.
* Accès à l'onglet Explorer et aux données associées.
* Accès en lecture et en écriture aux données d'analytique.

Vous pouvez soit créer un nouveau rôle d'utilisateur, soit ajouter ces autorisations à un rôle existant.

### Autres prérequis

* [Créer une application Azure Active Directory (AAD) et la connecter à la base de données de votre titre](/fr-CA/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights)

## Installer les paquets Python

1. Installez les paquets Python suivants au moyen de [pip](https://pypi.org/project/pip/) :
   * azure-kusto-data
   * azure-kusto-ingest
   * adal
2. Voici un exemple de script pour commencer.

```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)
```

## Ressources supplémentaires

* [Documentation du SDK Python Azure Kusto](https://learn.microsoft.com/en-us/azure/data-explorer/kusto/api/python/kusto-python-client-library)
* Pour en savoir plus sur les autres outils à connecter à Insights, consultez [Connexion d'outils externes à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity)


## Related topics

- [Connexion d'outils externes à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity/index.md)
- [Connexion de Grafana à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [Connexion de Kusto Explorer à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-explorer-to-insights.md)
- [Connexion de Power BI à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
- [Insights](/fr-CA/services/playfab/data-analytics/legacy/insights/overview.md)