Compartilhar via


Criar e usar visuais do R no Power BI

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

Atualmente, os visuais do 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 do R, confira Criar visuais do Power BI usando o R.

Exibição de 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 do R. Os visuais criados com scripts do R, normalmente chamados de visuais do R, podem apresentar formatação e análise de dados avançadas, como previsão, usando o poder da análise e da visualização avançadas do R.

Observação

A linguagem de programação R está entre as linguagens de programação mais amplamente usadas por estatísticos, cientistas de dados e analistas de negócios. A linguagem R conta com uma comunidade de código aberto que oferece mais de 7.000 pacotes de complementos, além de Grupos de Usuários do R amplamente utilizados.

Os visuais do R são criados em um relatório do Power BI Desktop, como o relatório mostrado na imagem a seguir.

Desktop report with two visuals.

Depois que o relatório for criado no Power BI Desktop, será possível publicar o relatório contendo um ou mais visuais do R no serviço do Power BI.

No serviço, não há suporte para todos os pacotes do R. Confira os pacotes com suporte ao final deste artigo para obter a lista dos pacotes atualmente com suporte no serviço do Power BI.

Você pode baixar este arquivo de exemplo do Power BI Desktop (arquivo .pbix) que contém alguns visuais do R para ver como isso funciona e testá-lo.

Os visuais do R criados no Power BI Desktop e publicados no serviço do Power BI geralmente se comportam como qualquer outro visual no serviço do Power BI. Você pode interagir, filtrar, dividir ou compartilhá-los com outras pessoas. Entretanto, diferentemente de outros visuais, os visuais R não podem mostrar dicas de ferramentas e não podem ser usados para filtrar outros visuais.

Como você pode ver na imagem a seguir, os visuais do 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.

Screenshot of the report page in the Power BI service.

Segurança de scripts do R

Os visuais do R são criados com base nos scripts do R que, potencialmente, 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 o executa 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 executados no serviço do Power BI, como o acesso à Internet ou a outros recursos que não são necessários para criar o visual R.

Experiência de erro com scripts do R

Quando um script R encontra um erro, o visual do R não é plotado e uma mensagem de erro é exibida. Para obter detalhes sobre o erro, selecione Ver detalhes no erro do visual do R na tela, conforme mostrado na imagem a seguir.

Screenshot showing an R visual error message.

Como outro exemplo, a imagem a seguir mostra a mensagem de erro que aparece quando um script do R não é executado corretamente devido à ausência de um pacote do R no Azure.

Screenshot showing a runtime error.

Licenças

Os elementos visuais do R exigem obter uma licença do Power BI Pro ou PPU (Premium por usuário) para renderizar relatórios, atualizações, filtros e filtros cruzados. Para obter mais informações sobre as licenças do Power BI Pro e como elas diferem das licenças gratuitas, consulte Conteúdo do Power BI Pro; o que é isso?

Os usuários da versão gratuita do Power BI só poderão consumir blocos compartilhados com eles nos workspaces Premium. Para obter mais informações sobre o Premium, consulte comprando o Power BI Pro para obter mais informações.

A tabela a seguir descreve as funcionalidades dos visuais do R com base em licenciamento.

Criar visuais do R no Power BI Desktop Criar relatórios de serviços do Power BI com visuais R Exibir visuais R em relatórios
Convidado (Power BI Embedded) Com suporte Sem suporte Compatível apenas na capacidade Premium/Azure
Locatário não gerenciado (domínio não verificado) Com suporte Sem suporte Sem suporte
Locatário gerenciado com licença gratuita Com suporte Sem suporte Compatível apenas na capacidade Premium
Locatário gerenciado com uma licença Pro ou PPU Com suporte Compatível Com suporte

Visão geral de pacotes de R

Pacotes de R são coleções de funções de R, dados e código compilado 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 para instalação. Depois de instalado, um pacote do R deve ser carregado na sessão a ser usada. A principal origem de pacotes de R gratuitos é o CRAN, a Rede Completa de Arquivos do R.

O Power BI Desktop pode usar qualquer tipo de pacotes de R sem limitação. É possível instalar pacotes de R para uso no Power BI Desktop por conta própria (usando o IDE RStudio, por exemplo).

Os pacotes encontrados na seção Pacotes com suporte encontrada neste artigo dão suporte aos visuais do R no serviço do Power BI. Se você não encontrar um pacote do seu interesse na lista de pacotes com suporte, será possível 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 de pacotes de R

Há alguns requisitos e limitações dos pacotes de R:

  • O serviço do Power BI dá suporte a pacotes R com licenças de software livre 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 no CRAN. O serviço não dá suporte a pacotes de R personalizados ou particulares. Incentivamos os usuários a disponibilizar seus pacotes privados no CRAN antes de solicitar que o pacote esteja disponível no serviço do Power BI.

  • O Power BI Desktop tem duas variações para pacotes de R:

    • Para visuais R, você pode instalar qualquer pacote, inclusive pacotes R personalizados.
    • Para visuais R personalizados, somente os pacotes públicos do CRAN tem suporte para a autoinstalação dos pacotes.
  • Por motivos de privacidade e segurança, atualmente não damos suporte a pacotes de R que forneçam consultas de cliente-servidor por meio da World Wide Web (como RgoogleMaps) no serviço. A rede está bloqueada para essas tentativas. Para obter mais informações, consulte Pacotes R no serviço do Power BI para obter uma lista de pacotes R com suporte e sem suportados.

  • O processo de aprovação para a inclusão de um novo pacote de R tem uma árvore de dependências; algumas delas que precisam ser instaladas no serviço não têm suporte.

Pacotes com suporte:

Para obter uma lista longa de pacotes do R com suporte (e a lista curta de pacotes sem suporte), leia o seguinte artigo:

Considerações e limitações

  • O suporte a visuais do R é limitado aos pacotes identificados em Saiba quais pacotes do R têm suporte. 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, somente as primeiras 150.000 linhas serão usadas e uma mensagem será exibida na imagem. Além disso, os dados de entrada têm um limite de 250 MB.

  • Caso o modelo semântico de entrada de um elemento visual do R tenha uma coluna com um valor de cadeia de caracteres superior a 32.766 caracteres, esse valor será truncado.

  • Todos os visuais R são exibidos a 72 pontos por polegada.

  • Só há suporte para plotagem no dispositivo padrão.

  • Se um cálculo do visual R exceder 60 segundos, o script atingirá o tempo limite e exibirá um erro.

  • Visuais R são atualizados após atualizações de dados, filtragem e realce. No entanto, a própria imagem não é interativa e não dá suporte a dicas de ferramenta.

  • Os visuais R respondem ao realce de outros visuais, mas não é possível selecionar elementos no visual R para fazer a filtragem cruzada de outros visuais.

  • Atualmente, não há suporte nos visuais do R para o tipo de dados Hora. Em vez disso, use Data/Hora.

  • Os visuais do R não são exibidos ao usar Publicar na Web.

  • Os visuais do R não dão suporte à renomeação de colunas de entrada. Durante a execução do script, as colunas serão referenciadas pelo seu nome original.

  • Os visuais R não são impressos com a impressão de relatórios.

  • Os visuais R são tem suporte com o modo DirectQuery do Analysis Services.

  • Os visuais do R podem 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 ao início do script de R:

      powerbi_rEnableShowText = 1

  • As fontes chinês, japonês e coreano exigem todas as seguintes etapas para funcionar corretamente no serviço do Power BI:

    1. Instale o showtext do pacote R e todas as suas dependências. Você pode instalá-lo executando o seguinte script:

      install.packages("showtext")

    2. Adicione a seguinte linha ao início do script de R:

      powerbi_rEnableShowTextForCJKLanguages =  1