Exécuter des scripts R dans Power BI DesktopRun R scripts in Power BI Desktop

Vous pouvez exécuter des scripts R directement dans Power BI Desktop et importer les jeux de données obtenus dans un modèle de données 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.

Installer RInstall R

Pour exécuter des scripts R dans Power BI Desktop, vous devez installer R sur votre ordinateur local.To run R scripts in Power BI Desktop, you need to install R on your local machine. Vous pouvez télécharger et installer R gratuitement à partir de nombreux emplacements, dont les pages Download Revolution R Open et CRAN Repository.You can download and install R for free from many locations, including the Revolution Open download page, and the CRAN Repository. La version actuelle des scripts R dans Power BI Desktop prend en charge les caractères Unicode ainsi que les espaces (caractères vides) dans le chemin d’installation.The current release of R scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Exécuter des scripts RRun R scripts

Dans Power BI Desktop, quelques étapes suffisent pour exécuter des scripts R et créer un modèle de données à partir duquel vous pouvez générer des rapports et les partager sur le service 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. Les scripts R dans Power BI Desktop prennent maintenant en charge les formats de nombres qui contiennent des virgules (,) et des points (.).R scripting in Power BI Desktop now supports number formats that contain decimals (.) and commas (,).

Préparer un script RPrepare an R script

Pour exécuter un script R dans Power BI Desktop, créez-le dans votre environnement de développement R local, puis assurez-vous qu’il fonctionne correctement.To run an R script in Power BI Desktop, create the script in your local R development environment, and make sure it runs successfully.

Pour exécuter le script dans Power BI Desktop, assurez-vous qu’il s’exécute correctement dans un espace de travail nouveau et non modifié.To run the script in Power BI Desktop, make sure the script runs successfully in a new and unmodified workspace. Cela signifie que l’ensemble des packages et dépendances doivent être explicitement chargés et exécutés.This means that all packages and dependencies must be explicitly loaded and run. Vous pouvez utiliser source() pour exécuter des scripts dépendants.You can use source() to run dependent scripts.

Lors de la préparation et l’exécution d’un script R dans Power BI Desktop, vous pouvez être confronté à quelques limitations :When preparing and running an R script in Power BI Desktop, there are a few limitations:

  • Seules les trames de données sont importées ; assurez-vous donc que les données que vous souhaitez importer dans Power BI sont représentées dans une trame de donnéesOnly data frames are imported, so make sure the data you want to import to Power BI is represented in a data frame
  • Les colonnes qui sont de type Complexe et Vecteur ne sont pas importées et sont remplacées par des valeurs d’erreur dans la table créée.Columns that are typed as Complex and Vector are not imported, and are replaced with error values in the created table.
  • Les valeurs marquées comme non applicables (N/A) sont converties en valeurs NULL dans Power BI DesktopValues that are N/A are translated to NULL values in Power BI Desktop
  • Tous les scripts exécutés pendant plus de 30 minutes expirentAny R script that runs longer than 30 minutes times out
  • Les appels interactifs dans le script R, comme l’attente pour l’entrée d’un utilisateur, arrêtent l’exécution du scriptInteractive calls in the R script, such as waiting for user input, halts the script’s execution
  • Lorsque vous définissez le répertoire de travail dans le script R, vous devez définir un chemin d’accès complet vers le répertoire de travail, au lieu d’un chemin d’accès relatifWhen setting the working directory within the R script, you must define a full path to the working directory, rather than a relative path

Exécuter votre script R et importer des donnéesRun your R script and import data

  1. Dans Power BI Desktop, le connecteur de données du script R se trouve dans Obtenir des données.In Power BI Desktop, the R Script data connector is found in Get Data. Pour exécuter votre script R, sélectionnez Obtenir des données > Plus..., puis sélectionnez Autres > Script R, comme illustré dans l’image suivante.To run your R Script, select Get Data > More..., then select Other > R Script as shown in the following image.

  2. Si R est installé sur votre ordinateur local, la dernière version installée est sélectionnée comme votre moteur R.If R is installed on your local machine, the latest installed version is selected as your R engine. Copiez simplement votre script dans la fenêtre de script, puis cliquez sur OK.Simply copy your script into the script window and select OK.

  3. Si R n’est pas installé, n’est pas identifié ou s’il existe plusieurs installations sur votre ordinateur local, développez Paramètres d’installation de R pour afficher les options d’installation ou pour sélectionner l’installation pour laquelle vous souhaitez exécuter le script 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.

    Si R est installé mais n’est pas identifié, vous pouvez indiquer explicitement son emplacement dans la zone de texte fournie lorsque vous développez Paramètres d’installation de 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. Dans l’illustration ci-dessus, le chemin d’accès C:\Program Files\R\R-3.2.0 est explicitement fourni dans la zone de texte.In the above image, the path C:\Program Files\R\R-3.2.0 is explicitly provided in the text box.

    Les paramètres d’installation de R sont centralisés dans la section des scripts R de la boîte de dialogue Options.R installation settings are centrally located in the R Scripting section of the Options dialog. Pour spécifier vos paramètres d’installation de R, sélectionnez Fichier > Options et paramètres, puis Options > Scripts R.To specify your R installation settings, select File > Options and settings and then Options > R Scripting. Si plusieurs installations de R sont disponibles, un menu déroulant s’affiche pour sélectionner l’installation à utiliser.If multiple installations of R are available, a drop-down menu appears that allows you to select which installation to use.

  4. Sélectionnez OK pour exécuter le script R.Select OK to run the R Script. Lorsque le script s’exécute correctement, vous pouvez choisir les trames de données obtenues pour les ajouter au modèle Power BI.When the script runs successfully, you can then choose the resulting data frames to add to the Power BI model.

ActualisationRefresh

Vous pouvez actualiser un script R dans Power BI Desktop.You can refresh an R script in Power BI Desktop. Lorsque vous actualisez un script R, Power BI Desktop réexécute le script R dans l’environnement de Power BI Desktop.When you refresh an R script, Power BI Desktop runs the R script again in the Power BI Desktop environment.

Étapes suivantesNext steps

Consultez les informations supplémentaires suivantes sur R dans Power BI.Take a look at the following additional information about R in Power BI.