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

Mit Power BI Desktop können Sie R jetzt zum Visualisieren Ihrer Daten verwenden.With Power BI Desktop, you can use R to visualize your data.

Installieren von RInstall R

Das R-Modul ist in Power BI Desktop nicht enthalten und wird von Power BI Desktop nicht bereitgestellt oder installiert.Power BI Desktop does not include, deploy or install the R engine. Damit Sie R-Skripts in Power BI Desktop ausführen können, müssen Sie R gesondert 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-VisualsEnable R visuals

Zum Aktivieren von R-Visualisierungen wählen Sie Datei > Optionen und Einstellungen > Optionen aus. Stellen Sie anschließend sicher, dass auf der Seite Optionen im Abschnitt R-Skripterstellung des Fensters Optionen die lokale Installation von R angegeben ist, wie in der folgenden Abbildung dargestellt.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. In der folgenden Abbildung lautet der lokale Installationspfad von R C:\Program Files\R\R-3.2.0. Dieser Pfad ist im Textfeld explizit angegeben.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. Stellen Sie sicher, dass der angezeigte Pfad die lokale Installation von R, die von Power BI Desktop verwendet werden soll, richtig wiedergibt.Make sure the path it displays properly reflects the local R installation you want Power BI Desktop to use.

Nachdem Sie Ihre Installation von R angegeben haben, können Sie mit dem Erstellen von R-Visualisierungen beginnen.Once you specify 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, wie im folgenden Bild dargestellt.Select the R Visual icon in the Visualization pane, as shown in the following image, to add an R visual.

  2. Wenn Sie einem Bericht ein visuelles R-Element hinzufügen, führt Power BI Desktop Folgendes aus:When you add an R visual to a report, Power BI Desktop does the following:

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

  3. Fügen Sie anschließend wie in jeder anderen Power BI Desktop-Visualisierung dem Abschnitt Werte im Bereich Felder Felder hinzu, die im R-Skript verwendet werden sollen.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. Für das R-Skript sind nur Felder verfügbar, die dem Bereich Felder hinzugefügt wurden. Sie können im Bereich Felder neue Felder hinzufügen und nicht benötigte Felder entfernen, während Sie das R-Skript im R-Skript-Editor von Power BI Desktop bearbeiten.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 erkennt automatisch, welche Felder hinzugefügt oder entfernt wurden.Power BI Desktop automatically detects which fields you have 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 basierend auf Ihrer Auswahl im grauen Abschnitt im oberen Bereich des Editors.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. Wenn Sie zusätzliche Felder auswählen oder entfernen, wird im R-Skript-Editor automatisch Unterstützungscode entsprechend generiert bzw. entfernt.As you select or remove additional fields, supporting code in the R script editor is automatically generated or removed accordingly.

    Im Beispiel in der folgenden Abbildung wurden drei Felder ausgewählt: „hp“, „gear“ und „drat“.In the example shown in the following image, three fields were selected: hp, gear, and drat. Aufgrund dieser Auswahl generiert der R-Skript-Editor den folgenden Bindungscode:As a result of those selections, the R script editor generated the following binding code:

    • Ein Datenrahmen mit dem Namen dataset wurde erstellt.A dataframe called dataset was created
      • Dieser Datenrahmen besteht aus den vom Benutzer ausgewählten Feldern.That dataframe 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 werden nur einmal angezeigt.Similar to table visuals, fields are grouped and duplicate rows only appear once

    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 können Sie dem Dataset ein Indexfeld hinzufügen, sodass alle Zeilen als eindeutig betrachtet werden und keine Gruppierung erfolgt.In that case you can add an index field to your dataset which causes all rows to be considered unique, and prevents grouping.

    Der generierte Datensatz wird als Datasetbezeichnet, und auf die ausgewählten Spalten kann über ihre Namen zugegriffen werden.The generated dataframe is called dataset, and selected columns can be accessed by their respective names. Beispiel: Der Zugriff auf das Feld „gear“ erfolgt durch die Eingabe von dataset$gear im R-Skript.For example, the gear field can be accessed by writing dataset$gear in 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 Datensatz, der automatisch anhand der von Ihnen ausgewählten Felder generiert wurde, können Sie R-Skript zum Erzeugen von Zeichnungen auf dem R-Standardgerät schreiben.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. Wenn das Skript abgeschlossen ist, wählen Sie Ausführen auf der Titelleiste des R-Skript-Editors aus (Ausführen befindet sich auf der rechten Seite der Titelleiste).When the script is complete, select Run from the R script editor title bar (Run is on the right side of the title bar).

    Bei Auswahl von Ausführen identifiziert Power BI Desktop die Zeichnung und stellt sie im Zeichenbereich dar.When Run is selected, Power BI Desktop identifies the plot and present it on the canvas. Da der Vorgang in der lokalen R-Installation ausgeführt wird, stellen Sie sicher, dass die erforderlichen Pakete installiert sind.Since the process is executed on your local R installation, make sure required 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:

    • Auf der Titelleiste des R-Skript-Editors wird Ausführen ausgewähltRun is selected from the R script editor title bar
    • Bei jedem Ändern der Daten durch Aktualisieren, Filtern oder Hervorheben von Daten.Whenever a data change occurs, due to data refresh, filtering, or highlighting

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

Um eine größere Ansicht der Visualisierungen zu erhalten, können Sie den R-Skript-Editorminimieren.To get a larger view of the visualizations, you can minimize the R script editor. Und selbstverständlich können Sie die Korrelationszeichnung wie andere Visualisierungen in Power BI Desktop kreuzfiltern, indem Sie in der Ringdiagrammvisualisierung (im obigen Beispielbild die runde Visualisierung auf der rechten Seite) nur Sportwagen auswählen.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).

Sie können auch das R-Skript ändern, um die Visualisierung anzupassen, und die Funktionsvielfalt von R nutzen, indem Sie dem Zeichenbefehl Parameter hinzufügen.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.

Der ursprüngliche Zeichenbefehl lautete wie folgt:The original plotting command was the following:

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

Mit einigen Änderungen im R-Skript lautet der Befehl jetzt folgendermaßen: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")

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, wie in der folgenden Abbildung gezeigt.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.

Wenn ein R-Skript ausgeführt wird, das einen Fehler verursacht, wird das visuelle R-Element nicht gezeichnet, und im Zeichenbereich wird eine Fehlermeldung angezeigt.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. Um Informationen zu dem Fehler zu erhalten, wählen Sie in der Fehlermeldung des visuellen R-Elements Details anzeigen aus.For details on the error, select See details from the R visual error on the canvas.

R-Skript-Sicherheit: R-Visualisierungen werden aus R-Skripts erstellt, die Code mit Sicherheits- oder Datenschutzrisiken enthalten können.R scripts security: R visuals are created from R scripts, which could contain code with security or privacy risks. Wenn ein Benutzer eine R-Visualisierung zum ersten Mal aufruft oder damit interagiert, wird eine Sicherheitswarnmeldung angezeigt.When attempting to view or interact with an R visual 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 visuelle R-Elemente in Power BI Desktop ergeben sich einige Einschränkungen:R visuals in Power BI Desktop has a few limitations:

  • 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 des visuellen R-Elements 5 Minuten überschreitet, wird die Ausführung aufgrund der Zeitüberschreitung abgebrochen und eine Fehlermeldung angezeigt.Calculation time limitation – if an R visual calculation exceeds 5 minutes the execution times out, resulting in an error.
  • Beziehungen – wie bei anderen Power BI Desktop-Visualisierungen 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.
  • Visuelle R-Elemente werden aktualisiert, wenn Daten aktualisiert, gefiltert oder hervorgehoben werden.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 is not interactive and cannot be the source of cross-filtering.
  • 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.
  • Nur auf dem R-Standardanzeigegerät erzeugte Zeichnungen werden im Zeichenbereich ordnungsgemäß angezeigt.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.
  • 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.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.

Nächste SchritteNext steps

Betrachten Sie die folgenden zusätzlichen Informationen über R in Power BI.Take a look at the following additional information about R in Power BI.