Erstellen von R-Visualisierungen im Power BI-DienstCreating R visuals in the Power BI service

Der Power BI-Dienst unterstützt das Anzeigen von und das Interagieren mit Visualisierungen, die mit R-Skripts erstellt werden.The Power BI service supports viewing and interacting with visuals created with R scripts. Visualisierungen, die mit R-Skripts erstellt werden, sogenannteR-Visualisierungen, können erweiterte Datenstrukturierung und -analysen wie z.B. Vorhersagen darstellen, indem sie sich die starke Leistung von R hinsichtlich Analysen und Visualisierung zu Nutze machen.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.

Hinweis

Die Programmiersprache R gehört zu den von Statistikern, Datenanalysten und Business Analysten am häufigsten verwendeten Programmiersprachen.The R programming language is among the most widely used programming languages by statisticians, data scientists, and business analysts. Die Sprache R verfügt über eine Open-Source-Community, die über 7.000 Add-On-Pakete sowie häufig verwendete R-Benutzergruppen zur Verfügung stellt.The R language has an open source community that offers over 7,000 add-on packages, as well as widely used R User Groups. Die im Power BI-Dienst bereitgestellte Version von R ist Revolution R Open 3.2.2.The version of R deployed in the Power BI service is Revolution R Open 3.2.2.

Die folgende Abbildung zeigt ein Power BI-Dashboard mit einer Sammlung von R-Visuals, die für erweiterte Analysen verwendet werden.The following image shows a Power BI dashboard with a collection of R visuals used for advanced analytics.

R-Visualisierungen werden in einem Power BI Desktop-Bericht wie dem in der folgenden Abbildung dargestellten Bericht erstellt.R visuals are created in a Power BI Desktop report, like the report shown in the following image.

Sobald der Bericht in Power BI Desktop erstellt wurde, können Sie den Bericht, der mindestens eine R-Visualisierung enthält, im Power BI-Dienst veröffentlichen.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. R-Visualisierungen können derzeit nur in Power BI Desktop erstellt und anschließend im Power BI-Dienst veröffentlicht werden.R visuals currently can only be created in Power BI Desktop, and then published to the Power BI service. Weitere Informationen zum Erstellen von R-Visualisierungen finden Sie unter Erstellen von Power BI-Visualisierungen mithilfe von R (Power BI Desktop).For more information on creating R visuals, see Create Power BI visuals using R (Power BI Desktop).

Beachten Sie, dass im Dienst nicht alle R-Pakete unterstützt werden.Note that in the service not all of the R packages are supported. Eine Liste der derzeit im Power BI-Dienst unterstützten Pakete finden Sie am Ende dieses Artikels unter „Unterstützte Pakete“.See supported packages at the end of this article for the list of packages currently supported in the Power BI service.

Sie können diese Beispieldatei für Power BI Desktop (PBIX-Datei), die einige R-Visualisierungen enthält, herunterladen, um zu sehen, wie dies funktioniert und um zu experimentieren.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.

R-Visualisierungen, die in Power BI Desktop erstellt und anschließend im Power BI-Dienst veröffentlicht wurden, verhalten sich größtenteils wie jede andere Visualisierung im Power BI-Dienst. Sie können mit ihnen interagieren, sie filtern, schneiden, an ein Dashboard anheften oder sie für andere freigeben.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. Weitere Informationen zum Freigeben von Dashboards und Visualisierungen finden Sie unter Freigeben eines Dashboards für Kollegen und andere.For more information about sharing dashboards and visuals, see share a dashboard with colleagues and others. Ein Unterschied zu anderen Visualisierungen ist, dass R-Visualisierungen keine QuickInfos anzeigen und nicht dazu verwendet werden können, andere Visualisierungen zu filtern.One difference from other visuals is that R visuals cannot show tool tips and cannot be used to filter other visuals.

Wie in folgender Abbildung zu sehen, werden R-Visualisierungen im Power BI-Dienst, entweder in Dashboards oder Berichten, größtenteils wie jede andere Virtualisierung angezeigt und verhalten sich auch größtenteils wie jedes andere Visualisierung. Benutzer müssen das zugrunde liegende R-Skript, das die Visualisierung erstellt hat, nicht kennen.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.

Sicherheit der R-SkriptsR scripts security

R-Visualisierungen werden aus R-Skripts erstellt, die möglicherweise Code mit Sicherheits- oder Datenschutzrisiken enthalten können.R visuals are created from R scripts, which could potentially contain code with security or privacy risks.

Diese Risiken existieren hauptsächlich in der Erstellungsphase, wenn Skriptautoren das Skript auf ihrem eigenen Computer ausführen.These risks mainly exist in the authoring phase when the script author run the script on their own computer.

Der Power BI-Dienst wendet eine Sandkasten-Technologie an, um die Benutzer und den Dienst vor Sicherheitsrisiken zu schützen.The Power BI service applies a sandbox technology to protect users and the service from security risks.

Dieser Sandkasten-Ansatz erlegt den im Power BI-Dienst ausgeführten R-Skripts einige Einschränkungen auf wie z.B. die Einschränkung des Zugriffs auf das Internet oder auf andere Ressourcen, die zum Erstellen der R-Visualisierung nicht benötigt werden.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.

Fehlererfahrung bei R-SkriptsR scripts error experience

Wenn ein R-Skript auf einen Fehler stößt, wird die R-Visualisierung nicht gezeichnet, und eine Fehlermeldung wird angezeigt.When an R script encounters an error, the R visual is not plotted and an error message is displayed. Wählen Sie im Zeichenbereich in der Fehlermeldung der R-Visualisierung wie in folgender Abbildung dargestellt Details anzeigen aus, um weitere Informationen zu dem Fehler zu erhalten.For details on the error, select See details from the R visual error on the canvas, as shown in the following image.

Die folgende Abbildung zeigt als weiteres Beispiel die Fehlermeldung, die angezeigt wird, wenn ein R-Skript aufgrund eines fehlenden R-Pakets in Azure nicht ordnungsgemäß ausgeführt wurde.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.

LizenzierungLicensing

R-Visualisierungen benötigen eine Power BI Pro-Lizenz, um in Berichten zu rendern, um zu aktualisieren, zu filtern und über Kreuz zu filtern.R visuals require a Power BI Pro license to render in reports, refresh, filter and cross-filter. Weitere Informationen zu Power BI Pro-Lizenzen und wie sie sich von kostenlosen Lizenzen unterscheiden, finden Sie unter Power BI Pro-Inhalt – was ist das?For more information about Power BI Pro licenses, and how they differ from free licenses, see Power BI Pro content - what is it?

Kostenlose Benutzer von Power BI können nur für sie freigegebene Kacheln verwenden.Free users of Power BI can only consume tiles shared with them. Weitere Informationen finden Sie unter Erwerb von Power BI Pro.See purchasing Power BI Pro for more information.

Die folgende Tabelle beschreibt die auf der Lizenzierung basierenden Funktionen der R-Visualisierungen.The following table describes R visuals capabilities based on licensing.

Bekannte EinschränkungenKnown Limitations

R-Visualisierungen weisen im Power BI-Dienst einige Einschränkungen auf:R visuals in the Power BI service have a few limitations:

  • Die Unterstützung für R-Visualisierungen ist beschränkt auf die Pakete, die auf der folgenden Seite identifiziert wurden: .R visuals support is limited to the packages identified on the following page . Benutzerdefinierte Pakete werden derzeit nicht unterstützt.There currently is no support for custom packages.
  • Beschränkungen der Datengröße – die vom visuellen R-Element zum Zeichnen verwendeten Daten sind auf 150.000 Zeilen beschränkt.Data size limitations – data used by the R visual for plotting is limited to 150,000 rows. Bei Auswahl von mehr als 150.000 Zeilen werden nur die oberen 150.000 Zeilen verwendet, und im Bild wird eine Meldung angezeigt.If more than 150,000 rows are selected, only the top 150,000 rows are used and a message is displayed on the image.
  • Beschränkung der Berechnungszeit – wenn die Berechnung der R-Visualisierung 60 Sekunden überschreitet, wird das Skript aufgrund der Zeitüberschreitung abgebrochen und eine Fehlermeldung angezeigt.Calculation time limitation – if an R visual calculation exceeds 60 seconds the script times out, resulting in an error.
  • Visuelle R-Elemente werden aktualisiert, wenn Daten aktualisiert, gefiltert oder hervorgehoben werden.R visuals are refreshed upon data updates, filtering, and highlighting. Allerdings ist das eigentliche Bild nicht interaktiv und unterstützt QuickInfos nicht.However, the image itself is not interactive and does not support tool tips.
  • Visuelle R-Elemente reagieren auf das Hervorheben anderer Visualisierungen. Sie können jedoch nicht auf visuelle R-Elemente klicken, um eine Kreuzfilterung anderer Elemente auszuführen.R visuals respond to highlighting other visuals, but you cannot click on elements in the R visual in order to cross filter other elements.
  • R-Visualisierungen werden für den Uhrzeit-Datentyp derzeit nicht unterstützt.R visuals are currently not supported for the Time data type. Bitte verwenden Sie stattdessen Datum/Uhrzeit.Please use Date/Time instead.
  • R-Visualisierungen werden nicht angezeigt, wenn Im Web veröffentlichen verwendet wird.R Visuals do not display when using Publish to web.
  • R-Visualisierungen drucken derzeit nicht, wenn Dashboards und Berichte druckenR visuals currently do not print with dashboard and reports printing
  • R-Visualisierungen werden im DirectQuery-Modus von Analysis Services derzeit nicht unterstütztR visuals are currently not supported in the DirectQuery mode of Analysis Services
  • Für chinesische, japanische und koreanische Schriftarten sind alle der folgenden zusätzlichen Schritte erforderlich, damit sie im Power BI-Dienst ordnungsgemäß funktionieren:Chinese, Japanese and Korean fonts require all of the additional following steps to work properly in the Power BI service:

    • Installieren Sie zunächst das R-Paket showtext und alle Abhängigkeiten.First, install the R package showtext and all of its dependencies. Hierzu können Sie das folgende Skript ausführen:You can do this by running the following script:

      *install.packages("showtext")*
      
    • Fügen Sie als Nächstes die folgende Zeile am Anfang des R-Skripts ein:Next, add the following line at the beginning of the R script:

      powerbi_rEnableShowTextForCJKLanguages =  1
      

Übersicht über R-PaketeOverview of R packages

R-Pakete sind Sammlungen von R-Funktionen, Daten und kompiliertem Code, die in einem genau definierten Format kombiniert werden.R packages are collections of R functions, data, and compiled code that are combined in a well-defined format. Bei der Installation umfasst R einen Standardsatz von Paketen, weitere Pakete können heruntergeladen und installiert werden.When R is installed, it comes with a standard set of packages, and other packages are available for download and installation. Nach Abschluss der Installation muss ein R-Paket in die Sitzung geladen werden, um es verwenden zu können.Once installed, an R packages must be loaded into the session to be used. Die Hauptressource für kostenlose R-Pakete ist CRAN, das Comprehensive R Archive Network.The primary source of free R packages is CRAN, the Comprehensive R Archive Network.

In Power BI Desktop können alle R-Pakettypen ohne Einschränkung verwendet werden.Power BI Desktop can use any type of R packages without limitation. Sie können R-Pakete für die Verwendung in Power BI Desktop selbst installieren (z.B. mit RStudio IDE).You can install R packages for use in Power BI Desktop on your own (using the RStudio IDE, for example).

R-Visualisierungen im Power BI-Dienst werden von den Paketen im Abschnitt Unterstützte Pakete dieses Artikels unterstützt.R visuals in the Power BI service are supported by the packages found in the Supported Packages section found in this article. Wenn Sie ein für Sie interessantes Paket nicht in der Liste unterstützter Pakete finden, können Sie die Unterstützung für das Paket anfordern.If you don't find a package you're interested in among the supported packages list, you can request the support of the package. Informationen zum Anfordern von Support finden Sie unter R-Pakete im Power BI-Dienst.See R packages in the Power BI service for information on how to request support.

Voraussetzungen und Einschränkungen für R-PaketeRequirements and Limitations of R packages

Es gibt eine Reihe von Voraussetzungen und Einschränkungen für R-Pakete:There are a handful of requirements and limitations for R packages:

  • Der Power BI-Dienst unterstützt die meisten R-Pakete mit kostenlosen und Open Source-Softwarelizenzen, z.B. GPL-2, GPL-3, MIT+ usw.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.
  • Der Power BI-Dienst unterstützt in CRAN veröffentlichte Pakete.The Power BI service supports packages published in CRAN. Der Dienst unterstützt keine privaten oder benutzerdefinierten R-Pakete.The service does not support private or custom R packages. Wir bitten unsere Benutzer, ihre privaten Pakete auf CRAN verfügbar zu machen, bevor sie die Veröffentlichung im Power BI-Dienst anfordern.We encourage users to make their private packages available on CRAN prior to requesting the package be available in the Power BI service.
  • Für Power BI Desktop gibt es zwei Varianten von R-Paketen:For Power BI Desktop has two variations for R packages:

    • Für R-Visualisierungen können Sie jedes Paket installieren, auch benutzerdefinierte R-Pakete.For R visuals, you can install any package, including custom R packages
    • Bei benutzerdefinierten R-Visualisierungen werden nur öffentliche CRAN-Pakete für die automatische Installation der Pakete unterstützt.For Custom R visuals, only public CRAN packages are supported for auto-installation of the packages
  • Aus Sicherheits- und Datenschutzgründen werden derzeit keine R-Pakete unterstützt, die Client-Server-Abfragen über das World Wide Web im Dienst bereitstellen (z.B. RgoogleMaps).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. Netzwerke werden bei solchen Versuchen blockiert.Networking is blocked for such attempts. Eine Liste der unterstützten und nicht unterstützten R-Pakete finden Sie unter R-Pakete im Power BI-Dienst.See R packages in the Power BI service for a list of supported and unsupported R packages.
  • Das Genehmigungsverfahren zum Einschließen eines neuen R-Pakets umfasst eine Reihe von Abhängigkeiten. Einige Abhängigkeiten, die im Dienst installiert werden müssen, können nicht unterstützt werden.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.

Unterstützte Pakete:Supported Packages:

Eine umfangreiche Liste der unterstützten R-Pakete (und die kurze Liste der nicht unterstützten Pakete) finden Sie im folgenden Artikel:For a long list of supported R packages (and the short list of unsupported packages) please see the following article: