Erstellen von Power BI-Visualisierungen mithilfe von RCreate Power BI visuals using R

Mit Power BI Desktop können Sie R zum Visualisieren Ihrer Daten verwenden.With Power BI Desktop, you can use R to visualize your data. R ist eine Sprache und Umgebung für statistische Berechnungen und Grafiken.R is a language and environment for statistical computing and graphics.

Installieren von RInstall R

Standardmäßig ist die R-Engine in Power BI Desktop nicht enthalten, und sie wird von Power BI Desktop nicht bereitgestellt oder installiert.By default, Power BI Desktop doesn't include, deploy, or install the R engine. Damit Sie R-Skripts in Power BI Desktop ausführen können, müssen Sie R eigens auf dem lokalen Computer installieren.To run R scripts in Power BI Desktop, you must separately install R on your local computer. R können Sie an vielen Stellen im Internet kostenlos herunterladen und installieren, u. a. von der Revolution R Open-Downloadseite und aus dem CRAN-Repository.You can download and install R for free from many locations, including the Revolution Open download page, and the CRAN Repository. Die aktuelle Version der R-Skripterstellung in Power BI Desktop unterstützt Unicode-Zeichen ebenso wie Leerzeichen (leere Zeichen) im Installationspfad.The current release of R scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Aktivieren von R-Visuals in Power BI DesktopEnable R visuals in Power BI Desktop

Nachdem Sie R installiert haben, wird es von Power BI Desktop automatisch aktiviert.After you've installed R, Power BI Desktop enables it automatically. Führen Sie die folgenden Schritte aus, um zu überprüfen, ob Power BI Desktop R am richtigen Speicherort aktiviert hat:To verify that Power BI Desktop has enabled R in the correct location, follow these steps:

  1. Klicken Sie im Menü von Power BI Desktop auf Datei > Optionen und Einstellungen > Optionen.From the Power BI Desktop menu, select File > Options and settings > Options.

  2. Wählen Sie links auf der Seite Optionen unter Global die Option R-Skripterstellung aus.On the left side of the Options page, under Global, select R scripting.

  3. Vergewissern Sie sich, dass unter Optionen für R-Skripts Ihre lokale R-Installation in Erkannte R-Basisverzeichnisse angegeben ist und der lokalen R-Installation entspricht, die Power BI Desktop verwenden soll.Under R script options, verify that your local R installation is specified in Detected R home directories and that it properly reflects the local R installation you want Power BI Desktop to use. In der folgenden Abbildung lautet der Pfad der lokalen R-Installation C:\Program Files\R Open\R-3.5.3\ .In the following image, the path to the local installation of R is C:\Program Files\R Open\R-3.5.3\.

    Seite „Optionen für R-Skripts“

Nachdem Sie Ihre Installation von R überprüft haben, können Sie mit dem Erstellen von R-Visuals beginnen.After you've verified your R installation, you’re ready to begin creating R visuals.

Erstellen von R-Visuals in Power BI DesktopCreate R visuals in Power BI Desktop

  1. Wählen Sie zum Hinzufügen eines visuellen R-Elements das Symbol visuelle R-Elemente im Bereich Visualisierung.Select the R Visual icon in the Visualization pane to add an R visual.

    Symbol für R-Visual im Bereich „Visualisierung“

  2. Klicken Sie im daraufhin angezeigten Fenster Visuelle Skriptelemente aktivieren auf Aktivieren.In the Enable script visuals window that appears, select Enable.

    Visuelle Skriptelemente aktivieren

    Wenn Sie einem Bericht ein visuelles R-Element hinzufügen, nimmt Power BI Desktop folgende Änderungen vor:When you add an R visual to a report, Power BI Desktop makes the following changes:

    • Im Berichtszeichenbereich wird ein Platzhalterbild für ein R-Visual angezeigt.A placeholder R visual image appears on the report canvas.

    • Am unteren Rand des mittleren Bereichs wird der R-Skript-Editor angezeigt.The R script editor appears along the bottom of the center pane.

    R-Skript-Editor

  3. Ziehen Sie wie bei jedem anderen Power BI Desktop-Visual im Abschnitt Werte des Bereichs Visualisierung Felder aus dem Bereich Felder, die Sie in Ihrem R-Skript verwenden möchten.In the Values section of the Visualization pane, drag fields from the Fields pane that you want to consume in your R script, just as you would with any other Power BI Desktop visual. Alternativ können Sie auch die Felder direkt im Bereich Felder auswählen.Alternatively, you can also select the fields directly in the Fields pane.

    Für Ihr R-Skript sind nur Felder verfügbar, die dem Bereich Werte hinzugefügt wurden.Only fields that you've added to the Values section are available to your R script. Sie können im Bereich Werte neue Felder hinzufügen und nicht benötigte Felder entfernen, während Sie das R-Skript im R-Skript-Editor bearbeiten.You can add new fields or remove unneeded fields from the Values section while working on your R script in the R script editor. Power BI Desktop erkennt automatisch, welche Felder hinzugefügt oder entfernt wurden.Power BI Desktop automatically detects which fields you've added or removed.

    Hinweis

    Der Standardaggregationstyp für R-Visuals lautet Nicht zusammenfassen.The default aggregation type for R visuals is do not summarize.

  4. Jetzt können Sie die Daten verwenden, die Sie zum Erstellen einer Zeichnung ausgewählt haben:Now you can use the data you selected to create a plot:

    • Während Sie Felder auswählen, generiert der R-Skript-Editor unterstützenden, gebundenen R-Skript-Code für diese Felder im grauen Abschnitt im oberen Bereich des Editors.As you select fields, the R script editor generates supporting R script binding code for those fields in the gray section along the top of the editor pane.
    • Wenn Sie ein Feld entfernen, entfernt der R-Skript-Editor den unterstützenden Code für dieses Feld automatisch.If you remove a field, the R script editor automatically removes the supporting code for that field.

    Im Beispiel in der folgenden Abbildung sind drei Felder ausgewählt: „hp“, „gear“ und „drat“.In the example shown in the following image, three fields are selected: hp, gear, and drat. Aufgrund dieser Auswahl generiert der R-Skript-Editor Bindungscode, der wie folgt zusammengefasst wird:As a result of those selections, the R script editor generates binding code, which is summarized as follows:

    • Erstellen Sie einen Datenrahmen mit dem Namen dataset, der aus den vom Benutzer ausgewählten verschiedenen Feldern besteht.Create a dataframe called dataset, which is comprised of the different fields selected by the user.
    • Die Standardaggregation lautet Nicht zusammenfassen.The default aggregation is: do not summarize.
    • Ähnlich wie bei Tabellenvisualisierungen werden Felder gruppiert und doppelte Zeilen nur einmal angezeigt.Similar to table visuals, fields are grouped and duplicate rows appear only once.

    Code im R-Skript-Editor

    Tipp

    In bestimmten Fällen sind Gruppierungen möglicherweise nicht erwünscht, oder es sollen alle Zeilen, einschließlich doppelter Zeilen, angezeigt werden.In certain cases, you may not want automatic grouping to occur, or you may want all rows to appear, including duplicates. In diesem Fall fügen Sie dem Dataset ein Indexfeld hinzu, sodass alle Zeilen als eindeutig betrachtet werden und keine Gruppierung erfolgt.In that case, add an index field to your dataset, which causes all rows to be considered unique and prevents grouping.

    Der generierte Datensatz erhält den Namen dataset, und Sie können auf die ausgewählten Spalten über ihre Namen zugreifen.The generated dataframe is named dataset, and you access selected columns by their respective names. Greifen Sie beispielsweise auf das Feld „gear“ zu, indem Sie dataset$gear in Ihrem R-Skript hinzufügen.For example, access the gear field by adding dataset$gear to your R script. Verwenden Sie für Felder mit Leerzeichen oder Sonderzeichen einfache Anführungszeichen.For fields with spaces or special characters, use single quotes.

  5. Mit dem Datenrahmen, der automatisch anhand der von Ihnen ausgewählten Felder generiert wurde, können Sie ein R-Skript schreiben, das von Power BI Desktop auf dem R-Standardgerät ausgegeben wird.With the dataframe automatically generated by the fields you selected, you’re ready to write an R script, which Power BI Desktop plots to the R default device. Nachdem Sie das Skript fertig gestellt haben, wählen Sie Skript ausführen auf der rechten Seite der R-Skript-Editor-Titelleiste aus.After you've completed the script, select Run script on the right side of the R script editor title bar.

    Bei Auswahl von Skript ausführen identifiziert Power BI Desktop die Zeichnung und stellt sie im Zeichenbereich dar.When you select Run script, Power BI Desktop identifies the plot and presents it on the canvas. Da der Vorgang in der lokalen R-Installation ausgeführt wird, stellen Sie sicher, dass die erforderlichen R-Pakete installiert sind.Because the process is executed on your local R installation, make sure the required R packages are installed.

    Power BI Desktop zeichnet die Visualisierung neu, wenn eines der folgenden Ereignisse eintritt:Power BI Desktop replots the visual when any of the following events occur:

    • Wählen Sie auf der Titelleiste des R-Skript-Editors Ausführen aus.You select Run script from the R script editor title bar.

    • Durch Aktualisieren, Filtern oder Hervorheben von Daten wird eine Datenänderung ausgeführt.A data change occurs because of data refreshing, filtering, or highlighting.

      Die folgende Abbildung zeigt ein Beispiel für den Korrelationszeichnungscode, in dem die Korrelationen zwischen Attributen verschiedener Autotypen gezeichnet werden.The following image shows an example of the correlation plot code, which plots the correlations between attributes of different types of cars.

      Codebeispiel für Korrelationsdiagramm

  6. Um eine größere Ansicht der Visualisierungen zu erhalten, minimieren Sie den R-Skript-Editor.To get a larger view of the visualizations, minimize the R script editor. Sie können das Korrelationsdiagramm wie andere Visuals in Power BI Desktop kreuzfiltern, indem Sie im Ringdiagrammvisual (das runde Visual auf der rechten Seite) einen bestimmten Abschnitt (z. B. Sportwagen) auswählen.Like other visuals in Power BI Desktop, you can cross filter the correlation plot by selecting a specific section (such as sports cars) in the donut-shaped visual (the round visual on the right).

    Größere Visualisierungsansicht

  7. Ändern Sie das R-Skript, um das Visual anzupassen, und nutzen Sie die Funktionsvielfalt von R, indem Sie dem Zeichenbefehl Parameter hinzufügen.Modify the R script to customize the visual, and take advantage of the power of R by adding parameters to the plotting command.

    Der ursprüngliche Zeichenbefehl lautet wie folgt:The original plotting command is:

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

    Ändern Sie das R-Skript so, dass der Zeichenbefehl wie folgt aussieht:Change the R script so that the plotting command is as follows:

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

    Deshalb zeichnet jetzt das visuelle R-Element Kreise, berücksichtigt nur die obere Hälfte und ordnet die Matrix neu an, um korrelierte Attribute zu gruppieren.As a result, the R visual now plots circles, only considers the upper half, and reorders the matrix to cluster correlated attributes.

    Kreisdiagramm im R-Visual

    Wenn Sie ein R-Skript ausführen, das zu einem Fehler führt, wird anstelle des R-Visual-Diagramms eine Fehlermeldung im Zeichenbereich angezeigt.When you execute an R script that results in an error, an error message displays on the canvas instead of the R visual plot. Um Informationen zu dem Fehler zu erhalten, wählen Sie in der Fehlermeldung des R-Visuals Details anzeigen aus.For details on the error, select See details from the R visual error.

    Fehler im R-Visual

Sicherheit der R-SkriptsR scripts security

R-Visuals werden aus R-Skripts erstellt, die Code mit Sicherheits- oder Datenschutzrisiken enthalten können.R visuals are created from R scripts, which might contain code with security or privacy risks. Wenn ein Benutzer ein R-Visual zum ersten Mal aufruft oder damit interagiert, wird eine Sicherheitswarnmeldung angezeigt.When attempting to view or interact with an R visual for the first time, a user is presented with a security warning message. Aktivieren Sie visuelle R-Elemente nur dann, wenn Sie dem Autor und der Quelle vertrauen, oder wenn Sie die zugehörigen Skripts überprüft und nachvollzogen haben.Only enable R visuals if you trust the author and source, or after you review and understand the R script.

Bekannte EinschränkungenKnown limitations

Für R-Visuals in Power BI Desktop gelten die folgenden Einschränkungen:R visuals in Power BI Desktop have the following limitations:

  • Datengrößen: Die vom R-Visual zum Zeichnen verwendeten Daten sind auf 150.000 Zeilen beschränkt.Data sizes: Data used by an 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.

  • Ausgabegröße: Die Ausgabegröße des R-Visuals ist auf 2 MB beschränkt.Output size : R visual has an output size limit of 2MB.

  • Auflösung: Alle visuellen R-Elemente werden mit 72 DPI angezeigt.Resolution: All R visuals are displayed at 72 DPI.

  • Zeichnen auf Geräten: Es wird nur das Zeichnen auf Standardgeräten unterstützt.Plotting device: Only plotting to the default device is supported.

  • Berechnungszeiten: Wenn die Berechnung eines R-Visuals fünf Minuten überschreitet, verursacht dies einen Timeoutfehler.Calculation times: If an R visual calculation exceeds five minutes, it causes a time-out error.

  • Beziehungen: Wie bei anderen Power BI Desktop-Visuals tritt ein Fehler auf, wenn Datenfelder aus unterschiedlichen Tabellen ausgewählt werden, zwischen denen keine Beziehung definiert ist.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.

  • Aktualisierungen: Visuelle R-Elemente werden aktualisiert, wenn Daten aktualisiert, gefiltert oder hervorgehoben werden.Refreshes: R visuals are refreshed upon data updates, filtering, and highlighting. Das Bild selbst ist jedoch nicht interaktiv und kann nicht als Quelle für die Kreuzfilterung verwendet werden.However, the image itself isn't interactive and can't be the source of cross-filtering.

  • Hervorhebungen: R-Visuals reagieren auf das Hervorheben anderer Visuals. Sie können jedoch keine Elemente im R-Visual auswählen, um eine Kreuzfilterung für andere Elemente durchzuführen.Highlights: R visuals respond if you highlight other visuals, but you can't select elements in the R visual to cross filter other elements.

  • Anzeigegeräte: Nur auf dem R-Standardanzeigegerät erzeugte Zeichnungen werden im Zeichenbereich ordnungsgemäß angezeigt.Display devices: Only plots that are plotted to the R default display device are displayed correctly on the canvas. Verwenden Sie nicht explizit ein anderes R-Anzeigegerät.Avoid explicitly using a different R display device.

  • Umbenennen von Spalten: R-Visuals unterstützen das Umbenennen von Eingabespalten nicht.Column renaming: R visuals do not support renaming input columns. Spalten werden nach Ihrem ursprünglichen Namen bei der Skriptausführung bezeichnet.Columns will be referred to by their original name during script execution.

  • RRO-Installationen: In diesem Release werden RRO-Installationen von der 32-Bit-Version von Power BI Desktop nicht automatisch erkannt. Daher müssen Sie den Pfad zum R-Installationsverzeichnis unter Optionen und Einstellungen > Optionen > R-Skripterstellung manuell angeben.RRO installations: In this release, the 32-bit version of Power BI Desktop doesn't automatically identify RRO installations; you must manually provide the path to the R installation directory in Options and settings > Options > R Scripting.

Nächste SchritteNext steps

Weitere Informationen zu R in Power BI finden Sie in den folgenden Artikeln:For more information about R in Power BI, see the following articles: