Migrieren von Inhalten aus Power BI Embedded-Arbeitsbereichsammlungen zu Power BIHow to migrate Power BI Embedded workspace collection content to Power BI

Erfahren Sie, wie Sie Inhalte aus Power BI Embedded in den Power BI-Dienst migrieren und die Vorteile für das Einbetten in Apps nutzen.Learn how to migrate from Power BI Embedded to the Power BI service and leverage advances for embedding in apps.

Microsoft hat vor Kurzem Power BI Premium vorgestellt, ein neues kapazitätsbasiertes Lizenzierungsmodell, das die Flexibilität der Benutzer beim Zugriff, der Freigabe und dem Verteilen von Inhalten erhöht.Microsoft recently announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. Das Angebot bietet zusätzliche Skalierbarkeit und Leistung für den Power BI-Dienst.The offering also delivers additional scalability and performance to the Power BI service.

Mit der Einführung von Power BI Premium werden Power BI Embedded und der Power BI-Dienst zusammengeführt, um die Einbettung von Power BI-Inhalten in Apps zu optimieren.With the introduction of Power BI Premium, Power BI Embedded and the Power BI service are converging to advance how Power BI content is embedded in apps. Dies bedeutet, dass Ihnen eine API-Oberfläche, ein einheitlicher Satz von Funktionen und Zugriff auf die neuesten Power BI-Funktionen (z.B. Dashboards, Gateways und App-Arbeitsbereiche) zur Verfügung stehen, wenn Sie Inhalte einbetten.This means you will have one API surface, a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding your content. In Zukunft können Sie mit Power BI Desktop beginnen und zu einer Bereitstellung mit Power BI Premium wechseln. Dies wird im zweiten Quartal 2017 allgemein verfügbar sein.Moving forward you’ll be able to start with Power BI Desktop and move to deployment with Power BI Premium, which will be generally available late in the second quarter of 2017.

Der aktuelle Power BI Embedded-Dienst ist für einen begrenzten Zeitraum nach der allgemeinen Verfügbarkeit des zusammengeführten Angebots weiterhin verfügbar: Enterprise Agreement-Kunden haben bis zum Auslaufen ihrer vorhandenen Verträge Zugriff. Kunden, die Power BI Embedded über Direct- oder CSP-Kanäle erworben haben, haben nach der allgemeinen Verfügbarkeit von Power BI Premium ein Jahr lang Zugriff.The current Power BI Embedded service will continue to be available for a limited time following general availability of the converged offering: customers under an Enterprise Agreement will have access to through the expiration of their existing agreements; customers that acquired Power BI Embedded through Direct or CSP channels will enjoy access for one year from General Availability of Power BI Premium. Dieser Artikel bietet hilfreiche Informationen zur Migration vom Azure-Dienst zum Power BI-Dienst sowie Erläuterungen zu den zu erwartenden Änderungen in Ihrer Anwendung.This article will provide some guidance for migrating from the Azure service to the Power BI service and what to expect for changes in your application.

Wichtig

Für die Migration ist eine Abhängigkeit vom Power BI-Dienst vorhanden, die Benutzer Ihrer Anwendung sind aber nicht von Power BI abhängig, wenn sie ein Einbettungstoken verwenden.While the migration will take a dependency on the Power BI service, there is not a dependency on Power BI for the users of your application when using an embed token. Sie müssen sich nicht für Power BI registrieren, um die eingebetteten Inhalte in der Anwendung anzuzeigen.They do not need to sign up for Power BI to view the embedded content in your application. Sie können diesen Einbettungsansatz verwenden, um Nicht-Power BI-Benutzern zuzuarbeiten.You can use this embedding approach to service non-Power BI users.

Vorbereiten der MigrationPrepare for the migration

Es gibt einige Schritte, die Sie zur Vorbereitung der Migration vom Power BI Embedded Azure-Dienst zum Power BI-Dienst ausführen müssen.There are a few things you need to do to prepare for migrating from Power BI Embedded Azure service over to the Power BI service. Sie benötigen einen verfügbaren Mandanten sowie einen Benutzer mit einer Power BI Pro-Lizenz.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Stellen Sie sicher, dass Sie Zugriff auf einen Azure Active Directory-Mandanten (Azure AD) haben.Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    Sie müssen bestimmen, welches Mandantensetup verwendet werden soll.You will need to determine what tenant setup to use.

  2. Erstellen Sie einen Benutzer in diesem neuen Mandanten, der als Ihr „Master“-Anwendungskonto fungiert.Create a user within this new tenant that will act as your application "master" account. Das Konto muss für Power BI registriert werden und muss eine Power BI Pro-Lizenz zugewiesen bekommen.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Konten in Azure ADAccounts within Azure AD

Die folgenden Konten müssen in Ihrem Mandanten vorhanden sein.The following accounts will need to exist within your tenant.

Hinweis

Diese Konten benötigen Power BI Pro-Lizenzen, um App-Arbeitsbereiche nutzen zu können.These accounts will need to have Power BI Pro licenses in order to use App workspaces.

  1. Ein MandantenadministratorA tenant admin user.

    Dieser Benutzer sollte Mitglied aller App-Arbeitsbereiche sein, die zum Einbetten erstellt werden.It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

  2. Konten für Analysten, die Inhalte erstellenAccounts for analysts that will create content.

    Diese Benutzer sollten nach Bedarf App-Arbeitsbereichen zugewiesen werden.These users should be assigned to App workspaces as needed.

  3. Ein Anwendungs-Master-Benutzerkonto oder Dienstkonto.An application master user account, or service account.

    Das Back-End der Anwendung speichert die Anmeldeinformationen für dieses Konto und ruft damit ein Azure AD-Token für die Verwendung mit Power BI-APIs ab.The applications backend will store the credentials for this account and use it for acquiring an Azure AD token for use with the Power BI REST APIs. Mit diesem Konto wird das Einbettungstoken für die Anwendung generiert.This account will be used to generate the embed token for the application. Dieses Konto muss einem Administrator der App-Arbeitsbereiche gehören, die für die Einbettung erstellt werden.This account also needs to be an admin of the App workspaces created for embedding.

    Hinweis

    Dies ist lediglich ein herkömmliches Benutzerkonto in Ihrer Organisation, das für Einbettungszwecke verwendet wird.This is just a regular user account in your organziation that will be used for the purposes of embedding.

App-Registrierung und BerechtigungenApp registration and permissions

Sie müssen eine Anwendung in Azure AD registrieren und bestimmte Berechtigungen erteilen.You will need to register an application within Azure AD and grant certain permissions.

Registrieren einer AnwendungRegister an application

Sie müssen Ihre Anwendung bei Azure AD registrieren, um REST-API-Aufrufe ausführen zu können.You will need to register your application with Azure AD in order to make REST API calls. Dazu müssen Sie nicht nur die Power BI-Seite für die App-Registrierung besuchen, sondern auch im Azure-Portal weitere Konfigurationsschritte ausführen.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. Weitere Informationen finden Sie unter Registrieren einer Azure AD-App zum Einbetten von Power BI-Inhalten.For more information, see Register an Azure AD app to embed Power BI content.

Sie müssen die Anwendung mithilfe des Hauptkontos der Anwendung registrieren.You should register the application using the application master account.

Erstellen von App-Arbeitsbereichen (erforderlich)Create App workspaces (Required)

Sie können App-Arbeitsbereiche nutzen, um eine bessere Isolation bereitzustellen, wenn Ihre Anwendung von mehreren Kunden verwendet wird.You can take advantage of App workspaces to provide better isoliation if your application is servicing multiple customers. Dashboards und Berichte werden dann zwischen Ihren Kunden isoliert.Dashboards and reports would be isolated between your customers. Sie können anschließend ein Power BI-Konto pro App-Arbeitsbereich verwenden, um die Anwendungsnutzung für die Kunden noch weiter zu isolieren.You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

Wichtig

Sie können in einem persönlichen Arbeitsbereich nicht das Einbetten in Nicht-Power BI-Benutzer nutzen.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Sie benötigen einen Benutzer, der über eine Pro-Lizenz verfügt, um einen App-Arbeitsbereich in Power BI zu erstellen.You will need a user that has a Pro license in order to create an app workspace within Power BI. Der Power BI-Benutzer, der den App-Arbeitsbereich erstellt, ist standardmäßig der Administrator dieses Arbeitsbereichs.The Power BI user that creates the App workspace will be an admin of that workspace by default.

Hinweis

Das Hauptkonto der Anwendung muss ein Administrator des Arbeitsbereichs sein.The application master account needs to be an admin of the workspace.

Migration von InhaltenContent migration

Das Migrieren Ihrer Inhalte aus Ihren Arbeitsbereichsammlungen für den Power BI-Dienst kann parallel zur aktuellen Projektmappe ausgeführt werden und erfordert keine Ausfallzeiten.Migrating your content from your workspace collections to the Power BI service can be done in parallel to your current solution and doesn’t require any downtime.

Ein Migrationstool steht Ihnen zur Verfügung, um Sie beim Kopieren von Inhalt aus Power BI Embedded in Power BI-Dienst zu unterstützen.A migration tool is available for you to use in order to assist with copying content from Power BI Embedded to the Power BI service. Insbesondere, wenn Sie viel Inhalt haben.Especially if you have a lot of content. Weitere Informationen finden Sie unter Power BI Embedded Migrationstool.For more information, see Power BI Embedded migration tool.

Die Migration von Inhalten verwendet hauptsächlich zwei APIs.Content migration relies mainly on two APIs.

  1. Download PBIX: Diese API kann PBIX-Dateien herunterladen, die auf Power BI nach Oktober 2016 hochgeladen wurden.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. Import PBIX: Diese API lädt alle PBIX in Power BI hoch.Import PBIX - this API uploads any PBIX to Power BI.

Einige verbundene Codeausschnitte finden Sie unter Codeausschnitte zum Migrieren von Inhalt von Power BI Embedded.For some related code snippets, see Code snippets for migrating content from Power BI Embedded.

BerichtstypenReport types

Es gibt mehrere Berichtstypen, jeder erfordert einen etwas anderen Migrationsflow.There are several types of reports, each requiring a somewhat different migration flow.

Zwischengespeichertes Dataset & BerichtCached dataset & report

Zwischengespeicherte Datasets finden Sie in PBIX-Dateien, die Daten im Gegensatz zu einer Liveverbindung oder DirectQuery-Verbindung importiert hatten.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

FlowFlow

  1. Herunterladen PBIX-API Aufrufen im PaaS-Arbeitsbereich.Call Download PBIX API from PaaS workspace.
  2. Speichern Sie die PBIX.Save PBIX.
  3. Rufen Sie Import PBIX SaaS-Arbeitsbereich auf.Call Import PBIX to SaaS workspace.

DirectQuery-Dataset & BerichtDirectQuery dataset & report

FlowFlow

  1. Rufen Sie GET-https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources auf, und speichern Sie die empfangene Verbindungszeichenfolge.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. Herunterladen PBIX-API Aufrufen im PaaS-Arbeitsbereich.Call Download PBIX API from PaaS workspace.
  3. Speichern Sie die PBIX.Save PBIX.
  4. Rufen Sie Import PBIX SaaS-Arbeitsbereich auf.Call Import PBIX to SaaS workspace.
  5. Aktualisieren Sie die Verbindungszeichenfolge durch das Aufrufen von – POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnectionsUpdate connection string by calling - POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections
  6. Rufen Sie GW-ID und Datasource-ID auf, indem Sie GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources aufrufenGet GW id and datasource id by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. Aktualisieren Sie die Anmeldeinformationen eines Benutzers, indem Sie PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id} aufrufen.Update user's credentials by calling - PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}

Altes Dataset & BerichtOld dataset & reports

Hierbei handelt es sich um Datasets/Berichte, die vor Oktober 2016 erstellt wurden.These are datasets/reports created before October 2016. Das Herunterladen von PBIX unterstützt keine PBIXs, die vor Oktober 2016 hochgeladen wurdenDownload PBIX doesn't support PBIXs which were uploaded before October 2016

FlowFlow

  1. Rufen Sie PBIX aus Ihrer Entwicklungsumgebung (die interne Quellcodeverwaltung) ab.Get PBIX from your development environment (your internal source control).
  2. Rufen Sie Import PBIX SaaS-Arbeitsbereich auf.Call Import PBIX to SaaS workspace.

Push-Dataset & BerichtPush Dataset & report

PBIX herunterladen unterstützt keine Push-API-Datasets.Download PBIX doesn't support Push API datasets. Daten von Datasets per Push-API können nicht von PaaS zu SaaS portiert werden.Push API dataset data can't be ported from PaaS to SaaS.

FlowFlow

  1. Rufen Sie die „Create Dataset“-API (Dataset erstellen) mit Dataset-Json auf, um Datasets im Arbeitsbereich „SaaS“ zu erstellen.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. Erstellen Sie für das erstellte Dataset * einen neuen Bericht.Rebuild report for the created dataset*.

Es ist möglich, einige Problemumgehungen zum Migrieren des Push-Vorgangs mit API-Bericht von PaaS zu SaaS zu verwenden, indem Sie das Folgende versuchen.It is possible using some workarounds to migrate the push api report from PaaS to SaaS by trying the following.

  1. Hochladen von einigen Dummy-PBIX in den PaaS-Arbeitsbereich.Uploading some dummy PBIX to PaaS workspace.
  2. Klonen Sie den Push-API-Bericht, und verbinden Sie diesen mit dem Dummy-PBIX aus Schritt 1.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. Push-API-Bericht mit dem Dummy-PBIX herunterladen.Download push API report with the dummy PBIX.
  4. Laden Sie den Dummy-PBIX in Ihren SaaS-Arbeitsbereich hoch.Upload dummy PBIX to your SaaS workspace.
  5. Erstellen Sie ein Push-Dataset in Ihrem SaaS-Arbeitsbereich.Create push dataset in your SaaS workspace.
  6. Binden Sie den Bericht erneut an das Push-API-Dataset.Rebind report to push api dataset.

Erstellen und Hochladen von BerichtenCreate and upload new reports

Zusätzlich zu dem Inhalt, den Sie vom Power BI Embedded Azure-Dienst migriert haben, können Sie Ihre Berichte und Datasets mit Power BI Desktop erstellen, und dann veröffentlichen Sie diese Berichte in einem App-Arbeitsbereich.In addition to the content you migrated from the Power BI Embedded Azure service, you can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. Der Endbenutzer, der die Berichte veröffentlicht, muss über eine Power BI Pro-Lizenz verfügen, damit er einen App-Arbeitsbereich veröffentlichen kann.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Erneutes Erstellen der AnwendungRebuild your application

  1. Sie müssen Ihre Anwendung ändern, um die Power BI-REST-APIs und den Speicherort des Berichts in „powerbi.com“ zu verwenden.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. Erstellen Sie die AuthN-/AuthZ-Authentifizierung unter Verwendung des Masterkontos für Ihre Anwendung neu.Rebuild your AuthN/AuthZ authentication using the master account for your application. Sie können dabei ein Einbettungstoken verwenden, damit dieser Benutzer im Auftrag anderer Benutzer handeln kann.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Betten Sie Ihre Berichte auf „powerbi.com“ in Ihrer Anwendung ein.Embed your reports from powerbi.com into your application.

Zuordnen der Benutzer zu einem Power BI-BenutzerMap your users to a Power BI user

Innerhalb Ihrer Anwendung ordnen Sie Benutzer, die Sie in der Anwendung verwalten, für Ihre Anwendung Masteranmeldeinformationen für Power BI zu.Within your application, you will map users that you manage within the application to a master Power BI credential for the purposes of your application. Die Anmeldeinformationen für dieses Power BI-Masterkonto werden in Ihrer Anwendung gespeichert und zum Erstellen von Einbettungstoken verwendet.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

Wenn Sie bereit für die Produktionsphase sindWhat to do when you are ready for production

Wenn Sie in die Produktionsphase wechseln möchten, müssen Sie die folgenden Schritte ausführen.When you are ready to move to production, you will need to do the following.

  • Wenn Sie einen separaten Mandanten für die Entwicklung verwenden, müssen Sie sicherstellen, dass Ihre App-Arbeitsbereiche, zusammen mit Dashboards und Berichten, in der Produktionsumgebung verfügbar sind.If you are using a separate tenant for development, then you will need to make sure your app workspaces, along with dashboards and reports, are available in your production environment. Sie müssen zudem sicherstellen, dass Sie die Anwendung in Azure AD für Ihren Produktionsmandanten erstellt haben, und dass Sie die entsprechenden App-Berechtigungen zugewiesen haben, wie in Schritt 1 angegeben.You will also need to make sure that you created the application in Azure AD for your production tenant and assigned the proper app permissions as indicated in Step 1.
  • Erwerben Sie eine Kapazität, die Ihren Anforderungen entspricht.Purchase a capacity that fits your needs. Sie können das Whitepaper zur Kapazitätsplanung der eingebetteten Analyse nutzen, um zu erfahren, was Sie möglicherweise benötigen.You can use the Embedded analytics capacity planning whitepaper to help understand what you may need. Sie können das Produkt im Administratorcenter von Office 365 erwerben.When you are ready to purchase, you can do so within the Office 365 admin center.

    [AZURE.INFORMATION] Informationen zum Erwerb von Power BI Premium finden Sie unter Erwerben von Power BI Premium.[AZURE.INFORMATION] For information on how to purchase Power BI Premium, see How to purchase Power BI Premium.

  • Bearbeiten Sie den App-Arbeitsbereich, und weisen Sie diesen einer Premium-Kapazität unter „Erweitert“ zu.Edit the App workspace and assign it to a Premium capacity under advanced.

  • Stellen Sie die aktualisierte Anwendung für die Produktion bereit, und beginnen Sie mit dem Einbetten von Berichten aus dem Power BI-Dienst.Deploy your updated application to production and begin embedding reports from the Power BI service.

Nach der MigrationAfter migration

Sie sollten in Azure einige Bereinigungsschritte ausführen.You should do some cleanup within Azure.

  • Entfernen Sie alle Arbeitsbereiche aus der bereitgestellten Lösung im Azure-Dienst von Power BI Embedded.Remove all workspaces off of the deployed solution within the Azure service of Power BI Embedded.
  • Löschen Sie alle Arbeitsbereichsammlungen, die in Azure vorhanden sind.Delete any Workspace Collections that exist within Azure.

Nächste SchritteNext steps

Einbetten mit Power BIEmbedding with Power BI
Power BI Embedded-MigrationstoolPower BI Embedded migration tool
Codeausschnitte zum Migrieren von Inhalt von Power BI EmbeddedCode snippets for migrating content from Power BI Embedded
Wie soll ich Power BI-Dashboards, -Berichte und -Kacheln einbetten?How to embed your Power BI dashboards, reports and tiles
Power BI Premium – BeschreibungPower BI Premium - what is it?
JavaScript-API-Git-RepositoryJavaScript API Git repo
Power BI-C#-Git-RepositoryPower BI C# Git repo
JavaScript-EinbettungsbeispielJavaScript embed sample
Whitepaper zur Kapazitätsplanung der eingebetteten AnalyseEmbedded analytics capacity planning whitepaper
Power BI Premium-WhitepaperPower BI Premium whitepaper

Weitere Fragen?More questions? Stellen Sie Ihre Frage in der Power BI-Community.Try asking the Power BI Community