Freigeben über

Tutorial: Verbinden von Python mit Insights

Dieser Leitfaden hilft Ihnen bei den ersten Schritten mit Python mit Insights. Es verwendet das Azure Kusto Python SDK. Nachdem Sie eine Verbindung hergestellt haben, können Sie Ihre Spieldaten mit Python abfragen und die Bibliothek aus Jupyter Notebooks verwenden. Weitere Informationen zu anderen Tools, die Sie mit Insights herstellen können, finden Sie unter Verbinden externer Tools mit Insights.

Notiz

PlayFab Insights Management wurde am 11. Dezember 2023 eingestellt. Es wird empfohlen, Azure Data Explorer (ADX) Connections zu verwenden, um Ihre Leistung und Ihre Kosten in Zukunft zu verwalten. Wenn Ihr Titel immer noch Insights verwendet, lesen Sie diesen Artikel, um Details zur Implementierung zu erhalten. Weitere Informationen finden Sie im Blog zur Veraltung von Insights.

Voraussetzungen

Bei Azure AD authentifizierte PlayFab-Konto

Sie benötigen ein PlayFab-Konto oder einen Benutzer, für den 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 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 festgelegt 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 so festgelegt, dass der Microsoft-Authentifizierungsanbieter verwendet wird.

Game Manager-Berechtigungen für Insights

Sie müssen Ihrem Konto eine Benutzerrolle zuweisen, bei der die folgenden Game Manager-Berechtigungen aktiviert sind:

  • Admin status.
  • Zugriff auf die Registerkarte Explorer und die zugehörigen 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 mithilfe von 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