Criar visuais do Power BI usando o RCreate Power BI visuals using R

Com o Power BI Desktop, é possível usar o R para visualizar seus dados.With Power BI Desktop, you can use R to visualize your data. O R é uma linguagem e um ambiente para gráficos e computação estatística.R is a language and environment for statistical computing and graphics.

Instalar o RInstall R

Por padrão, o Power BI Desktop não inclui, implanta ou instala o mecanismo do R.By default, Power BI Desktop doesn't include, deploy, or install the R engine. Para executar scripts R no Power BI Desktop, é necessário instalar o R em seu computador local separadamente.To run R scripts in Power BI Desktop, you must separately install R on your local computer. É possível baixar e instalar o R gratuitamente em vários locais, incluindo a página de download do Revolution Open e o Repositório CRAN.You can download and install R for free from many locations, including the Revolution Open download page, and the CRAN Repository. A versão atual do script R no Power BI Desktop dá suporte a caracteres Unicode, bem como espaços (caracteres vazios) no caminho de instalação.The current release of R scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Habilitar visuais R no Power BI DesktopEnable R visuals in Power BI Desktop

Após instalar o R, o Power BI Desktop o habilita automaticamente.After you've installed R, Power BI Desktop enables it automatically. Para verificar se o Power BI Desktop habilitou o R no local correto, siga estas etapas:To verify that Power BI Desktop has enabled R in the correct location, follow these steps:

  1. No menu do Power BI Desktop, selecione Arquivo > Opções e configurações > Opções.From the Power BI Desktop menu, select File > Options and settings > Options.

  2. No lado esquerdo da página Opções, em Global, selecione Script R.On the left side of the Options page, under Global, select R scripting.

  3. Nas Opções de script R, verifique se sua instalação local do R foi especificada nos Diretórios base do R detectados e se ela reflete adequadamente a instalação local do R que você deseja que o Power BI Desktop use.Under R script options, verify that your local R installation is specified in Detected R home directories and that it properly reflects the local R installation you want Power BI Desktop to use. Na imagem a seguir, o caminho para a instalação local do R é C:\Arquivos de Programas\R Open\R-3.5.3\ .In the following image, the path to the local installation of R is C:\Program Files\R Open\R-3.5.3\.

    Página de opções de script R

Após verificar sua instalação do R, você já poderá começar a criar visuais do R.After you've verified your R installation, you’re ready to begin creating R visuals.

Criar visuais R no Power BI DesktopCreate R visuals in Power BI Desktop

  1. Selecione o ícone Visual do R no painel Visualização para adicionar um visual do R.Select the R Visual icon in the Visualization pane to add an R visual.

    Ícone do visual do R no painel Visualização

  2. Na janela Habilitar visuais de script exibida, selecione Habilitar.In the Enable script visuals window that appears, select Enable.

    Habilitar visuais de script

    Quando você adiciona um visual do R a um relatório, o Power BI Desktop realiza as seguintes alterações:When you add an R visual to a report, Power BI Desktop makes the following changes:

    • Uma imagem do visual do R no espaço reservado aparece na tela de relatório.A placeholder R visual image appears on the report canvas.

    • O editor de script R aparece na parte inferior do painel central.The R script editor appears along the bottom of the center pane.

    Editor de script R

  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 você faria com qualquer outro visual do Power BI Desktop.In the Values section of the Visualization pane, drag fields from the Fields pane that you want to consume in your R script, just as you would with any other Power BI Desktop visual. Ou você também pode selecionar os campos diretamente no painel Campos.Alternatively, you can also select the fields directly in the Fields pane.

    Somente os campos que você adicionou à seção Valores estão disponíveis para o seu script R.Only fields that you've added to the Values section are available to your R script. Você pode adicionar novos campos ou remover os desnecessários da seção Valores ao trabalhar em seu script R no editor do script R.You can add new fields or remove unneeded fields from the Values section while working on your R script in the R script editor. O Power BI Desktop detecta automaticamente os campos que você adicionou ou removeu.Power BI Desktop automatically detects which fields you've added or removed.

    Observação

    O tipo de agregação padrão para visuais R é não resumir.The default aggregation type for R visuals is do not summarize.

  4. Agora você pode usar os dados selecionados para plotar:Now you can use the data you selected to create a plot:

    • Ao selecionar campos, o editor de script R gera um código de associação de script R com suporte para esses campos na seção cinza na parte superior do painel do editor.As you select fields, the R script editor generates supporting R script binding code for those fields in the gray section along the top of the editor pane.
    • Se você remover um campo, o editor do script R removerá automaticamente o código de suporte para esse campo.If you remove a field, the R script editor automatically removes the supporting code for that field.

    No exemplo mostrado na imagem a seguir, três campos são selecionados: hp, gear e drat.In the example shown in the following image, three fields are selected: hp, gear, and drat. Em decorrência dessas seleções, o editor de script R gera código de associação, que é resumido da seguinte maneira:As a result of those selections, the R script editor generates binding code, which is summarized as follows:

    • Crie um dataframe denominado dataset, composto pelos diferentes campos selecionados pelo usuário.Create a dataframe called dataset, which is comprised of the different fields selected by the user.
    • A agregação padrão é: não resumir.The default aggregation is: do not summarize.
    • Semelhantes aos elementos visuais de tabela, os campos são agrupados e as linhas duplicadas aparecem somente uma vez.Similar to table visuals, fields are grouped and duplicate rows appear only once.

    Código do editor de script R

    Dica

    Em certos casos, talvez você não queira que ocorra um agrupamento automático, ou talvez queira exibir todas as linhas, incluindo duplicatas.In certain cases, you may not want automatic grouping to occur, or you may want all rows to appear, including duplicates. Nesse caso, adicione um campo de índice ao conjunto de dados que faz com que todas as linhas sejam consideradas exclusivas, impedindo o agrupamento.In that case, add an index field to your dataset, which causes all rows to be considered unique and prevents grouping.

    O dataframe gerado é chamado de conjunto de dados e você acessa as colunas selecionadas por seus respectivos nomes.The generated dataframe is named dataset, and you access selected columns by their respective names. Por exemplo, acesse o campo de engrenagem adicionando dataset$gear ao script R.For example, access the gear field by adding dataset$gear to your R script. Para campos com espaços ou caracteres especiais, use aspas simples.For fields with spaces or special characters, use single quotes.

  5. Como o dataframe gerado automaticamente pelos campos selecionados, você poderá escrever um script R, que o Power BI Desktop plota para o dispositivo padrão R.With the dataframe automatically generated by the fields you selected, you’re ready to write an R script, which Power BI Desktop plots to the R default device. Depois que você tiver concluído o script, selecione Executar script à direita da barra de título do Editor de script R.After you've completed the script, select Run script on the right side of the R script editor title bar.

    Ao selecionar Executar script, o Power BI Desktop identifica a plotagem e a apresenta na tela.When you select Run script, Power BI Desktop identifies the plot and presents it on the canvas. Como o processo é executado em sua instalação local do R, verifique se os pacotes necessários estão instalados.Because the process is executed on your local R installation, make sure the required R packages are installed.

    O Power BI Desktop plota novamente o visual quando qualquer um dos seguintes eventos ocorre:Power BI Desktop replots the visual when any of the following events occur:

    • Selecione Executar script na barra de título do Editor de script R.You select Run script from the R script editor title bar.

    • Uma alteração na data ocorre devido à atualização, à filtragem ou ao realce dos dados.A data change occurs because of data refreshing, filtering, or highlighting.

      A imagem a seguir mostra um exemplo de código de plotagem da correlação, que plota as correlações entre atributos de tipos diferentes de carros.The following image shows an example of the correlation plot code, which plots the correlations between attributes of different types of cars.

      Exemplo de código de plotagem da correlação

  6. Para obter uma exibição ampliada das visualizações, minimize o editor de script R.To get a larger view of the visualizations, minimize the R script editor. Como outros visuais no Power BI Desktop, você pode realizar filtragem cruzada da plotagem da correlação selecionando uma seção específica (como carros esportivos) no visual em forma de rosca (o visual redondo à direita).Like other visuals in Power BI Desktop, you can cross filter the correlation plot by selecting a specific section (such as sports cars) in the donut-shaped visual (the round visual on the right).

    Exibição de visualização maior

  7. Modifique o script R para personalizar o visual e aproveitar o poder do R, adicionando parâmetros ao comando de plotagem.Modify the R script to customize the visual, and take advantage of the power of R by adding parameters to the plotting command.

    O comando original de plotagem é:The original plotting command is:

    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:Change the R script so that the plotting command is as follows:

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

    Como resultado, o visual do R agora plota círculos, só considera na metade superior e reorganiza a matriz para agrupar atributos correlacionados.As a result, the R visual now plots circles, only considers the upper half, and reorders the matrix to cluster correlated attributes.

    Plotagem do círculo do visual do R

    Quando você executa um script R que resulta em um erro, uma mensagem de erro é exibida na tela, em vez da plotagem do visual do R.When you execute an R script that results in an error, an error message displays on the canvas instead of the R visual plot. Para obter detalhes sobre o erro, selecione Ver detalhes no erro do visual do R.For details on the error, select See details from the R visual error.

    Erro do visual do R

Segurança de scripts do RR scripts security

Os visuais do R são criados com base nos scripts R, que podem conter código com riscos de segurança ou privacidade.R visuals are created from R scripts, which might contain code with security or privacy risks. Ao tentar exibir ou interagir com um visual R pela primeira vez, o usuário recebe uma mensagem de aviso de segurança.When attempting to view or interact with an R visual for the first time, a user is presented with a security warning message. Habilite visuais R somente se você confiar no autor e na fonte ou após examinar e compreender o script R.Only enable R visuals if you trust the author and source, or after you review and understand the R script.

Limitações conhecidasKnown limitations

Os visuais do R no Power BI Desktop têm as seguintes limitações:R visuals in Power BI Desktop have the following limitations:

  • Tamanhos de dados: Dados usados por um visual do R para plotar estão limitados a 150 mil linhas.Data sizes: Data used by an R visual for plotting is limited to 150,000 rows. Se mais de 150.000 linhas forem selecionadas, somente as primeiras 150.000 linhas serão usadas e uma mensagem será exibida na imagem.If more than 150,000 rows are selected, only the top 150,000 rows are used and a message is displayed on the image.

  • Resolução: todos os visuais do R são exibidos com 72 dpi.Resolution: All R visuals are displayed at 72 DPI.

  • Dispositivo de plotagem: somente a plotagem para o dispositivo padrão é compatível.Plotting device: Only plotting to the default device is supported.

  • Tempos de cálculo: se um cálculo de visual do R exceder cinco minutos, causará um erro de tempo limite.Calculation times: If an R visual calculation exceeds five minutes, it causes a time-out error.

  • Relacionamentos: assim como acontece com outros visuais do Power BI Desktop, se os campos de dados de tabelas diferentes sem uma relação definida entre eles forem selecionados, ocorrerá um erro.Relationships: As with other Power BI Desktop visuals, if data fields from different tables with no defined relationship between them are selected, an error occurs.

  • Atualizações: Visuais R são atualizados após atualizações de dados, filtragem e realce.Refreshes: R visuals are refreshed upon data updates, filtering, and highlighting. No entanto, a própria imagem não é interativa e não pode ser a origem da filtragem cruzada.However, the image itself isn't interactive and can't be the source of cross-filtering.

  • Realces: os visuais do R responderão se você realçar outros visuais, mas não puder selecionar elementos no visual do R para realizar filtragem cruzada de outros elementos.Highlights: R visuals respond if you highlight other visuals, but you can't select elements in the R visual to cross filter other elements.

  • Exibir dispositivos: Somente plotagens realizadas no dispositivo de vídeo padrão R são exibidos corretamente na tela.Display devices: Only plots that are plotted to the R default display device are displayed correctly on the canvas. Evite o uso explícito de um dispositivo de vídeo diferente do R.Avoid explicitly using a different R display device.

  • Renomeação de coluna: os visuais do R não dão suporte à renomeação de colunas de entrada.Column renaming: R visuals do not support renaming input columns. As colunas serão referenciadas pelo nome original durante a execução do script.Columns will be referred to by their original name during script execution.

  • Instalações do RRO: nesta versão, a versão de 32 bits do Power BI Desktop não identifica automaticamente as instalações do RRO; você deve fornecer manualmente o caminho para o diretório da instalação do R em Opções e configurações > Opções > Script do R.RRO installations: In this release, the 32-bit version of Power BI Desktop doesn't automatically identify RRO installations; you must manually provide the path to the R installation directory in Options and settings > Options > R Scripting.

Próximas etapasNext steps

Para obter informações sobre o R no Power BI, confira os seguintes artigos:For more information about R in Power BI, see the following articles: