Share via


Criar visuais do Power BI usando R

APLICA-SE A: Serviço Power BI do Power BI Desktop

Com o Power BI Desktop, você pode usar R para visualizar seus dados. R é uma linguagem e ambiente para computação estatística e gráfica.

Instalar R

Por padrão, o Power BI Desktop não inclui, implanta ou instala o mecanismo R. Para executar scripts R no Power BI Desktop, você deve instalar o R separadamente em seu computador local. Você pode baixar e instalar o R gratuitamente de vários locais, incluindo do repositório CRAN. A versão atual do script R no Power BI Desktop oferece suporte a caracteres Unicode e espaços (caracteres vazios) no caminho de instalação.

Habilitar visuais R no Power BI Desktop

Depois de instalar o R, o Power BI Desktop habilita-o automaticamente. Para verificar se o Power BI Desktop habilitou o R no local correto, siga estas etapas:

  1. No menu Power BI Desktop, selecione Opções de Arquivo e Opções de>configurações.>

  2. No lado esquerdo da página Opções , em Global, selecione Script R.

  3. Em Opções de script R, verifique se a instalação local do R está especificada nos diretórios base do R detetado e se ela reflete corretamente a instalação local do R que você deseja que o Power BI Desktop use. Na imagem a seguir, o caminho para a instalação local do R é C:\Program Files\R Open\R-3.4.4\.

    Screenshot of the R script options page, highlighting Detected R home directories.

Importante

A versão atual do R com suporte no Power BI Desktop e no serviço Power BI é a versão 3.4.4.

Depois de verificar a instalação do R, você estará pronto para começar a criar visuais R.

Criar visuais R no Power BI Desktop

  1. Selecione o ícone R Visual no painel Visualização para adicionar um visual R.

    Screenshot of the Visualization pane, highlighting the R Visual icon.

  2. Na janela Ativar visuais de script exibida, selecione Ativar.

    Screenshot of the Enable script visuals dialog, highlighting Enable.

    Quando você adiciona um visual R a um relatório, o Power BI Desktop faz as seguintes alterações:

    • Uma imagem visual R de espaço reservado aparece na tela do relatório.

    • O editor de scripts R aparece na parte inferior do painel central.

    Screenshot of the Power BI R script editor.

  3. Na seção Valores do painel Visualização, arraste os campos do painel Campos que você deseja consumir em seu script R, assim como faria com qualquer outro visual do Power BI Desktop. Como alternativa, você também pode selecionar os campos diretamente no painel Campos .

    Somente os campos que você adicionou à seção Valores estão disponíveis para o script R. Você pode adicionar novos campos ou remover campos desnecessários da seção Valores enquanto trabalha no script R no editor de scripts R. O Power BI Desktop deteta automaticamente quais campos você adicionou ou removeu.

    Nota

    O tipo de agregação padrão para visuais R é não resumir.

  4. Agora você pode usar os dados selecionados para criar um gráfico:

    • À medida que você seleciona campos, o editor de scripts R gera código de vinculação de script R de suporte para esses campos na seção cinza na parte superior do painel do editor .
    • Se você remover um campo, o editor de scripts R removerá automaticamente o código de suporte para esse campo.

    No exemplo mostrado na imagem a seguir, três campos são selecionados: Potência do cavalo, engrenagem e drat. Como resultado dessas seleções, o editor de scripts R gera código de vinculação, que é resumido da seguinte forma:

    • Crie um dataframe chamado modelo semântico, que é composto pelos diferentes campos selecionados pelo usuário.
    • A agregação padrão é: não resumir.
    • Semelhante aos elementos visuais de tabela, os campos são agrupados e os registos duplicados aparecem apenas uma vez.

    Screenshot of the R script editor, highlighting the script code.

    Gorjeta

    Em certos casos, talvez você não queira que o agrupamento automático ocorra ou que todas as linhas apareçam, incluindo duplicatas. Nesse caso, adicione um campo de índice ao seu modelo semântico, o que faz com que todas as linhas sejam consideradas exclusivas e impede o agrupamento.

    O dataframe gerado é chamado de modelo semântico e você acessa as colunas selecionadas por seus respetivos nomes. Por exemplo, acesse o gear campo adicionando dataset$gear ao seu script R. Para campos com espaços ou caracteres especiais, use aspas simples.

  5. Com o quadro de dados gerado automaticamente pelos campos selecionados, você está pronto para escrever um script R, que o Power BI Desktop plota para o dispositivo padrão R. Depois de concluir o script, selecione o ícone Executar script no lado direito da barra de título do editor de scripts R.

    Quando você seleciona o ícone Executar script, o Power BI Desktop identifica o gráfico e o apresenta na tela. Como o processo é executado em sua instalação R local, certifique-se de que os pacotes R necessários estejam instalados.

    O Power BI Desktop replota o visual quando ocorre qualquer um dos seguintes eventos:

    • Selecione o ícone Executar script na barra de título do editor de scripts R.

    • Uma alteração de dados ocorre devido à atualização, filtragem ou realce de dados.

      A imagem a seguir mostra um exemplo do código de gráfico de correlação, que plota as correlações entre atributos de diferentes tipos de carros.

      Screenshot of the Correlation plot code example.

  6. Para obter uma visão maior das visualizações, desmarque o visual R ou minimize o editor de scripts R. Como outros elementos visuais no Power BI Desktop, você pode filtrar o gráfico de correlação selecionando um valor específico, como Automático ou Manual, no gráfico de rosca à direita.

    Screenshot of the Correlation plot code example in the Larger visualization view.

  7. Modifique o script R para personalizar o visual e aproveite o poder do R adicionando parâmetros ao comando de plotagem.

    O comando de plotagem original é:

    corrplot(M, method = "color",  tl.cex=0.6, tl.srt = 45, tl.col = "black")
    

    Altere o script R para que o comando de plotagem seja o seguinte:

    corrplot(M, method = "circle", tl.cex=0.6, tl.srt = 45, tl.col = "black", type= "upper", order="hclust")
    

    Como resultado, o visual R agora plota círculos, considera apenas a metade superior e reordena a matriz para agrupar atributos correlacionados.

    Screenshot of the R visual circle plot example.

    Quando você executa um script R que resulta em um erro, uma mensagem de erro é exibida na tela em vez do gráfico visual R. Para obter detalhes sobre o erro, selecione Ver detalhes do erro visual R.

    Screenshot of the error message displayed on the canvas.

Segurança de scripts R

Os visuais R são criados a partir de scripts R, que podem conter código com riscos de segurança ou privacidade. Ao tentar visualizar ou interagir com um visual R pela primeira vez, um usuário recebe uma mensagem de aviso de segurança. Habilite os visuais R somente se confiar no autor e na fonte, ou depois de revisar e entender o script R.

Limitações conhecidas

Os visuais R no Power BI Desktop têm as seguintes limitações:

  • Tamanhos de dados: os dados usados por um visual R para plotagem são limitados a 150.000 linhas. Se mais de 150.000 linhas forem selecionadas, apenas as 150.000 linhas principais serão usadas e uma mensagem será exibida na imagem.

  • Tamanho de saída: R visual tem um limite de tamanho de saída de 2 MB.

  • Resolução: todos os visuais R são exibidos a 72 DPI.

  • Dispositivo de plotagem: somente a plotagem para o dispositivo padrão é suportada.

  • Tempos de cálculo: Se um cálculo visual R exceder cinco minutos, ele causará um erro de tempo limite.

  • Relações: Tal como acontece com outros elementos visuais do Power BI Desktop, se os campos de dados de tabelas diferentes sem relação definida entre eles forem selecionados, ocorrerá um erro.

  • Atualizações: os visuais R são atualizados após atualizações de dados, filtragem e realce. No entanto, a imagem em si não é interativa e não pode ser a fonte de filtragem cruzada.

  • Destaques: os visuais R respondem se você realçar outros elementos visuais, mas não é possível selecionar elementos no visual R para filtrar outros elementos.

  • Dispositivos de exibição: somente os gráficos plotados para o dispositivo de exibição padrão R são exibidos corretamente na tela. Evite usar explicitamente um dispositivo de exibição R diferente.

  • Renomeação de coluna: os visuais R não suportam a renomeação de colunas de entrada. As colunas serão referidas pelo seu nome original durante a execução do script.

  • Instalações de RRO: nesta versão, a versão de 32 bits do Power BI Desktop não identifica automaticamente as instalações de RRO; você deve fornecer manualmente o caminho para o diretório de instalação R em Opções e configurações>Opções>R Scripting.

Para obter mais informações sobre R no Power BI, consulte os seguintes artigos: