Executar scripts do R no Power BI DesktopRun R scripts in Power BI Desktop

É possível executar scripts do R diretamente no Power BI Desktop e importar os conjuntos de dados resultantes para um modelo de dados do Power BI Desktop.You can run R scripts directly in Power BI Desktop, and import the resulting datasets into a Power BI Desktop data model.

Instalar o RInstall R

Para executar scripts do R no Power BI Desktop, você precisa instalar o R em seu computador local.To run R scripts in Power BI Desktop, you need to install R on your local machine. É 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.

Executar scripts do RRun R scripts

Com apenas algumas etapas no Power BI Desktop, é possível executar scripts do R e criar um modelo de dados, por meio do qual você pode criar relatórios e compartilhá-los no serviço do Power BI.With just a few steps in Power BI Desktop you can run R scripts and create a data model, from which you can create reports, and share them on the Power BI service. O script R no Power BI Desktop agora dá suporte a formatos de número que contêm decimais (.) e vírgulas (,).R scripting in Power BI Desktop now supports number formats that contain decimals (.) and commas (,).

Preparar um script do RPrepare an R script

Para executar um script do R no Power BI Desktop, crie o script em seu ambiente de desenvolvimento local do R e certifique-se de que ele é executado com êxito.To run an R script in Power BI Desktop, create the script in your local R development environment, and make sure it runs successfully.

Para executar o script no Power BI Desktop, verifique se o script é executado com êxito em um espaço de trabalho novo e modificado.To run the script in Power BI Desktop, make sure the script runs successfully in a new and unmodified workspace. Isso significa que todos os pacotes e dependências devem ser explicitamente carregados e executados.This means that all packages and dependencies must be explicitly loaded and run. Você pode usar source() para executar scripts dependentes.You can use source() to run dependent scripts.

Ao preparar e executar um script R no Power BI Desktop, existem algumas limitações:When preparing and running an R script in Power BI Desktop, there are a few limitations:

  • Somente os quadros de dados são importados, portanto, tenha certeza de que os dados que você deseja importar para o Power BI são representados em um quadro de dadosOnly data frames are imported, so make sure the data you want to import to Power BI is represented in a data frame
  • Colunas que são digitadas como Complexas e Vetoriais não são importadas e são substituídas por valores de erro na tabela criada.Columns that are typed as Complex and Vector are not imported, and are replaced with error values in the created table.
  • Valores que são N/D são convertidos em valores NULL no Power BI DesktopValues that are N/A are translated to NULL values in Power BI Desktop
  • Qualquer script R que é executado por mais de 30 minutos expiraAny R script that runs longer than 30 minutes times out
  • Chamadas interativas no script R, como aguardar a entrada do usuário, interrompem a execução do scriptInteractive calls in the R script, such as waiting for user input, halts the script’s execution
  • Ao definir o diretório de trabalho dentro do script R, é necessário definir um caminho completo para o diretório de trabalho, em vez de um caminho relativoWhen setting the working directory within the R script, you must define a full path to the working directory, rather than a relative path

Executar o script do R e importar dadosRun your R script and import data

  1. No Power BI Desktop, o conector de dados de Script do R é encontrado em Obter Dados.In Power BI Desktop, the R Script data connector is found in Get Data. Para executar o Script R, selecione Obter Dados > Mais... e, em seguida, selecione Outros > Script R, como mostrado na imagem a seguir.To run your R Script, select Get Data > More..., then select Other > R Script as shown in the following image.

  2. Se o R estiver instalado no computador local, a versão mais recente instalada será selecionada como o mecanismo do R.If R is installed on your local machine, the latest installed version is selected as your R engine. Basta copiar o script na janela de script e selecionar OK.Simply copy your script into the script window and select OK.

  3. Se o R não estiver instalado, não for identificado ou se houver várias instalações no computador local, expanda Configurações de Instalação do R para exibir as opções de instalação ou para selecionar em qual instalação você deseja executar o script do R.If R is not installed, is not identified, or if there are multiple installations on your local machine, expand R Installation Settings to display installation options, or to select which installation you want to run the R script.

    Se o R estiver instalado e não for identificado, é possível fornecer explicitamente seu local na caixa de texto fornecida quando você expande Configurações de Instalação do R.If R is installed is not identified, you can explicitly provide its location in the text box provided when you expand R Installation Settings. Na imagem acima, o caminho C:\Arquivos de Programas\R\R-3.2.0 é explicitamente fornecido na caixa de texto.In the above image, the path C:\Program Files\R\R-3.2.0 is explicitly provided in the text box.

    As configurações de instalação do R estão localizadas centralmente na seção Script R do diálogo Opções.R installation settings are centrally located in the R Scripting section of the Options dialog. Para especificar as configurações de instalação do R, selecione Arquivo > Opções e configurações e Opções > Script R.To specify your R installation settings, select File > Options and settings and then Options > R Scripting. Se houver várias instalações do R disponíveis, será exibido um menu suspenso que permite selecionar qual instalação será usada.If multiple installations of R are available, a drop-down menu appears that allows you to select which installation to use.

  4. Selecione OK para executar o script do R.Select OK to run the R Script. Quando o script é executado com êxito, você pode escolher os quadros de dados resultantes para adicionar ao modelo do Power BI.When the script runs successfully, you can then choose the resulting data frames to add to the Power BI model.

AtualizarRefresh

É possível atualizar um script do R no Power BI Desktop.You can refresh an R script in Power BI Desktop. Quando você atualiza um script do R, o Power BI Desktop o executa novamente no ambiente do Power BI Desktop.When you refresh an R script, Power BI Desktop runs the R script again in the Power BI Desktop environment.

Próximas etapasNext steps

Analise as informações adicionais a seguir sobre o R no Power BI.Take a look at the following additional information about R in Power BI.