Criar e usar visuais R no Power BI
APLICA-SE A:
Serviço Power BI do Power BI Desktop 
Atualmente, os visuais R só podem ser criados no Power BI Desktop e, em seguida, publicados no serviço do Power BI. Para obter mais informações sobre como criar visuais R, consulte Criar visuais do Power BI usando R .
Exibindo visuais do R no serviço do Power BI
O serviço do Power BI dá suporte à exibição e interação com visuais criados com scripts R. Os elementos visuais criados com scripts R, comumente chamados de visuais R, podem apresentar modelagem e análise de dados avançadas, como previsão, usando o rico poder de análise e visualização do R.
Nota
A linguagem de programação R está entre as linguagens de programação mais utilizadas por estatísticos, cientistas de dados e analistas de negócios. A linguagem R tem uma comunidade de código aberto que oferece mais de 7.000 pacotes de complementos, bem como grupos de usuários R amplamente utilizados.
Os visuais R são criados em um relatório do Power BI Desktop, como o relatório mostrado na imagem a seguir.
Depois que o relatório é criado no Power BI Desktop, você pode publicar o relatório contendo um ou mais visuais R no serviço do Power BI.
No serviço, nem todos os pacotes R são suportados. Consulte os pacotes suportados no final deste artigo para obter a lista de pacotes atualmente suportados no serviço do Power BI.
Você pode baixar este arquivo de exemplo do Power BI Desktop (arquivo .pbix) que contém alguns visuais R para ver como eles funcionam e experimentar.
Os visuais R criados no Power BI Desktop e, em seguida, publicados no serviço do Power BI, geralmente se comportam como qualquer outro visual no serviço do Power BI. Você pode interagir, filtrar, fatiar ou compartilhá-los com outras pessoas. No entanto, ao contrário de outros elementos visuais, os visuais R não podem mostrar dicas de ferramentas e não podem ser usados para filtrar outros elementos visuais.
Como você pode ver na imagem a seguir, os visuais R no serviço do Power BI aparecem em grande parte e se comportam como qualquer outro visual. Os usuários não precisam estar cientes do script R subjacente que criou o visual.
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.
Esses riscos existem principalmente na fase de criação, quando o autor do script executa o script em seu próprio computador.
O serviço do Power BI aplica uma tecnologia de área restrita para proteger os usuários e o serviço contra riscos de segurança.
Essa abordagem de área restrita impõe algumas restrições aos scripts R em execução no serviço do Power BI, como acessar a Internet ou acessar outros recursos que não são necessários para criar o visual R.
Experiência de erro de scripts R
Quando um script R encontra um erro, o visual R não é plotado e uma mensagem de erro é exibida. Para obter detalhes sobre o erro, selecione Ver detalhes do erro visual R na tela, conforme mostrado na imagem a seguir.
Como outro exemplo, a imagem a seguir mostra a mensagem de erro que aparece quando um script R não pôde ser executado corretamente devido a um pacote R ausente no Azure.
Licenciamento
Os visuais R exigem uma licença do Power BI Pro ou Premium por usuário (PPU) para renderizar em relatórios, atualizar, filtrar e filtrar entre si. Para obter mais informações sobre licenças do Power BI Pro e como elas diferem das licenças gratuitas, consulte Conteúdo do Power BI Pro - o que é?
Os usuários gratuitos do Power BI só podem consumir blocos compartilhados com eles em espaços de trabalho Premium. Para obter mais informações sobre o Premium, consulte comprar o Power BI Pro para obter mais informações.
A tabela a seguir descreve os recursos visuais do R com base no licenciamento.
| Criar visuais R no Power BI Desktop | Criar relatórios de serviço do Power BI com visuais R | Exibir visuais R em relatórios | |
|---|---|---|---|
| Convidado (Power BI incorporado) | Suportado | Não suportado | Suportado apenas na capacidade Premium/Azure |
| Locatário não gerenciado (domínio não verificado) | Suportado | Não suportado | Não suportado |
| Locatário gerenciado com licença gratuita | Suportado | Não suportado | Suportado apenas na capacidade Premium |
| Locatário gerenciado com licença Pro ou PPU | Suportado | Suportado | Suportado |
Visão geral dos pacotes R
Os pacotes R são coleções de funções, dados e código compilado R que são combinados em um formato bem definido. Quando o R é instalado, ele vem com um conjunto padrão de pacotes, e outros pacotes estão disponíveis para download e instalação. Uma vez instalado, um pacote R deve ser carregado na sessão a ser usada. A principal fonte de pacotes R gratuitos é o CRAN, a Comprehensive R Archive Network.
O Power BI Desktop pode usar qualquer tipo de pacotes R sem limitação. Você pode instalar pacotes R para uso no Power BI Desktop por conta própria (usando o RStudio IDE, por exemplo).
Os visuais R no serviço do Power BI são suportados pelos pacotes encontrados na seção Pacotes Suportados encontrada neste artigo. Se você não encontrar um pacote em que esteja interessado entre a lista de pacotes suportados, você pode solicitar o suporte do pacote. Para obter mais informações, consulte Pacotes R no serviço do Power BI para obter informações sobre como solicitar suporte.
Requisitos e limitações dos pacotes R
Há um punhado de requisitos e limitações para pacotes R:
O serviço Power BI suporta pacotes R com licenças de software livres e de código aberto, como GPL-2, GPL-3, MIT+ e assim por diante.
O serviço do Power BI dá suporte a pacotes publicados em CRAN. O serviço não suporta pacotes R privados ou personalizados. Incentivamos os usuários a disponibilizarem seus pacotes privados no CRAN antes de solicitar que o pacote esteja disponível no serviço do Power BI.
Para o Power BI Desktop tem duas variações para pacotes R:
- Para visuais R, você pode instalar qualquer pacote, incluindo pacotes R personalizados.
- Para visuais R personalizados, apenas pacotes CRAN públicos são suportados para autoinstalação dos pacotes.
Por motivos de segurança e privacidade, atualmente não suportamos pacotes R que fornecem consultas cliente-servidor pela World Wide Web (como o RgoogleMaps) no serviço. A rede é bloqueada para tais tentativas. Para obter mais informações, consulte Pacotes R no serviço do Power BI para obter uma lista de pacotes R com e sem suporte.
O processo de aprovação para a inclusão de um novo pacote R tem uma árvore de dependências; Algumas dependências necessárias para serem instaladas no serviço não podem ser suportadas.
Pacotes suportados:
Para obter uma longa lista de pacotes R suportados (e a lista curta de pacotes não suportados), consulte o seguinte artigo:
Considerações e limitações
O suporte a visuais R é limitado aos pacotes identificados em Saiba quais pacotes R são suportados. Atualmente, não há suporte para pacotes personalizados.
Os dados usados pelo visual R para plotagem são limitados a 150.000 linhas. Se mais de 150.000 linhas forem selecionadas, apenas as 150.000 linhas superiores serão usadas e uma mensagem será exibida na imagem. Além disso, os dados de entrada têm um limite de 250 MB.
Se o modelo semântico de entrada de um R Visual tiver uma coluna que contenha um valor de cadeia de caracteres maior que 32766 caracteres, esse valor será truncado.
Todos os visuais R são exibidos a 72 pontos por polegada.
Apenas a plotagem para o dispositivo padrão é suportada.
Se um cálculo visual R exceder 60 segundos, o script expira e exibe um erro.
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 suporta dicas de ferramentas.
Os visuais R respondem ao realce de outros elementos visuais, mas não é possível selecionar elementos no visual R para filtrar outros elementos visuais.
Atualmente, não há suporte para visuais R para o tipo de dados Time . Em vez disso, use Data/Hora.
Os visuais R não são exibidos ao usar Publicar na Web.
Os visuais R não suportam a renomeação de colunas de entrada. Durante a execução do script, as colunas serão referidas pelo seu nome original.
Os visuais R não são impressos com a impressão de relatórios.
Não há suporte para visuais R no modo DirectQuery do Analysis Services.
Os visuais R têm a capacidade de converter rótulos de texto em elementos gráficos. Fazer isso no serviço do Power BI requer a seguinte etapa extra:
Adicione a seguinte linha no início do script R:
powerbi_rEnableShowText = 1
As fontes chinesa, japonesa e coreana exigem todas as etapas a seguir para funcionar corretamente no serviço do Power BI:
Instale o showtext do pacote R e todas as suas dependências. Você pode instalá-lo executando o seguinte script:
install.packages("showtext")Adicione a seguinte linha no início do script R:
powerbi_rEnableShowTextForCJKLanguages = 1