Créer des éléments visuels Power BI avec RCreate Power BI visuals using R

Power BI Desktop vous permet d’utiliser R pour visualiser vos données.With Power BI Desktop, you can use R to visualize your data.

Installer RInstall R

Power BI Desktop n’inclut pas le moteur R. Vous ne pouvez pas non plus le déployer ou l’installer à l’aide de Power BI Desktop.Power BI Desktop does not include, deploy or install the R engine. Pour exécuter des scripts R dans Power BI Desktop, vous devez installer R séparément sur votre ordinateur local.To run R scripts in Power BI Desktop, you must separately install R on your local computer. 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.

Activer les visuels REnable R visuals

Pour activer les visuels R, sélectionnez Fichier > Options et paramètres > Options, puis, dans la page Options qui s’affiche, assurez-vous que votre installation R locale est spécifiée dans la section Script R de la fenêtre Options, comme illustré dans l’image suivante.To enable R visuals, select File > Options and settings > Options and in the Options page that appears, make sure your local R installation is specified in the R Scripting section of the Options window, as shown in the following image. Dans l’image suivante, le chemin de l’installation locale de R est le suivant : C:\Program Files\R\R-3.2.0 . Celui-ci est explicitement fourni dans la zone de texte.In the following image, the path local installation of R is C:\Program Files\R\R-3.2.0 and that path is explicitly provided in the text box. Vérifiez que le chemin indiqué reflète correctement l’installation locale de R que Power BI Desktop doit utiliser.Make sure the path it displays properly reflects the local R installation you want Power BI Desktop to use.

Après avoir spécifié votre installation R, vous pouvez commencer à créer des éléments visuels R.Once you specify your R installation, you’re ready to begin creating R visuals.

Créer des visuels R dans Power BI DesktopCreate R visuals in Power BI Desktop

  1. Sélectionnez l’icône Élément visuel R s’affiche dans le volet Visualization, comme indiqué dans l’image suivante.Select the R Visual icon in the Visualization pane, as shown in the following image, to add an R visual.

  2. Quand vous ajoutez un visuel R à un rapport, Power BI Desktop effectue les opérations suivantes :When you add an R visual to a report, Power BI Desktop does the following:

    • Une image de visuel R apparaît sous forme d’espace réservé sur le canevas de rapport.A placeholder R visual image appears on the report canvas.

    • L’Éditeur de script R s’affiche dans la partie inférieure du volet central.The R script editor appears along the bottom of the center pane.

  3. Ensuite, ajoutez les champs que vous souhaitez utiliser dans votre script R à la section Valeurs de la zone Champs, comme vous le feriez pour tout autre visuel Power BI Desktop.Next, add fields you want to consume in your R script to the Values section in the Fields well, just as you would with any other Power BI Desktop visual. Seuls les champs ajoutés à la zone Champs sont disponibles dans le script R. Vous pouvez ajouter de nouveaux champs ou supprimer les champs inutiles de la zone Champs pendant que vous travaillez sur votre script R dans l’Éditeur de script R de Power BI Desktop.Only fields that have been added to the Fields well are available to your R script, and you can add new fields, or remove unneeded fields from the Fields well while working on your R script in the Power BI Desktop R script editor. Power BI Desktop détecte automatiquement les champs que vous avez ajoutés ou supprimés.Power BI Desktop automatically detects which fields you have added or removed.

    Note

    Le type d’agrégation par défaut pour les éléments visuels R est Ne pas résumer.The default aggregation type for R visuals is do not summarize.

  4. Vous pouvez à présent utiliser les données sélectionnées pour créer un tracé.Now you can use the data you selected to create a plot. Quand vous sélectionnez des champs, l’ Éditeur de script R génère un code de liaison au script R de prise en charge en fonction des sélections effectuées dans la section grise située dans la partie supérieure du volet de l’éditeur.As you select fields, the R script editor generates supporting R script binding code based on your selections in the gray section along the top of the editor pane. Quand vous sélectionnez ou supprimez des champs supplémentaires, le code de prise en charge dans l’Éditeur de script R est automatiquement généré ou supprimé selon le cas.As you select or remove additional fields, supporting code in the R script editor is automatically generated or removed accordingly.

    Dans l’exemple présenté dans l’image suivante, trois champs ont été sélectionnés : hp, gear et drat.In the example shown in the following image, three fields were selected: hp, gear, and drat. Suite à ces sélections, l’éditeur de script R a généré le code de liaison suivant :As a result of those selections, the R script editor generated the following binding code:

    • Une trame de données appelée dataset a été crééeA dataframe called dataset was created
      • Cette trame de données se compose des différents champs sélectionnés par l’utilisateurThat dataframe is comprised of the different fields selected by the user
    • L’agrégation par défaut est ne pas résumerThe default aggregation is do not summarize
    • Comme pour les éléments visuels de table, les champs sont regroupés et les lignes en double n’apparaissent qu’une foisSimilar to table visuals, fields are grouped and duplicate rows only appear once

    Conseil

    Dans certains cas, il peut être dans votre intérêt de ne pas avoir recours au regroupement automatique ou bien d’afficher toutes les lignes, notamment les doublons.In certain cases you may not want automatic grouping to occur, or you may want all rows to appear, including duplicates. Dans ce cas, vous pouvez ajouter un champ d’index à votre jeu de données. De cette façon, toutes les lignes sont considérées comme étant uniques, ce qui empêche le regroupement.In that case you can add an index field to your dataset which causes all rows to be considered unique, and prevents grouping.

    Le tableau de données généré est appelé dataset, et les colonnes sélectionnées sont accessibles par leurs noms respectifs.The generated dataframe is called dataset, and selected columns can be accessed by their respective names. Par exemple, vous pouvez accéder au champ gear en écrivant dataset$gear dans votre script R.For example, the gear field can be accessed by writing dataset$gear in your R script. Pour les champs avec des espaces ou des caractères spéciaux, utilisez des guillemets simples.For fields with spaces or special characters, use single quotes.

  5. Une fois le tableau de données généré automatiquement par les champs que vous avez sélectionnés, vous pouvez écrire le script R de traçage sur le périphérique R par défaut.With the dataframe automatically generated by the fields you selected, you’re ready to write R script that results in plotting to the R default device. Une fois le script terminé, sélectionnez Exécuter dans la barre de titre Éditeur de script R (Exécuter se trouve à droite de la barre de titre).When the script is complete, select Run from the R script editor title bar (Run is on the right side of the title bar).

    Quand vous sélectionnez Exécuter, Power BI Desktop identifie le tracé et le présente sur le canevas.When Run is selected, Power BI Desktop identifies the plot and present it on the canvas. Le processus étant exécuté sur l’installation locale de R, vérifiez que les packages nécessaires sont installés.Since the process is executed on your local R installation, make sure required packages are installed.

    Power BI Desktop retrace le visuel lorsque l’un des événements suivants se produit :Power BI Desktop replots the visual when any of the following events occur:

    • Exécuter est sélectionné dans la barre de titre Éditeur de script RRun is selected from the R script editor title bar
    • À chaque changement de données dû à l’actualisation des données, au filtrage ou à la mise en surbrillanceWhenever a data change occurs, due to data refresh, filtering, or highlighting

L’image suivante montre un exemple du code de tracé de corrélation et trace les corrélations entre les attributs de différents types de voitures.The following image shows an example of the correlation plot code, and plots the correlations between attributes of different types of cars.

Pour obtenir une vue agrandie des visualisations, vous pouvez réduire l’ Éditeur de script R.To get a larger view of the visualizations, you can minimize the R script editor. Bien entendu, comme pour d’autres visuels dans Power BI Desktop, vous pouvez appliquer un filtre croisé au tracé de corrélation en sélectionnant uniquement les voitures de sport dans le visuel en anneau (visuel rond à droite, dans l’exemple ci-dessus).And of course, like other visuals in Power BI Desktop, you can cross filter the correlation plot by selecting only sport cars in the donut visual (the round visual on the right, in the above example image).

Vous pouvez également modifier le script R pour personnaliser l’élément visuel et mettre à profit toute la puissance de R en ajoutant des paramètres à la commande de traçage.You can also modify the R script to customize the visual, and take advantage of the power of R by adding parameters to the plotting command.

La commande de traçage d’origine était la suivante :The original plotting command was the following:

corrplot(M, method = "color",  tl.cex=0.6, tl.srt = 45, tl.col = "black")

Après quelques modifications apportées au script R, la commande se présente désormais comme suit :With a few changes in the R script, the command is now the following:

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

L’élément visuel R trace donc à présent des cercles, en considérant uniquement la moitié supérieure, et réorganise la matrice pour mettre en cluster les attributs corrélés, comme le montre l’image suivante.As a result, the R visual now plots circles, only considers at the upper half, and reorders the matrix to cluster correlated attributes, as shown in the following image.

Quand vous exécutez un script R qui génère une erreur, l’élément visuel R n’est pas tracé et un message d’erreur s’affiche sur le canevas.When executing a R script that results in an error, the R visual is not plotted and an error message is displayed on the canvas. Pour obtenir plus d’informations sur l’erreur, sélectionnez Voir les détails dans l’erreur se rapportant à l’élément visuel R sur le canevas.For details on the error, select See details from the R visual error on the canvas.

Sécurité des scripts R : les éléments visuels R sont créés à partir de scripts R, qui peuvent contenir du code qui présente des risques pour la sécurité ou la confidentialité.R scripts security: R visuals are created from R scripts, which could contain code with security or privacy risks. Quand un utilisateur tente d’afficher un élément visuel R ou d’interagir avec ce dernier pour la première fois, un message d’avertissement de sécurité lui est présenté.When attempting to view or interact with an R visual the first time, a user is presented with a security warning message. Activez les éléments visuels R seulement si vous faites confiance à l’auteur et à la source ou après avoir examiné et compris le script R.Only enable R visuals if you trust the author and source, or after you review and understand the R script.

Limites connuesKnown limitations

Les visuels R dans Power BI Desktop présentent quelques limitations :R visuals in Power BI Desktop has a few limitations:

  • Limites concernant la taille des données : les données utilisées par les éléments visuels R pour le traçage sont limitées à 150 000 lignes.Data size limitations – data used by the R visual for plotting is limited to 150,000 rows. Si plus de 150 000 lignes sont sélectionnées, seules les 150 000 premières lignes sont utilisées et un message s’affiche sur l’image.If more than 150,000 rows are selected, only the top 150,000 rows are used and a message is displayed on the image.
  • Limite concernant la durée du calcul : si le calcul d’un élément visuel R prend plus de 5 minutes, le délai d’exécution est dépassé et une erreur est générée.Calculation time limitation – if an R visual calculation exceeds 5 minutes the execution times out, resulting in an error.
  • Relations : comme avec d’autres éléments visuels Power BI Desktop, si des champs de données issus de différentes tables avec aucune relation définie entre elles sont sélectionnés, une erreur se produit.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.
  • Les éléments visuels R sont actualisés lors de la mise à jour, du filtrage et de la mise en surbrillance des données.R visuals are refreshed upon data updates, filtering, and highlighting. Toutefois, l’image elle-même n’est pas interactive et ne peut pas être la source du filtrage croisé.However, the image itself is not interactive and cannot be the source of cross-filtering.
  • Les éléments visuels R répondent à la mise en surbrillance d’autres éléments visuels, mais vous ne pouvez pas cliquer sur des éléments dans l’élément visuel R pour appliquer un filtre croisé à d’autres éléments.R visuals respond to highlighting other visuals, but you cannot click on elements in the R visual in order to cross filter other elements.
  • Seuls les tracés représentés sur le périphérique d’affichage R par défaut R s’affichent correctement sur le canevas.Only plots that are plotted to the R default display device are displayed correctly on the canvas. Évitez d’utiliser explicitement un autre périphérique d’affichage R.Avoid explicitly using a different R display device.
  • Dans cette version, les installations RRO ne sont pas automatiquement identifiées par la version 32 bits de Power BI Desktop. Par conséquent, vous devez définir manuellement le chemin d’accès au répertoire d’installation R dans Options et paramètres > Options > scripts R.In this release, RRO installations are not automatically identified by the 32-bit version of Power BI Desktop, so you must manually provide the path to the R installation directory in Options and settings > Options > R Scripting.

É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.