Pular para o conteúdo principal

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.
O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as Conexões do Azure Data Explorer (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.

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

Instalar pacotes do Python

  1. Instale os seguintes pacotes do Python usando o pip:
    • azure-kusto-data
    • azure-kusto-ingest
    • adal
  2. Veja abaixo um script de exemplo para começar.

Recursos adicionais

Última modificação em 6 de outubro de 2026