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. Sie können R über zahlreiche Webseiten im Internet kostenlos herunterladen und installieren, u. a. aus dem Microsoft R Application Network und aus dem CRAN-Repository.You can download and install R for free from many locations, including the Microsoft R Application Network and the CRAN Repository. Das aktuelle Release unterstützt Unicode-Zeichen und Leerzeichen im Installationspfad.The current release supports Unicode characters and spaces (empty characters) in the installation path.

Ausführen von R-SkriptsRun R scripts

Sie können R-Skripts in nur wenigen Schritten in Power BI Desktop ausführen und ein Datenmodell erstellen.Using just a few steps in Power BI Desktop, you can run R scripts and create a data model. Mit dem Datenmodell können Sie Berichte erstellen und diese im Power BI-Dienst freigeben.With the data model, 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. Diese Voraussetzung bedeutet, dass alle Pakete und Abhängigkeiten explizit geladen und ausgeführt werden müssen.This prerequisite 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 einige Einschränkungen beachtet werden:When you prepare and run an R script in Power BI Desktop, there are a few limitations:

  • Es werden nur Datenrahmen importiert. Stellen Sie deshalb sicher, dass die nach Power BI zu importierenden Daten in einem Datenrahmen dargestellt werden.Because only data frames are imported, remember to represent the data you want to import to Power BI in a data frame.
  • Spalten mit dem Typ „Komplex“ oder „Vektor“ werden nicht importiert und in der erstellten Tabelle durch Fehlerwerte ersetzt.Columns typed as Complex and Vector aren't imported, and they're replaced with error values in the created table.
  • In Power BI Desktop werden N/A-Werte in NULL-Werte übersetzt.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 ein Timeout ausgelöst.If an R script runs longer than 30 minutes, it 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

Jetzt können Sie Ihr R-Skript zum Importieren von Daten in Power BI Desktop ausführen:Now you can run your R script to import data into Power BI Desktop:

  1. Wählen Sie in Power BI Desktop Daten abrufen und dann Andere > R-Skript aus, und klicken Sie dann auf Verbinden:In Power BI Desktop, select Get Data, choose Other > R script, and then select Connect:

    Verbindung mit R-Skript, Kategorie „Andere“, Dialogfeld „Daten abrufen“, Power BI Desktop

  2. Wenn R auf Ihrem lokalen Computer installiert ist, kopieren Sie Ihr Skript einfach in das Skriptfenster, und klicken Sie auf OK.If R is installed on your local machine, just copy your script into the script window and select OK. Die neueste installierte Version wird als Ihre R-Engine angezeigt.The latest installed version is displayed as your R engine.

    Dialogfeld „R-Skript“, Power BI Desktop

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

Sie können steuern, welche R-Installation zur Skriptausführung verwendet wird.You can control which R installation to use to run your script. Wählen Sie zum Festlegen Ihrer R-Installationseinstellungen Datei > Optionen und Einstellungen > Optionen aus, und klicken Sie dann auf R-Skripterstellung.To specify your R installation settings, choose File > Options and settings > Options, then select R scripting. Unter Optionen für R-Skripts zeigt die Dropdownliste Erkannte R-Basisverzeichnisse Ihre aktuelle R-Installationsauswahl an.Under R script options, the Detected R home directories dropdown list shows your current R installation choices. Wenn die gewünschte R-Installation nicht angezeigt wird, wählen Sie Andere aus, und wechseln Sie dann in R-Basisverzeichnis festlegen zu Ihrem bevorzugten R-Installationsorder.If the R installation you want isn't listed, pick Other, and then browse to or enter your preferred R installation folder in Set an R home directory.

Optionen für R-Skripts, Dialogfeld „Optionen“, Power BI Desktop

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.