Tutorial: Verbinden von Python mit Insights

Dieser Leitfaden hilft Ihnen bei den ersten Schritten mit Python mit Insights. Dabei wird das Azure Kusto Python SDK verwendet. Nach dem Herstellen der Verbindung können Sie Ihre Spieldaten mit Python abfragen und die Bibliothek von Jupyter Notebooks verwenden. Weitere Informationen zu anderen Tools, mit denen Sie eine Verbindung herstellen können, finden Sie unter Verbinden externer Tools mit Insights.

Hinweis

PlayFab Insights Management wurde am 31.03.2026 eingestellt. Wir empfehlen die Verwendung von Azure Data Explorer (ADX)-Verbindungen, um Ihre Leistung und Kosten in Zukunft zu verwalten. Wenn Ihr Titel noch Insights verwendet, lesen Sie diesen Artikel für Implementierungsdetails. Weitere Informationen finden Sie unter PlayFab Digest: Funktionsupdates vom März.

Voraussetzungen

PlayFab-Konto mit Azure AD authentifiziert

Sie benötigen ein PlayFab-Konto oder einen Benutzer, für den bzw. der Authentifizierungsanbieter auf Microsoft festgelegt ist. Der Microsoft-Authentifizierungsanbieter verwendet Azure Active Directory (Azure AD) für die Authentifizierung, die für die Verwendung der Azure-Dienste erforderlich ist. Anweisungen zum Erstellen eines mit Azure AD authentifizierten Kontos oder Benutzers finden Sie unter Azure Active Directory-Authentifizierung für Game Manager.

So überprüfen Sie, ob das Konto oder der Benutzer auf die Verwendung des Microsoft-Authentifizierungsanbieters eingestellt ist:

  • Besuchen Sie die PlayFab-Anmeldeseite.
  • Wählen Sie Bei Microsoft anmelden aus, um auf Ihr PlayFab-Konto zuzugreifen.

Wenn Sie sich anmelden können, ist das Konto auf die Verwendung des Microsoft-Authentifizierungsanbieters festgelegt.

Game Manager-Berechtigungen für Insights

Sie müssen Ihrem Konto eine Benutzerrolle mit den folgenden aktivierten Game Manager-Berechtigungen zuweisen:

  • Admin status.
  • Zugriff auf die Registerkarte "Explorer" und zugehörige Daten.
  • Lese- und Schreibzugriff auf Analytics-Daten.

Sie können entweder eine neue Benutzerrolle erstellen oder diese Berechtigungen einer vorhandenen Rolle hinzufügen.

Weitere Voraussetzungen

Installieren von Python-Paketen

  1. Installieren Sie die folgenden Python-Pakete mit pip:

    • azure-kusto-data
    • azure-kusto-ingest
    • Adal

  2. Im Folgenden finden Sie ein Beispielskript für die ersten Schritte.

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)

Weitere Ressourcen

  • Last updated on