Création d’éléments visuels R dans le service Power BICreating R visuals in the Power BI service

Le service Power BI prend en charge l’affichage et l’utilisation des éléments visuels créés avec des scripts R.The Power BI service supports viewing and interacting with visuals created with R scripts. Les éléments visuels créés avec des scripts R, communément appelés éléments visuels R, peuvent présenter une analyse et une mise en forme avancées des données (des prévisions par exemple) à l’aide des puissantes et riches fonctionnalités d’analyse et de visualisation de R.Visuals created with R scripts, commonly called R visuals, can present advanced data shaping and analytics such as forecasting, using the rich analytics and visualization power of R.

Note

Le langage de programmation R est l’un des langages de programmation les plus largement utilisés par les statisticiens, les scientifiques et les analystes d’entreprise.The R programming language is among the most widely used programming languages by statisticians, data scientists, and business analysts. Le langage R a une communauté open source qui offre plus de 7 000 packages de composants additionnels, ainsi que des groupes d’utilisateurs R utilisés à grande échelle.The R language has an open source community that offers over 7,000 add-on packages, as well as widely used R User Groups. La version de R déployée dans le service Power BI est Revolution R Open 3.2.2.The version of R deployed in the Power BI service is Revolution R Open 3.2.2.

L’illustration suivante montre un tableau de bord Power BI avec une collection d’éléments visuels R utilisés pour l’analyse avancée.The following image shows a Power BI dashboard with a collection of R visuals used for advanced analytics.

Les éléments visuels R sont créés dans un rapport Power BI Desktop, comme le rapport affiché dans l’image suivante.R visuals are created in a Power BI Desktop report, like the report shown in the following image.

Une fois que le rapport est créé dans Power BI Desktop, vous pouvez le publier avec un ou plusieurs visuels R dans le service Power BI.Once the report is created in Power BI Desktop, you can publish the report containing one or more R visuals to the Power BI service. Pour l’instant, les visuels doivent être créés à l’aide de Power BI Desktop avant d’être publiés dans le service Power BI.R visuals currently can only be created in Power BI Desktop, and then published to the Power BI service. Pour plus d’informations sur la création d’éléments visuels R, consultez Créer des éléments visuels Power BI avec R (Power BI Desktop).For more information on creating R visuals, see Create Power BI visuals using R (Power BI Desktop).

Notez que dans le service, tous les packages R ne sont pas pris en charge.Note that in the service not all of the R packages are supported. Pour obtenir la liste des packages actuellement pris en charge dans le service Power BI, consultez les packages pris en charge à la fin de cet article.See supported packages at the end of this article for the list of packages currently supported in the Power BI service.

Vous pouvez télécharger cet exemple de fichier Power BI Desktop (.pbix) qui contient quelques éléments visuels R pour voir comment cela fonctionne et faire des essais.You can download this sample Power BI Desktop file (.pbix file) that contains a few R visuals to see how this works, and to experiment.

Les visuels R créés dans Power BI Desktop puis publiés dans le service Power BI se comportent la plupart du temps comme n’importe quel autre visuel dans le service Power BI. Vous pouvez les utiliser, les filtrer, les découper et les épingler à un tableau de bord ou les partager avec d’autres utilisateurs.R visuals that are created in Power BI Desktop, and then published to the Power BI service, for the most part behave like any other visual in the Power BI service; you can interact, filter, slice, and pin them to a dashboard, or share them with others. Pour plus d’informations sur le partage de tableaux de bord et d’éléments visuels, consultez Partager un tableau de bord avec vos collègues et les autres utilisateurs.For more information about sharing dashboards and visuals, see share a dashboard with colleagues and others. Contrairement aux autres éléments visuels, les éléments visuels R ne peuvent pas afficher d’info-bulles ni être utilisés pour filtrer d’autres éléments visuels.One difference from other visuals is that R visuals cannot show tool tips and cannot be used to filter other visuals.

Comme vous pouvez le voir dans l’image suivante, que ce soit dans des tableaux de bord ou des rapports, les éléments visuels R du service Power BI, s’affichent et se comportent en grande partie comme les autres types d’élément visuel. En outre, les utilisateurs n’ont pas besoin de connaître le script R sous-jacent qui a créé l’élément visuel.As you can see in the following image, R visuals in the Power BI service, either in dashboards or reports, largely appear and behave like any other visual, and users don't need to be aware of the underlying R script that created the visual.

Sécurité des scripts RR scripts security

Les éléments visuels R sont créés à partir de scripts R, qui peuvent contenir du code qui présente des risques éventuels pour la sécurité ou la confidentialité.R visuals are created from R scripts, which could potentially contain code with security or privacy risks.

Ces risques existent principalement lors de l’étape de création quand l’auteur exécute son script sur son propre ordinateur.These risks mainly exist in the authoring phase when the script author run the script on their own computer.

Le service Power BI applique une technologie de type sandbox pour protéger les utilisateurs et le service contre les risques de sécurité.The Power BI service applies a sandbox technology to protect users and the service from security risks.

Cette technologie sandbox impose certaines restrictions sur les scripts R exécutés dans le service Power BI, comme l’accès à Internet ou à d’autres ressources qui ne sont pas nécessaires à la création d’un élément visuel R.This sandbox approach imposes some restrictions on the R scripts running in the Power BI service, such as accessing the Internet, or accessing to other resources that are not required to create the R visual.

Erreurs dans les scripts RR scripts error experience

Quand un script R génère une erreur, l’élément visuel R n’est pas tracé et un message d’erreur s’affiche.When an R script encounters an error, the R visual is not plotted and an error message is displayed. 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, comme indiqué dans l’image suivante.For details on the error, select See details from the R visual error on the canvas, as shown in the following image.

Voici un autre exemple : l’illustration suivante montre le message d’erreur qui s’affiche lorsqu’un script R n’a pas pu s’exécuter correctement en raison d’un package R manquant dans Azure.As another example, the following image shows the error message that appears when an R script failed to run properly due to a missing R package in Azure.

Gestion des licencesLicensing

Les éléments visuels R nécessitent une licence Power BI Pro pour afficher des rapports, les actualisations, les filtres et les filtres croisés.R visuals require a Power BI Pro license to render in reports, refresh, filter and cross-filter. Pour plus d’informations sur les licences Power BI Pro et pour savoir en quoi elles diffèrent des licences gratuites, consultez Contenu Power BI Pro - De quoi s’agit-il ?For more information about Power BI Pro licenses, and how they differ from free licenses, see Power BI Pro content - what is it?

Les utilisateurs gratuits de Power BI peuvent uniquement utiliser les vignettes partagées avec eux.Free users of Power BI can only consume tiles shared with them. Pour plus d’informations, consultez Achat de Power BI Pro.See purchasing Power BI Pro for more information.

Le tableau suivant décrit les fonctionnalités des éléments visuels R en fonction de la licence.The following table describes R visuals capabilities based on licensing.

Limites connuesKnown Limitations

Les éléments visuels R du service Power BI ont quelques limitations :R visuals in the Power BI service have a few limitations:

  • La prise en charge des éléments visuels R est limitée aux packages identifiés sur la page suivante .R visuals support is limited to the packages identified on the following page . Il n’existe actuellement aucune prise en charge des packages personnalisés.There currently is no support for custom packages.
  • 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 60 secondes, 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 60 seconds the script times out, resulting in an error.
  • 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 prend pas en charge les info-bulles.However, the image itself is not interactive and does not support tool tips.
  • 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.
  • Les éléments visuels R ne sont pas actuellement pris en charge pour le type de données Time.R visuals are currently not supported for the Time data type. Utilisez plutôt Date/heure.Please use Date/Time instead.
  • Les éléments visuels R ne s’affichent pas lorsque vous utilisez Publier sur le web.R Visuals do not display when using Publish to web.
  • Les éléments visuels R ne s’impriment pas pour le moment lors de l’impression de tableaux de bord et rapports.R visuals currently do not print with dashboard and reports printing
  • Les éléments visuels R ne sont actuellement pas pris en charge dans le mode DirectQuery d’Analysis Services.R visuals are currently not supported in the DirectQuery mode of Analysis Services
  • Pour que les polices chinoise, japonaise et coréenne fonctionnent correctement dans le service Power BI, vous devez suivre toutes les étapes supplémentaires suivantes :Chinese, Japanese and Korean fonts require all of the additional following steps to work properly in the Power BI service:

    • Tout d’abord, installez le package R showtext et toutes ses dépendances.First, install the R package showtext and all of its dependencies. Vous pouvez le faire en exécutant le script suivant :You can do this by running the following script:

      *install.packages("showtext")*
      
    • Ensuite, ajoutez la ligne suivante au début du script R :Next, add the following line at the beginning of the R script:

      powerbi_rEnableShowTextForCJKLanguages =  1
      

Vue d’ensemble des packages ROverview of R packages

Les packages R sont des ensembles de fonctions, de données et de code compilé R qui sont combinés dans un format bien défini.R packages are collections of R functions, data, and compiled code that are combined in a well-defined format. Quand R est installé, il est fourni avec un ensemble standard de packages et d’autres packages sont disponibles pour le téléchargement et l’installation.When R is installed, it comes with a standard set of packages, and other packages are available for download and installation. Une fois installé, un package R doit être chargé dans la session à utiliser.Once installed, an R packages must be loaded into the session to be used. La principale source de packages R gratuits est CRAN (Comprehensive R Archive Network).The primary source of free R packages is CRAN, the Comprehensive R Archive Network.

Power BI Desktop peut utiliser n’importe quel type de package R sans limitation.Power BI Desktop can use any type of R packages without limitation. Vous pouvez installer manuellement des packages R pour une utilisation dans Power BI Desktop (à l’aide de l’IDE RStudio par exemple).You can install R packages for use in Power BI Desktop on your own (using the RStudio IDE, for example).

Les visuels R dans le service Power BI sont pris en charge par les packages qui se trouvent dans la section Packages pris en charge dans cet article.R visuals in the Power BI service are supported by the packages found in the Supported Packages section found in this article. Si vous ne trouvez pas le package qui vous intéresse dans la liste des packages pris en charge, vous pouvez demander la prise en charge du package.If you don't find a package you're interested in among the supported packages list, you can request the support of the package. Pour en savoir plus sur la demande de prise en charge, consultez la page Packages R dans le service Power BI.See R packages in the Power BI service for information on how to request support.

Spécifications et limitations des packages RRequirements and Limitations of R packages

Il existe quelques spécifications et limitations concernant les packages R :There are a handful of requirements and limitations for R packages:

  • Le service Power BI, pour l’essentiel, prend en charge les packages R avec des licences logicielles gratuites et open source comme GPL-2, 3-GPL, MIT+, etc.The Power BI service, for the most part, supports R packages with free and open-source software licenses such as GPL-2, GPL-3, MIT+, and so on.
  • Le service Power BI prend en charge les packages publiés dans CRAN.The Power BI service supports packages published in CRAN. Le service ne prend pas en charge les packages R privés ou personnalisés.The service does not support private or custom R packages. Nous invitons les utilisateurs à mettre à disposition leurs packages privés sur le site CRAN avant de demander à ce que le package soit disponible dans le service Power BI.We encourage users to make their private packages available on CRAN prior to requesting the package be available in the Power BI service.
  • Power BI Desktop a deux variantes des packages R :For Power BI Desktop has two variations for R packages:

    • Pour les visuels R, vous pouvez installer n’importe quel package, y compris les packages R personnalisés.For R visuals, you can install any package, including custom R packages
    • Pour les visuels R personnalisés, seuls les packages CRAN publics sont pris en charge pour l’installation automatique.For Custom R visuals, only public CRAN packages are supported for auto-installation of the packages
  • Pour des raisons de confidentialité et de sécurité, nous ne prenons actuellement pas en charge les packages R qui fournissent des requêtes client-serveur sur le web (par exemple RgoogleMaps) dans le service.For security and privacy reasons, we currently don't support R packages that provide client-server queries over the World-Wide Web (such as RgoogleMaps) in the service. La mise en réseau est bloquée lors de ces tentatives.Networking is blocked for such attempts. Pour obtenir une liste des packages R pris en charge et non pris en charge, consultez la page Packages R du service Power BI.See R packages in the Power BI service for a list of supported and unsupported R packages.
  • Le processus d’approbation visant à inclure un nouveau package R implique un certain nombre de dépendances. Certaines dépendances qui doivent être installées dans le service ne sont pas prises en charge.The approval process for including a new R package has a tree of dependencies; some dependencies required to be installed in the service cannot be supported.

Packages pris en charge :Supported Packages:

Pour obtenir une longue liste de packages R pris en charge (et une brève liste de packages non pris en charge), consultez l’article suivant :For a long list of supported R packages (and the short list of unsupported packages) please see the following article: