A análise de dados tem sido um fator definitivo na tomada de decisões empresariais. Se você procura uma maneira de conectar e analisar rapidamente seus dados em tempo real, a API do Power BI pode ser a sua solução. A API do Power BI permite extrair dados de seus painéis e relatórios do Power BI e criar e publicar novo conteúdo em seu espaço de trabalho do Power BI.
Neste tutorial, você aprenderá a acessar e manipular seus dados, criar relatórios e painéis personalizados, e compartilhar suas insights.
Explore e comece a tomar decisões mais informadas com a API do Power BI!
Pré-requisitos
Este tutorial será uma demonstração prática. Para acompanhar, certifique-se de ter o seguinte:
- A PowerBI account.
- Uma plataforma de API para construir e usar APIs – Este tutorial utiliza o Postman.
- Power BI Desktop – Este tutorial utiliza a versão 2.105.664.0.
Configurando Seu Ambiente da API do Power BI
O Power BI é uma ferramenta de Business Intelligence (BI) oferecida pela Microsoft que fornece análises em tempo real, modelagem extensiva e desenvolvimento personalizado. Esta ferramenta tem liderado a carga tornando a análise de negócios mais eficiente por meio de serviços intuitivos e interativos.
Para aproveitar a API do Power BI, você primeiro deve configurar seu Ambiente de API do Power BI usando o portal de desenvolvedores do Power BI para estabelecer a integração perfeita da API REST do Power BI:
1. Abra seu navegador favorito, acesse o Portal de Desenvolvedores do Power BI e faça login com suas credenciais do Power BI.
2. Uma vez logado, como mostrado abaixo, clique em Avançar para continuar a integração do Power BI API REST.
?Lembre-se de usar a versão mais recente da API REST do Power BI. A Microsoft lança regularmente atualizações para a API, e o uso da versão mais atual pode garantir melhor desempenho e estabilidade.
3. Em seguida, registre sua aplicação com o seguinte:
- Nome da Aplicação – Forneça um nome para sua aplicação.
- Tipo de Aplicação – Escolha um tipo que descreva sua aplicação. A escolha deste tutorial é o tipo do lado do servidor.
- Página Inicial e URL de Redirecionamento – Forneça a URL da página inicial de sua aplicação e uma URL para onde os usuários serão redirecionados após fazer login.
4. Agora, role para baixo, selecione a permissão de acesso necessária, que inclui acesso de leitura principal para ler conjuntos de dados para sua integração, e clique em Registrar.
Uma vez que sua aplicação estiver registrada, você receberá uma Chave Secreta de Aplicação e uma Chave de Aplicação para acessar sua aplicação registrada.
5. Armazene o ID da Aplicação e a Chave Secreta da Aplicação em um local seguro.
6. Em seguida, clique em Aceitar para conceder direitos de acesso à sua conta e continuar o processo de integração do Power BI REST API.
Uma vez autorizado, seu navegador será redirecionado para a URL de Redirecionamento, onde você receberá um “erro 404 de HTTP” dizendo que você não possui nenhuma aplicação web local (passo sete).
7. Na seção URL Solicitada, copie a URL e salve com segurança o texto que você vê após o código para o processo de Integração do Power BI REST API.
8. Inicie sua plataforma de API (Postman) e chame o endpoint abaixo da Power BI REST API.
https://login.microsoftonline.com/common/oauth2/v2.0/tokenA Power BI REST API possui diferentes endpoints para cenários e casos de uso. Certifique-se de escolher o endpoint correto para garantir que você esteja obtendo os dados de que precisa da maneira mais eficiente possível.
Assegure-se de usar o método POST com as seguintes informações: client_id, scope, code, redirect_url, grant_type e client_secret.
A Power BI REST API suporta vários verbos, incluindo GET, POST, PATCH e DELETE. Certifique-se de usar o verbo adequado para a tarefa que está tentando realizar.
9. Após chamar o endpoint, copie e salve o valor do access_token de forma segura. O token de acesso será uma autorização ao acessar qualquer endpoint.
?Observe que limitar o número de chamadas à API é essencial. Fazer várias chamadas à API em rápida sucessão pode sobrecarregar o sistema. Use paginação para recuperar dados em partes. Mas se precisar chamar os mesmos dados várias vezes, considere usar cache.
Com um ambiente da API PowerBI totalmente funcional, você está a um passo de realizar o seguinte:
- Integrar relatórios, painéis e conjuntos de dados do Power BI em aplicativos personalizados.
- Automatizar a criação e gerenciamento de relatórios e painéis.
- Extrair dados do Power BI para análises adicionais usando um conjunto de APIs da web RESTful.
?Asegure-se de utilizar Azure Application Insights ou outras ferramentas de monitoramento para acompanhar a implementação das suas APIs REST do Power BI e identificar possíveis gargalos ou problemas potenciais.
Obtendo a Lista de Conjuntos de Dados e Relatórios
Com um token de acesso à mão, você pode obter dados do seu espaço de trabalho do Power BI usando o mesmo endpoint. Seu token de acesso concederá direitos de acesso.
?Observação: Otimizar o tamanho dos seus dados removendo colunas ou linhas desnecessárias é crucial. Conjuntos de dados grandes podem prejudicar o desempenho da API.
1. Visite a documentação do Power BI para obter conjuntos de dados e copie a URL HTTP, conforme mostrado abaixo. Você usará esta URL para obter uma lista de conjuntos de dados usando a API REST do Power BI.
Em seguida, no Postman, insira o endpoint que você copiou na etapa um e forneça o token de autorização que você copiou na última etapa da seção “Configurando seu Ambiente de API do Power BI”.
3. Acesse a documentação da API REST do Power BI para obter a lista de relatórios.
4. Agora, copie a URL para obter uma lista de relatórios do seu espaço de trabalho.
5. No Postman, cole a URL que você copiou na etapa quatro, insira seu token de acesso como chave de autorização e clique em Enviar.
Conectando Dados Externos ao Espaço de Trabalho do Power BI
Obter dados do espaço de trabalho do Power BI usando o Endpoint REST do Power BI pode ser mais útil se você visualizar os dados. Você pode visualizar seus dados como desejar a partir de uma API de terceiros em seu espaço de trabalho.
Neste tutorial, você irá buscar dados de uma API de terceiros, API de Piadas do Chuck Norris.
1. Visite a documentação da API de Piadas do Chuck Norris e copie a URL, conforme mostrado abaixo.
https://api.chucknorris.io/jokes/random
2. Em seguida, acesse a URL que você copiou no passo um em seu navegador.
3. Inicie o Power BI Desktop e abra a janela do Editor de Consultas do Power Query.
4. Agora, cole a URL que você copiou no passo um na janela pop-up, conforme mostrado abaixo, e clique em OK.
Aguarde os dados carregarem via API.
5. Assim que os dados forem carregados, verifique se estão corretos.
6. Por fim, visualize os dados carregados como desejar.
Conclusão
Ao longo deste tutorial, você aprendeu a configurar um ambiente de API do Power BI onde carregou e visualizou dados via API em seu Power BI Desktop. Você viu como a API do Power BI é valiosa para empresas que desejam entender melhor seus dados.
Com a API do Power BI, você pode facilitar a análise e visualização de grandes quantidades de informações, conectando várias fontes de dados e automatizando a geração de relatórios. Além disso, a capacidade da API de atualizar os dados em tempo real permite que você tome decisões baseadas em dados de forma rápida e confiante.
Por que não explorar ainda mais a documentação da API tentando alguns pequenos projetos práticos para ganhar experiência? Dedique um tempo para aprender e entender o Endpoint REST do Power BI. Eventualmente, você poderá desbloquear todo o potencial do Power BI e tomar decisões orientadas por dados para sua organização ou projetos pessoais!