Als u gegevens wilt exporteren en importeren in Microsoft Power BI® en de verschillende objecten die deel uitmaken van uw Power BI-implementatie als onderdeel van een keten wilt beheren, voegt u een stap toe die een Microsoft Power BI-verbindingsopdracht bevat.
Om deze opdrachten in te schakelen, maakt een IT-beheerder eerst een Power BI-connector.
Opmerking: De connector kan geen verbinding maken met Power BI als multifactorauthenticatie (MFA) is ingeschakeld.
Rijen aan dataset toevoegen
Om nieuwe gegevensrijen aan een tabel in de dataset van een werkruimte toe te voegen, gebruikt u de opdracht Rijen aan dataset toevoegen .
Opmerking: Deze opdracht beschouwt dubbele rijen als toegevoegd, zelfs als ze in Power BI worden genegeerd.
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Naam tabel |
Voer de naam in van de tabel waaraan u rijen wilt toevoegen. |
Gegevens |
Voer het bestand in dat de gegevens bevat die u aan de tabel wilt toevoegen. |
Gegevenstype |
Selecteer of Data JSON of CSV is. |
Scheidingsteken |
Als Gegevenstype CSV is, voer dan het scheidingsteken in dat in het bestand wordt gebruikt. |
Uitgangen
Uitgang |
Type uitvoer |
Rijen Toegevoegd |
Geheel getal |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Dataset aan gateway binden
Om een dataset van een werkruimte aan een gateway te binden, gebruikt u een Bind dataset to gateway opdracht. Alleen ondersteund vanuit de On-Premises Data Gateway.
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Gateway |
Voer het ID van de gateway in. |
Uitgangen
Geen
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Kloonrapport
Als u een rapport vanuit een werkruimte wilt klonen, gebruikt u de opdracht Rapport klonen .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Rapport ID |
Voer de ID van het rapport in. |
Naam |
Voer de naam van het nieuwe rapport in. |
Doelgegevensverzameling ID |
Voer de ID van de dataset voor het nieuwe rapport in. Om het nieuwe rapport aan dezelfde dataset te koppelen als Rapport-ID, laat u leeg. |
Doel-werkruimte-ID |
Voer de ID van de werkruimte voor het nieuwe rapport in. Voer voor "My Workspace" een lege GUID in 00000000-0000-0000-0000-0000000000 .Om het nieuwe rapport met dezelfde werkruimte te associëren als Workspace ID, laat u leeg. |
Uitgangen
Uitgang |
Type uitvoer |
Rapporteer |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Dataset aanmaken
Om een nieuwe dataset in een werkruimte te maken, gebruikt u de opdracht Create dataset .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Naam |
Voer de naam van de dataset in. |
Tabellen |
Voer de tabellen in de dataset in. |
Uitgangen
Uitgang |
Type uitvoer |
Dataset |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Tijdelijke uploadlocatie aanmaken
Om een tijdelijke blobopslag te maken, bijvoorbeeld om .PBIX-bestanden tussen 1 GB en 10 GB te importeren, gebruikt u een opdracht Tijdelijke uploadlocatie maken .
Om grote .PBIX-bestanden te importeren, maakt u een tijdelijke uploadlocatie aan, uploadt u het .PBIX-bestand met behulp van de URL voor gedeelde toegangshandtekeningen (SAS) uit het antwoord, en roept u Post Import op naar Group en specificeert u de fileUrl
als de SAS URL in de Request Body.
Opmerking: Grote .PBIX-bestanden importeren is alleen beschikbaar voor werkruimten met premium capaciteit en voor .PBIX-bestanden tussen 1 GB en 10 GB.
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Uitgangen
Uitgang |
Type uitvoer |
URL |
String |
Verloopt op |
Datum |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Alle rijen in de tabel verwijderen
Om alle rijen uit een tabel in de dataset van een werkruimte te verwijderen, gebruikt u de opdracht Alle rijen in tabel verwijderen .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Naam tabel |
Voer de naam in van de tabel waaruit u rijen wilt verwijderen. |
Uitgangen
Geen
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Dataset verwijderen
Om een dataset uit een werkruimte te verwijderen, gebruikt u de opdracht Delete dataset .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Uitgangen
Uitgang |
Type uitvoer |
Dataset |
String |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Rapport verwijderen
Als u een rapport uit een werkruimte wilt verwijderen, gebruikt u de opdracht Rapport verwijderen .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Rapport ID |
Voer de ID van het rapport in. |
Uitgangen
Uitgang |
Type uitvoer |
Verwijderde rapport-ID |
String |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Rapport exporteren
Om een rapport van een werkruimte naar een .PBIX-bestand te exporteren, gebruikt u de opdracht Rapport exporteren .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Rapport ID |
Voer de ID van het rapport in. |
Uitgangen
Uitgang |
Type uitvoer |
Rapport exporteren (.PBIX) |
Bestand |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Gegevensverzameling ophalen
Om een dataset uit een werkruimte op te halen, gebruikt u de opdracht Get dataset .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Uitgangen
Uitgang |
Type uitvoer |
Dataset |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Dataset gegevensbronnen ophalen
Om een lijst met gegevensbronnen voor de dataset van een werkruimte op te halen, gebruikt u de opdracht Get dataset datasources .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Uitgangen
Uitgang |
Type uitvoer |
Databronnen |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Gegevensverzamelingstabellen ophalen
Om een lijst van tabellen binnen de dataset van een werkruimte op te halen, gebruikt u de opdracht Get dataset tables .
Opmerking: Deze opdracht ondersteunt alleen Push-datasets.
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Uitgangen
Uitgang |
Type uitvoer |
Tabellen |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Rapport krijgen
Om een rapport uit een werkruimte op te halen, gebruikt u de opdracht Get report .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Rapport ID |
Voer de ID van het rapport in. |
Uitgangen
Uitgang |
Type uitvoer |
Rapporteer |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Bestand importeren
Om nieuwe inhoud op een werkruimte te maken vanuit een .PBIX-bestand, gebruikt u de opdracht Bestand importeren .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Naam dataset |
Voer de weergavenaam van de gegevens in, inclusief de bestandsextensie. |
Over naamconflicten |
Selecteer wat u moet doen als er al een dataset met dezelfde naam bestaat. Standaard is Negeer . |
.PBIX bestand |
Als u een .PBIX-bestand importeert, voer dan het te importeren bestand in. Bestand moet kleiner zijn dan 1GB. |
Informatie importeren |
Als u een groot .PBIX-bestand importeert, voer dan de details in. |
Asynchroon uitvoeren |
Vink dit vakje aan om niet te wachten tot de import voltooid is. |
Uitgangen
Uitgang |
Type uitvoer |
Importeren |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Lijst dashboards
Om een lijst te maken van de dashboards die in een werkruimte bestaan en waartoe de gebruiker toegang heeft, gebruikt u de opdracht List dashboards .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Uitgangen
Uitgang |
Type uitvoer |
Dashboards |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Lijst datasets
Om een lijst te maken van de datasets die in een werkruimte bestaan en waartoe de gebruiker toegang heeft, gebruikt u de opdracht List datasets .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Uitgangen
Uitgang |
Type uitvoer |
Datasets |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Lijst gateway-gegevensbronnen
Om de databronnen van een gateway op te sommen, gebruikt u de opdracht List gateway datasources .
Eigenschappen
Eigendom |
Detail |
Gateway ID |
Voer het ID van de gateway in. |
Uitgangen
Uitgang |
Type uitvoer |
Databronnen |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Lijst met gateways
Om een lijst te maken van de gateway waar de gebruiker beheerder van is, gebruikt u een List gateways commando.
Eigenschappen
Geen
Uitgangen
Uitgang |
Type uitvoer |
Poorten |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Lijst rapporten
Om de rapporten van een werkruimte op te sommen, gebruikt u de opdracht List reports .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Uitgangen
Uitgang |
Type uitvoer |
Rapporten |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Herbind rapporten aan dataset
Om een rapport van een werkruimte opnieuw aan een dataset te binden, gebruikt u de opdracht Rebind reports to dataset .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Rapport ID |
Voer de ID van het rapport in. |
Dataset-ID |
Voer het ID van de nieuwe dataset voor het uitgaande rapport in. |
Uitgangen
Uitgang |
Type uitvoer |
Rapport ID |
String |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Dataset vernieuwen
Om de dataset van een werkruimte te verversen, gebruikt u de opdracht Refresh dataset .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Dataset-ID |
Voer het ID van de dataset in. |
Type melding |
Selecteer het type melding dat verstuurd moet worden wanneer de verversing voltooid is. |
Uitgangen
Geen
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |
Rapportinhoud bijwerken
Als u een rapport van een werkruimte wilt bijwerken zodat het dezelfde inhoud heeft als een ander rapport, gebruikt u de opdracht Rapportinhoud bijwerken .
Eigenschappen
Eigendom |
Detail |
Werkruimte-ID |
Voer de ID van de werkruimte in. |
Rapport ID |
Voer de ID van het rapport in. |
Bron rapport ID |
Voer het ID van het bronrapport in. |
Bron-werkruimte-ID |
Voer de ID van de werkruimte met het bronrapport in. |
Uitgangen
Uitgang |
Type uitvoer |
Rapporteer |
JSON |
Afsluitcodes
Code |
type |
Detail |
0 |
Succes |
Succes |
1 |
Fout |
Er is een fout opgetreden tijdens de uitvoering |
2 |
Fout |
Er is een fout opgetreden bij het verifiëren met Power BI |