Partilhar via


Inserir um componente do Power BI em um notebook Jupyter

O jupyter notebook simplifica a criação e o compartilhamento de relatórios do Power BI. Com o Jupyter Notebook, você pode inserir ou criar relatórios rapidamente.

O powerbiclient pacote do Python permite inserir relatórios do Power BI facilmente em notebooks Jupyter. Você pode exportar dados de visuais em um relatório do Power BI para o jupyter notebook para exploração detalhada de dados. Você também pode filtrar o relatório para análise rápida ou usar indicadores para aplicar uma exibição salva.

Instalar o pacote do Cliente do Power BI

O powerbiclient pacote pode ser encontrado no PyPI. Ele também é de software livre no GitHub.

Para instalar o pacote, você pode usar pip.

  • Se você estiver usando o Jupyter Notebook:

    pip install powerbiclient
    
  • Se você estiver usando o JupyterLab:

    pip install powerbiclient
    jupyter labextension install @jupyter-widgets/jupyterlab-manager
    
  • Se você estiver usando Jupyter Notebook 5.2 ou anterior, talvez você também precise habilitar a nbextension:

    jupyter nbextension enable --py [--sys-prefix|--user|--system] powerbiclient
    

Inserir um relatório do Power BI em um jupyter notebook

Um gif animado que mostra um relatório do Power BI inserido no Jupyter Notebook.

Para obter informações detalhadas de uso, consulte o wiki do GitHub.

Inserir um relatório

Este exemplo mostra como inserir um relatório do Power BI usando o pacote .

  1. Importar modelos e classe de relatório do pacote:

    from powerbiclient import Report, models
    
  2. Autentique-se no Power BI usando Azure AD:

    # Import the DeviceCodeLoginAuthentication class to authenticate against Power BI
    from powerbiclient.authentication import DeviceCodeLoginAuthentication
    
    # Initiate device authentication
    device_auth = DeviceCodeLoginAuthentication()
    
  3. Defina a ID do workspace e a ID do relatório que você gostaria de inserir:

    group_id="Workspace ID"
    report_id="Report ID"
    
  4. Crie uma instância do relatório do Power BI e carregue o relatório na célula de saída:

    report = Report(group_id=group_id, report_id=report_id, auth=device_auth)
    
    report
    

Executar a demonstração

O repositório GitHub inclui uma demonstração do Jupyter Notebook que insere o relatório de um usuário. Ele demonstra o fluxo completo de inserção e interação com o relatório do Power BI, incluindo:

  • Manipuladores de eventos de relatório
  • Obter lista de páginas
  • Obter lista de visuais
  • Exportar e visualizar dados visuais
  • Aplicar filtros

Para executar a demonstração:

  1. Certifique-se de ter os seguintes pré-requisitos:

    • pandas
    • matplotlib
  2. Execute os comandos a seguir:

    cd demo
    jupyter notebook
    
  3. Execute demo.ipynb.

Criar um relatório rapidamente

Você também pode gerar facilmente um relatório rápido do Power BI com base em seus dados em apenas algumas etapas. Use qualquer DataFrame em seu notebook para transformá-lo rapidamente em visualizações perspicazes". Salve o relatório, se desejar, e use-o como faria com qualquer outro relatório.

Para obter uma descrição detalhada, consulte Criar rapidamente um relatório usando o Jupyter Notebook. Para obter uma demonstração do Jupyter Notebook, veja o repositório GitHub.

Próximas etapas