Um Daten in Microsoft Power BI® zu exportieren und zu importieren und die verschiedenen Objekte, aus denen Ihre Power BI-Bereitstellung besteht, als Teil einer Kette zu verwalten, fügen Sie einen Schritt hinzu, der einen Microsoft Power BI-Verbindungsbefehl enthält.
Um diese Befehle zu aktivieren, erstellt ein IT-Administrator zunächst einen Power BI Connector.
Hinweis: Der Connector kann keine Verbindung zu Power BI herstellen, wenn die Multi-Faktor-Authentifizierung (MFA) aktiviert ist.
Zeilen zum Datensatz hinzufügen
Um neue Datenzeilen zu einer Tabelle im Dataset eines Arbeitsbereichs hinzuzufügen, verwenden Sie den Befehl Add rows to dataset .
Hinweis: Dieser Befehl betrachtet doppelte Zeilen als hinzugefügt, auch wenn sie in Power BI ignoriert werden.
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Name der Tabelle |
Geben Sie den Namen der Tabelle ein, zu der Sie Zeilen hinzufügen möchten. |
Daten |
Geben Sie die Datei an, die die Daten enthält, die der Tabelle hinzugefügt werden sollen. |
Datentyp |
Wählen Sie aus, ob Data JSON oder CSV ist. |
Trennzeichen |
Wenn Datentyp CSV ist, geben Sie das in der Datei verwendete Begrenzungszeichen ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Zeilen hinzugefügt |
Ganzzahl |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensatz an Gateway binden
Um einen Datensatz aus einem Arbeitsbereich an ein Gateway zu binden, verwenden Sie den Befehl Bind dataset to gateway . Wird nur vom On-Premises Data Gateway unterstützt.
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Gateway |
Geben Sie die ID des Gateways ein. |
Ausgaben
Keine
Exit Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Klon-Bericht
Um einen Bericht aus einem Arbeitsbereich zu klonen, verwenden Sie den Befehl Bericht klonen .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Bericht-ID |
Geben Sie die ID des Berichts ein. |
Name |
Geben Sie den Namen des neu erstellten Berichts ein. |
Ziel-Datensatz-ID |
Geben Sie die ID des Datasets für den neuen Bericht ein. Um den neuen Bericht mit demselben Datensatz wie Report IDzu verknüpfen, lassen Sie ihn leer. |
Ziel-Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs für den neuen Bericht ein. Geben Sie für "Mein Arbeitsbereich" eine leere GUID ein: 00000000-0000-0000-0000-0000000000 . Um den neuen Bericht mit demselben Arbeitsbereich zu verknüpfen wie Arbeitsbereich-ID, lassen Sie ihn leer. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Bericht |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensatz erstellen
Um ein neues Dataset in einem Arbeitsbereich zu erstellen, verwenden Sie den Befehl Dataset erstellen .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Name |
Geben Sie den Namen des Datensatzes ein. |
Tabellen |
Geben Sie die Tabellen in das Dataset ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Datensatz |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Temporären Upload-Speicherort erstellen
Um einen temporären Blob-Speicher zu erstellen, z.B. um .PBIX-Dateien zwischen 1 GB und 10 GB zu importieren, verwenden Sie den Befehl Create temporary upload location .
Um große PBIX-Dateien zu importieren, erstellen Sie einen temporären Upload-Speicherort, laden Sie die PBIX-Datei unter Verwendung der SAS-URL (Shared Access Signature) aus der Antwort hoch, rufen Sie Post Import to Group auf und geben Sie die fileUrl
als SAS-URL im Request Body an.
Hinweis: Der Import großer .PBIX-Dateien ist nur für Arbeitsbereiche mit Premium-Kapazität und für .PBIX-Dateien zwischen 1 GB und 10 GB verfügbar.
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
URL |
Zeichenfolge |
Läuft ab bei |
Datum |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Alle Zeilen in der Tabelle löschen
Um alle Zeilen aus einer Tabelle im Dataset eines Arbeitsbereichs zu löschen, verwenden Sie den Befehl Delete all rows in table .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Name der Tabelle |
Geben Sie den Namen der Tabelle ein, aus der Zeilen gelöscht werden sollen. |
Ausgaben
Keine
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensatz löschen
Um einen Datensatz aus einem Arbeitsbereich zu löschen, verwenden Sie den Befehl Delete dataset .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Datensatz |
Zeichenfolge |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Bericht löschen
Um einen Bericht aus einem Arbeitsbereich zu löschen, verwenden Sie den Befehl Bericht löschen .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Bericht-ID |
Geben Sie die ID des Berichts ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
ID des gelöschten Berichts |
Zeichenfolge |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Bericht exportieren
Um einen Bericht aus einem Arbeitsbereich in eine .PBIX-Datei zu exportieren, verwenden Sie den Befehl Bericht exportieren .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Bericht-ID |
Geben Sie die ID des Berichts ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Berichtsexport (.PBIX) |
Datei |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensatz holen
Um einen Datensatz aus einem Arbeitsbereich abzurufen, verwenden Sie den Befehl Get dataset .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Datensatz |
JSON |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Dataset-Datenquellen abrufen
Um eine Liste der Datenquellen für das Dataset eines Arbeitsbereichs abzurufen, verwenden Sie den Befehl Get dataset datasources .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Datenquellen |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensatztabellen abrufen
Um eine Liste der Tabellen im Dataset eines Arbeitsbereichs abzurufen, verwenden Sie den Befehl Get dataset tables .
Hinweis: Dieser Befehl unterstützt nur Push-Datensätze.
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Tabellen |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Bericht abrufen
Um einen Bericht aus einem Arbeitsbereich abzurufen, verwenden Sie den Befehl Get report .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Bericht-ID |
Geben Sie die ID des Berichts ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Bericht |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datei importieren
Um neue Inhalte auf einem Arbeitsbereich aus einer .PBIX-Datei zu erstellen, verwenden Sie den Befehl Datei importieren .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatzname |
Geben Sie den Anzeigenamen der Daten ein, einschließlich der Dateierweiterung. |
Zum Namenskonflikt |
Wählen Sie aus, was geschehen soll, wenn bereits ein Datensatz mit demselben Namen existiert. Standardmäßig wird ignoriert. |
.PBIX-Datei |
Wenn Sie eine PBIX-Datei importieren, geben Sie die zu importierende Datei ein. Die Datei muss kleiner als 1 GB sein. |
Informationen importieren |
Wenn Sie eine große .PBIX-Datei importieren, geben Sie deren Details ein. |
Asynchroner Betrieb |
Aktivieren Sie dieses Kontrollkästchen, um nicht auf den Abschluss des Imports zu warten. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Dashboards auflisten
Um die Dashboards aufzulisten, die in einem Arbeitsbereich vorhanden sind und auf die der Benutzer zugreifen kann, verwenden Sie den Befehl Dashboards auflisten .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Dashboards |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensätze auflisten
Um die Datensätze aufzulisten, die in einem Arbeitsbereich vorhanden sind und auf die der Benutzer zugreifen kann, verwenden Sie den Befehl List datasets .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Datensätze |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Liste der Gateway-Datenquellen
Um die Datenquellen eines Gateways aufzulisten, verwenden Sie den Befehl List gateway datasources .
Eigenschaften
Eigentum |
Einzelheiten |
Gateway-ID |
Geben Sie die ID des Gateways ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Datenquellen |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Gateways auflisten
Um die Gateways aufzulisten, deren Administrator der Benutzer ist, verwenden Sie den Befehl List gateways .
Eigenschaften
Keine
Ausgaben
Ausgabe |
Art der Ausgabe |
Gateways |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Berichte auflisten
Um die Berichte aus einem Arbeitsbereich aufzulisten, verwenden Sie den Befehl Berichte auflisten .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Berichte |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Berichte an Datensatz neu binden
Um einen Bericht aus einem Arbeitsbereich erneut an ein Dataset zu binden, verwenden Sie den Befehl Berichte an Dataset neu binden .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Bericht-ID |
Geben Sie die ID des Berichts ein. |
Datensatz-ID |
Geben Sie die ID des neuen Datensatzes für den Rückprallbericht ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Bericht-ID |
Zeichenfolge |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Datensatz aktualisieren
Um den Datensatz eines Arbeitsbereichs zu aktualisieren, verwenden Sie den Befehl Refresh dataset .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Datensatz-ID |
Geben Sie die ID des Datensatzes ein. |
Art der Benachrichtigung |
Wählen Sie die Art der Benachrichtigung, die nach Abschluss der Aktualisierung gesendet werden soll. |
Ausgaben
Keine
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |
Inhalt des Berichts aktualisieren
Um einen Bericht aus einem Arbeitsbereich so zu aktualisieren, dass er den gleichen Inhalt wie ein anderer Bericht hat, verwenden Sie den Befehl Berichtsinhalt aktualisieren .
Eigenschaften
Eigentum |
Einzelheiten |
Arbeitsbereich-ID |
Geben Sie die ID des Arbeitsbereichs ein. |
Bericht-ID |
Geben Sie die ID des Berichts ein. |
Quellbericht-ID |
Geben Sie die ID des Quellberichts ein. |
ID des Quellarbeitsbereichs |
Geben Sie die ID des Arbeitsbereichs mit dem Quellbericht ein. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Bericht |
JSON |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es ist ein Fehler bei der Ausführung aufgetreten |
2 |
Fehler |
Bei der Authentifizierung mit Power BI ist ein Fehler aufgetreten |