Migrieren von Inhalten aus der Power BI-Arbeitsbereichssammlung zu Power BI EmbeddedHow to migrate Power BI Workspace Collection content to Power BI Embedded

Erfahren Sie, wie Sie Inhalte aus der Power BI-Arbeitsbereichssammlung zu Power BI Embedded migrieren und die Vorteile für das Einbetten in Apps nutzen.Learn how to migrate from Power BI Workspace Collection to Power BI Embedded and leverage advances for embedding in apps.

Microsoft hat vor Kurzem Power BI Embedded 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 Embedded, 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.The offering also delivers additional scalability and performance.

Mit Power BI Embedded stehen Ihnen eine API-Oberfläche, ein einheitlicher Satz von Funktionen und Zugriff auf die neuesten Power BI-Features (z.B. Dashboards, Gateways und App-Arbeitsbereiche) zur Verfügung, wenn Sie Inhalte einbetten.With Power BI Embedded, 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 Embedded wechseln.Moving forward you’ll be able to start with Power BI Desktop and move to deployment with Power BI Embedded.

Die aktuelle Power BI-Arbeitsbereichssammlung ist für einen begrenzten Zeitraum weiterhin verfügbar.The current Power BI Workspace Collection will continue to be available for a limited time. Kunden mit einem Enterprise Agreement haben bis zum Ablauf ihrer vorhandenen Vereinbarungen Zugriff darauf; Kunden, welche die Power BI-Arbeitsbereichssammlung über einen direkten Kanal oder einen CSP-Kanal erworben haben, haben ab dem allgemeinen Verfügbarkeitsrelease von Power BI Embedded ein Jahr lang weiterhin Zugriff darauf.Customers under an Enterprise Agreement will have access through the expiration of their existing agreements; customers that acquired Power BI Workspace Collection through Direct or CSP channels will maintain access for one year from the General Availability release of Power BI Embedded. Dieser Artikel bietet hilfreiche Informationen zur Migration der Power BI-Arbeitsbereichssammlung zum neuen Power BI Embedded sowie Erläuterungen zu den zu erwartenden Änderungen in Ihrer Anwendung.This article will provide some guidance for migrating from Power BI Workspace Collection to the new Power BI Embedded experience and what to expect for changes in your application.

Wichtig

Für die Migration ist eine Abhängigkeit von Power BI Embedded 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 Power BI Embedded, 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 in Power BI Embedded verwenden, um Nicht-Power BI-Benutzern zuzuarbeiten.You can use this embedding approach to Embedded non-Power BI users.

Flow einbetten

Bevor Sie mit der Migration zum neuen Dienst Power BI Embedded beginnen, können Sie kurz eine exemplarische Vorgehensweise durcharbeiten, die Ihnen dabei hilft, Ihre neue Power BI Embedded-Umgebung mit dem Setuptool für die Einbettung einzurichten.Before you get started migrating to the new Power BI Embedded, you can quickly go through a walkthrough that helps you set up your new Power BI Embedded environment using the Embedding setup tool.

Wählen Sie die am besten für Sie geeignete Lösung aus:Choose the solution that is right for you:

Vorbereiten der MigrationPrepare for the migration

Es gibt einige Schritte, die Sie zur Vorbereitung der Migration der Power BI-Arbeitsbereichssammlung zu Power BI Embedded ausführen müssen.There are a few things you need to do to prepare for migrating from Power BI Workspace Collection to Power BI Embedded. 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 need to determine which 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 Master-Benutzerkonto der Anwendung oder Embedded-Konto.An application master user account, or Embedded 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 organization 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 isolation 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 Arbeitsbereichssammlungen für Power BI Embedded kann parallel zur aktuellen Projektmappe erfolgen und erfordert keine Ausfallzeiten.Migrating your content from your workspace collections to Power BI Embedded can be done in parallel to your current solution and doesn’t require any downtime.

Ihnen steht ein Migrationstool zur Verfügung, um Sie beim Kopieren von Inhalten aus der Power BI-Arbeitsbereichssammlung in Power BI Embedded zu unterstützen.A migration tool is available for you to use in order to assist with copying content from Power BI Workspace Collection to Power BI Embedded. 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.

Unter Code snippets for migrating content from Power BI Workspace Collection (Codeausschnitte zum Migrieren von Inhalten aus dem Power BI-Arbeitsbereich) finden Sie einige zugehörige Codeausschnitte.For some related code snippets, see Code snippets for migrating content from Power BI Workspace Collection.

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 auf (https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources), und speichern Sie die erhaltene 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, indem Sie POST aufrufen (https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections).Update connection string by calling - POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections
  6. Rufen Sie die GW-ID und Datenquellen-ID über GET (https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources) auf.Get GW id and datasource id by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. Aktualisieren Sie die Benutzeranmeldedaten, 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 aus dem Power BI-Arbeitsbereich migriert haben, können Sie Ihre Berichte und Datasets mit Power BI Desktop erstellen und diese Berichte anschließend in einem App-Arbeitsbereich veröffentlichen.In addition to the content you migrated from the Power BI Workspace Collection, 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. Lesen Sie das Whitepaper zur Kapazitätsplanung für die Analyse in Power BI Embedded (in englischer Sprache), um die Menge und Art der benötigten Kapazität besser zu verstehen.To better understand how the amount and type of capacity you need, see the Power BI Embedded analytics capacity planning whitepaper. Sie können in Azure Kapazität erwerben.You can purchase capacity in Azure.

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

    Premium-Kapazität

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

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 in Azure Embedded der Power BI-Arbeitsbereichssammlung.Remove all workspaces off of the deployed solution within the Azure Embedded of Power BI Workspace Collection.
  • 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
Migrationstool für die Power BI-ArbeitsbereichssammlungPower BI Workspace Collection migration tool
Codeausschnitte zum Migrieren von Inhalten aus der Power BI-ArbeitsbereichssammlungCode snippets for migrating content from Power BI Workspace Collection
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 Analyse von ArbeitsbereichssammlungenWorkspace Collection 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