Ausführen von R-Skripts in Power BI DesktopRun R scripts in Power BI Desktop

Sie können R-Skripts direkt in Power BI Desktop ausführen und die resultierenden Datasets in ein Power BI Desktop-Datenmodell importieren.You can run R scripts directly in Power BI Desktop, and import the resulting datasets into a Power BI Desktop data model.

Installieren von RInstall R

Damit Sie R-Skripts in Power BI Desktop ausführen können, müssen Sie R auf dem lokalen Computer installieren.To run R scripts in Power BI Desktop, you need to install R on your local machine. 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.

Ausführen von R-SkriptsRun R scripts

Mit nur wenigen Schritten in Power BI Desktop können Sie R-Skripts ausführen und ein Datenmodell erstellen, auf Basis dessen Sie Berichte erstellen und im Power BI-Dienst freigeben können.With just a few steps in Power BI Desktop you can run R scripts and create a data model, from which you can create reports, and share them on the Power BI service. Die R-Skripterstellung in Power BI Desktop unterstützt jetzt Zahlenformate, die Dezimaltrennzeichen (.) und Kommas (,) verwenden.R scripting in Power BI Desktop now supports number formats that contain decimals (.) and commas (,).

Vorbereiten eines R-SkriptsPrepare an R script

Wenn Sie ein R-Skript in Power BI Desktop ausführen möchten, erstellen Sie das Skript in Ihrer lokalen R-Entwicklungsumgebung, und vergewissern Sie sich, dass es erfolgreich ausgeführt wird.To run an R script in Power BI Desktop, create the script in your local R development environment, and make sure it runs successfully.

Zum Ausführen des Skripts in Power BI Desktop stellen Sie sicher, dass das Skript in einem neuen und unveränderten Arbeitsbereich erfolgreich ausgeführt wird.To run the script in Power BI Desktop, make sure the script runs successfully in a new and unmodified workspace. Dies bedeutet, dass alle Pakete und Abhängigkeiten explizit geladen und ausgeführt werden müssen.This means that all packages and dependencies must be explicitly loaded and run. Zum Ausführen von abhängigen Skripts können Sie source() verwenden.You can use source() to run dependent scripts.

Beim Vorbereiten und Ausführen eines R-Skripts in Power BI Desktop müssen Sie einige Einschränkungen beachten:When preparing and running an R script in Power BI Desktop, there are a few limitations:

  • Es werden nur Datenrahmen importiert. Stellen Sie darum sicher, dass die nach Power BI zu importierenden Daten in einem Datenrahmen dargestellt werden.Only data frames are imported, so make sure the data you want to import to Power BI is represented in a data frame
  • Spalten mit dem Typ „Komplex“ oder „Vektor“ werden nicht importiert. Sie werden in der erstellten Tabelle durch Fehlerwerte ersetzt.Columns that are typed as Complex and Vector are not imported, and are replaced with error values in the created table.
  • In Power BI Desktop werden nicht vorhandene Werte als NULL-Werte dargestellt.Values that are N/A are translated to NULL values in Power BI Desktop
  • Wenn die Ausführung eines R-Skripts länger als 30 Minuten dauert, wird sie mit einem Timeout abgebrochen.Any R script that runs longer than 30 minutes times out
  • Bei interaktiven Aufrufen in einem R-Skript, z. B. beim Warten auf eine Benutzereingabe, wird die Ausführung des Skripts angehalten.Interactive calls in the R script, such as waiting for user input, halts the script’s execution
  • Wenn Sie das Arbeitsverzeichnis im R-Skript angeben, müssen Sie den vollständigen Pfad zu diesem Verzeichnis angeben – der relative Pfad genügt nicht.When setting the working directory within the R script, you must define a full path to the working directory, rather than a relative path

Ausführen des R-Skripts und Importieren der DatenRun your R script and import data

  1. In Power BI Desktop befindet sich der R-Skript-Datenconnector unter Daten abrufen.In Power BI Desktop, the R Script data connector is found in Get Data. Zum Ausführen Ihres R-Skripts wählen Sie Daten abrufen > Mehr... und anschließend Sonstige > R-Skript aus, wie in der folgenden Abbildung dargestellt.To run your R Script, select Get Data > More..., then select Other > R Script as shown in the following image.

  2. Wenn R auf dem lokalen Computer installiert ist, wird die neueste installierte Version als R-Modul ausgewählt.If R is installed on your local machine, the latest installed version is selected as your R engine. Kopieren Sie Ihr Skript einfach in das Skriptfenster, und wählen Sie OKaus.Simply copy your script into the script window and select OK.

  3. Wenn R nicht installiert ist, nicht erkannt wird oder mehrere Installationen auf dem lokalen Computer vorhanden sind, erweitern Sie R-Installationseinstellungen , um Installationsoptionen anzuzeigen oder die Installation auszuwählen, mit der Sie das R-Skript ausführen möchten.If R is not installed, is not identified, or if there are multiple installations on your local machine, expand R Installation Settings to display installation options, or to select which installation you want to run the R script.

    Wenn R installiert ist, jedoch nicht erkannt wird, können Sie dessen Speicherort explizit in dem Textfeld angeben, das angezeigt wird, wenn Sie R-Installationseinstellungenerweitern.If R is installed is not identified, you can explicitly provide its location in the text box provided when you expand R Installation Settings. In der Abbildung oben wird der Pfad C:\Programme\R\R-3.2.0 explizit im Textfeld angegeben.In the above image, the path C:\Program Files\R\R-3.2.0 is explicitly provided in the text box.

    Die R-Installationseinstellungen befinden sich zentral im Abschnitt „R-Skripterstellung“ des Dialogfelds „Optionen“.R installation settings are centrally located in the R Scripting section of the Options dialog. Um Ihre R-Installationseinstellungen festzulegen, wählen Sie Datei > Optionen und Einstellungen und dann Optionen > R-Skripterstellung aus.To specify your R installation settings, select File > Options and settings and then Options > R Scripting. Wenn mehrere Installationen von R verfügbar sind, wird ein Dropdownmenü angezeigt, das Ihnen die Auswahl der gewünschten Installation ermöglicht.If multiple installations of R are available, a drop-down menu appears that allows you to select which installation to use.

  4. Wählen Sie OK aus, um das R-Skript auszuführen.Select OK to run the R Script. Wenn das Skript erfolgreich ausgeführt wird, können Sie die resultierenden Datenrahmen auswählen, die Sie dem Power BI-Modell hinzufügen möchten.When the script runs successfully, you can then choose the resulting data frames to add to the Power BI model.

AktualisierenRefresh

Sie können ein R-Skript in Power BI Desktop aktualisieren.You can refresh an R script in Power BI Desktop. Wenn Sie ein R-Skript aktualisieren, führt Power BI Desktop das R-Skript in der Power BI Desktop-Umgebung erneut aus.When you refresh an R script, Power BI Desktop runs the R script again in the Power BI Desktop environment.

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.