Power BI に Power BI Embedded ワークスペース コレクション コンテンツを移行する方法How to migrate Power BI Embedded workspace collection content to Power BI

Power BI Embedded から Power BI サービスに移行し、アプリでの埋め込みで先進機能を利用する方法について説明します。Learn how to migrate from Power BI Embedded to the Power BI service and leverage advances for embedding in apps.

最近、Microsoft は Power BI Premium を発表しました。この新しい容量ベースのライセンス モデルは、ユーザーによるコンテンツのアクセス、共有および配布方法の柔軟性を高めます。Microsoft recently announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. また、Power BI サービスのスケーラビリティとパフォーマンスが向上します。The offering also delivers additional scalability and performance to the Power BI service.

Power BI Premium の導入に伴い、Power BI Embedded および Power BI サービスが統合され、Power BI コンテンツをアプリにより迅速に埋め込むことができるようになります。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. これは、1 つの API サーフェスで一貫性のある一連の機能を利用でき、コンテンツを埋め込む際にダッシュボード、ゲートウェイ、アプリ ワークスペースなどの最新の Power BI 機能にアクセスできることを意味します。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. 今後は、Power BI Desktop で作業を開始し、Power BI Premium でデプロイできるようになります。Power BI Premium は 2017 年の第 2 四半期の終わりに一般提供される予定です。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.

現在の Power BI Embedded サービスは、統合版が一般提供された後、期間限定で引き続き利用可能です。エンタープライズ契約されたお客様は現在の契約が満了するまでご利用いただけます。ダイレクト チャネルまたは CSP チャネル経由で Power BI Embedded を入手されたお客様は、Power BI Premium が一般提供されてから 1 年間はご利用いただけます。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. この記事では、Azure サービスから Power BI サービスに移行するためのいくつかのガイダンスと、アプリケーションの変更について予想されることを示します。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.

重要

移行操作と Power BI サービスに依存関係がある場合でも、埋め込みトークンを使用すれば、アプリケーションのユーザーは Power BI に依存することはありません。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. ユーザーは、アプリケーションに埋め込まれたコンテンツを表示するために Power BI にサインアップする必要はありません。They do not need to sign up for Power BI to view the embedded content in your application. この埋め込み方法を使用して、Power BI 以外のユーザーにサービスを提供することができます。You can use this embedding approach to service non-Power BI users.

移行の準備をするPrepare for the migration

Power BI Embedded Azure サービスから Power BI サービスへの移行の準備のために行う必要がある作業がいくつかあります。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. 使用可能なテナントと、Power BI Pro ライセンスを持つユーザーが必要になります。You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Azure Active Directory (Azure AD) テナントにアクセスできることを確認します。Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    使用するテナントのセットアップを判別する必要があります。You will need to determine what tenant setup to use.

  2. アプリケーションの "マスター" アカウントとして機能する、この新しいテナントのユーザーを作成します。Create a user within this new tenant that will act as your application "master" account. そのアカウントで Power BI にサインアップする必要があります。また、このアカウントに Power BI Pro のライセンスが割り当てられている必要があります。That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Azure AD 内のアカウントAccounts within Azure AD

次のアカウントがテナント内に存在する必要があります。The following accounts will need to exist within your tenant.

注意

これらのアカウントでは、アプリ ワークスペースを使用するために、Power BI Pro ライセンスが必要になります。These accounts will need to have Power BI Pro licenses in order to use App workspaces.

  1. テナント管理者ユーザー。A tenant admin user.

    このユーザーは、埋め込むために作成されたすべてのアプリ ワークスペースのメンバーにすることをお勧めします。It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

  2. コンテンツを作成するアナリストのアカウント。Accounts for analysts that will create content.

    これらのユーザーは、必要に応じて、アプリ ワークスペースに割り当てる必要があります。These users should be assigned to App workspaces as needed.

  3. アプリケーション マスター ユーザー アカウント、またはサービス アカウント。An application master user account, or service account.

    アプリケーション バックエンドにはこのアカウントの資格情報が格納され、Power BI REST API で使用する Azure AD トークンを取得するために使用されます。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. このアカウントは、アプリケーションの埋め込みトークンを生成するために使用されます。This account will be used to generate the embed token for the application. また、このアカウントは、埋め込むために作成されたアプリ ワークスペースの管理者にする必要があります。This account also needs to be an admin of the App workspaces created for embedding.

    注意

    これは、埋め込みの目的で使用される組織内の通常のユーザー アカウントです。This is just a regular user account in your organziation that will be used for the purposes of embedding.

アプリの登録とアクセス許可App registration and permissions

Azure AD 内でアプリケーションを登録し、特定のアクセス許可を付与する必要があります。You will need to register an application within Azure AD and grant certain permissions.

アプリケーションを登録するRegister an application

REST API の呼び出しを行うには、Azure AD にアプリケーションを登録する必要があります。You will need to register your application with Azure AD in order to make REST API calls. そのためには、Power BI アプリ登録ページだけでなく、Azure Portal に移動して追加構成を適用します。This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. 詳しくは、「Azure AD アプリを登録して Power BI コンテンツを埋め込む」をご覧ください。For more information, see Register an Azure AD app to embed Power BI content.

アプリケーションのマスター アカウントを使用してアプリケーションを登録する必要があります。You should register the application using the application master account.

アプリ ワークスペースを作成する (必須)Create App workspaces (Required)

アプリケーションが複数の顧客にサービスを提供している場合、アプリ ワークスペースを利用することで、より適切に分離することができます。You can take advantage of App workspaces to provide better isoliation if your application is servicing multiple customers. ダッシュボードとレポートは顧客間で分離されます。Dashboards and reports would be isolated between your customers. その後、アプリ ワークスペースごとに Power BI アカウントを使用して、顧客間でさらにアプリケーション エクスペリエンスを分離できます。You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

重要

Power BI 以外のユーザー向けに埋め込みを利用するために、個人用ワークスペースを使用することはできません。You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Power BI 内でアプリ ワークスペースを作成するには、Pro ライセンスを持つユーザーが必要です。You will need a user that has a Pro license in order to create an app workspace within Power BI. アプリ ワークスペースを作成する Power BI ユーザーは、既定ではそのワークスペースの管理者になります。The Power BI user that creates the App workspace will be an admin of that workspace by default.

注意

アプリケーションのマスター アカウントは、ワークスペースの管理者である必要があります。The application master account needs to be an admin of the workspace.

コンテンツの移行Content migration

ワークスペース コレクションから Power BI サービスへのコンテンツの移行は、現在のソリューションと並行して行うことができ、ダウンタイムを必要としません。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.

Power BI Embedded から Power BI サービスにコンテンツをコピーする際に役立つ移行ツールを使用することができます。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. これは特に、多くのコンテンツがある場合に役立ちます。Especially if you have a lot of content. 詳細については、「Power BI Embedded 移行ツール」を参照してください。For more information, see Power BI Embedded migration tool.

コンテンツの移行は主に 2 つの API に依存します。Content migration relies mainly on two APIs.

  1. .pbix のダウンロード - この API では、2016 年 10 月以降に Power BI にアップロードされた PBIX ファイルをダウンロードできます。Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. .pbix のインポート - この API では Power BI に PBIX をアップロードします。Import PBIX - this API uploads any PBIX to Power BI.

いくつかの関連するコード スニペットについては、「Code snippets for migrating content from Power BI Embedded」 (Power BI Embedded からコンテンツを移行するためのコード スニペット) を参照してください。For some related code snippets, see Code snippets for migrating content from Power BI Embedded.

レポートの種類Report types

レポートにはいくつかの種類があり、それぞれ若干異なる移行フローが必要になります。There are several types of reports, each requiring a somewhat different migration flow.

キャッシュ データセットとレポートCached dataset & report

キャッシュ データセットは、ライブ接続や DirectQuery 接続とは異なり、データをインポートした PBIX ファイルを指します。Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

フローFlow

  1. PaaS ワークスペースからの .pbix のダウンロード API の呼び出しを行います。Call Download PBIX API from PaaS workspace.
  2. PBIX を保存します。Save PBIX.
  3. SaaS ワークスペースへの .pbix のインポートの呼び出しを行います。Call Import PBIX to SaaS workspace.

DirectQuery データセットとレポートDirectQuery dataset & report

フローFlow

  1. GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources を呼び出し、受信した接続文字列を保存します。Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. PaaS ワークスペースからの .pbix のダウンロード API の呼び出しを行います。Call Download PBIX API from PaaS workspace.
  3. PBIX を保存します。Save PBIX.
  4. SaaS ワークスペースへの .pbix のインポートの呼び出しを行います。Call Import PBIX to SaaS workspace.
  5. POST 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. GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources を呼び出して、GW ID とデータ ソースを取得します。Get GW id and datasource id by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id} を呼び出して、ユーザーの資格情報を更新します。Update user's credentials by calling - PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}

古いデータセットとレポートOld dataset & reports

これらは、2016 年 10 月より前に作成されたデータセット/レポートです。These are datasets/reports created before October 2016. .pbix のダウンロードでは、2016 年 10 月より前にアップロードされた PBIX はサポートされません。Download PBIX doesn't support PBIXs which were uploaded before October 2016

フローFlow

  1. 開発環境 (内部ソース管理) から PBIX を取得します。Get PBIX from your development environment (your internal source control).
  2. SaaS ワークスペースへの .pbix のインポートの呼び出しを行います。Call Import PBIX to SaaS workspace.

プッシュ データセットとレポートPush Dataset & report

.pbix のダウンロードではプッシュ API データセットはサポートされません。Download PBIX doesn't support Push API datasets. プッシュ API データセット データを PaaS から SaaS に移植することはできません。Push API dataset data can't be ported from PaaS to SaaS.

フローFlow

  1. データセット Json で "データセットの作成" API を呼び出し、SaaS ワークスペースにデータセットを作成します。Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. 作成したデータセット用にレポートを再構築します*。Rebuild report for the created dataset*.

いくつかの回避策を使用して、PaaS から SaaS にプッシュ API レポートを移行することができます。その場合、以下の手順を試します。It is possible using some workarounds to migrate the push api report from PaaS to SaaS by trying the following.

  1. ダミーの PBIX をいくつか PaaS ワークスペースにアップロードします。Uploading some dummy PBIX to PaaS workspace.
  2. プッシュ API レポートを複製し、それを手順 1. に示されているダミーの PBIX にバインドします。Clone the push api report and bind it to the dummy PBIX from step 1.
  3. ダミーの PBIX でプッシュ API レポートをダウンロードします。Download push API report with the dummy PBIX.
  4. SaaS ワークスペースにダミーの PBIX をアップロードします。Upload dummy PBIX to your SaaS workspace.
  5. SaaS ワークスペースでプッシュ データセットを作成します。Create push dataset in your SaaS workspace.
  6. プッシュ API データセットにレポートを再バインドします。Rebind report to push api dataset.

新しいレポートを作成してアップロードするCreate and upload new reports

Power BI Embedded Azure サービスから移行したコンテンツに加え、Power BI Desktop を使用してレポートとデータセットを作成してから、アプリ ワークスペースにそれらのレポートを発行することができます。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. レポートを発行するエンド ユーザーには、アプリ ワークスペースに発行するための Power BI Pro ライセンスが必要です。The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

アプリケーションを再構築するRebuild your application

  1. powerbi.com 内のレポートの場所と Power BI REST API を使用するには、アプリケーションを変更する必要があります。You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. アプリケーションのマスター アカウントを使用して、AuthN/AuthZ 認証を再構築します。Rebuild your AuthN/AuthZ authentication using the master account for your application. このユーザーが他のユーザーの代わりに動作できるようにするには、埋め込みトークンを利用します。You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Powerbi.com からレポートをアプリケーションに埋め込みます。Embed your reports from powerbi.com into your application.

ユーザーを Power BI ユーザーにマップするMap your users to a Power BI user

アプリケーション内で管理するユーザーを、アプリケーション用のマスター Power BI 資格情報にマップします。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. この Power BI マスター アカウントの資格情報はアプリケーション内に格納され、埋め込みトークンの作成に使用されます。The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

運用環境の準備ができたときに実行する作業What to do when you are ready for production

運用環境に移行する準備ができたら、以下の手順を実行する必要があります。When you are ready to move to production, you will need to do the following.

  • 開発用に個別のテナントを使用する場合は、アプリ ワークスペース、ダッシュボードおよびレポートが運用環境で利用可能であることを確認する必要があります。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. また、運用テナントの Azure AD でアプリケーションを作成し、手順 1. のとおり、適切なアプリにアクセス許可を割り当てたことを確認する必要があります。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.
  • ニーズに合う容量を購入します。Purchase a capacity that fits your needs. ニーズに合った容量の大きさと種類については、埋め込み分析の容量計画に関するホワイト ペーパーをご覧ください。To better understand how the amount and type of capacity you neeed, see the Embedded analytics capacity planning whitepaper. Azure で容量を購入できます。You can purchase capacity in Azure.
  • アプリ ワークスペースを編集し、[詳細] で Premium 容量にそれを割り当てます。Edit the App workspace and assign it to a Premium capacity under advanced.

  • 更新されたアプリケーションを運用環境にデプロイし、Power BI サービスからのレポートの埋め込みを開始します。Deploy your updated application to production and begin embedding reports from the Power BI service.

移行後After migration

Azure 内でいくつかのクリーンアップを行う必要があります。You should do some cleanup within Azure.

  • Power BI Embedded の Azure サービス内にデプロイ済みのソリューションからすべてのワークスペースを除去します。Remove all workspaces off of the deployed solution within the Azure service of Power BI Embedded.
  • Azure 内に存在するすべてのワークスペース コレクションを削除します。Delete any Workspace Collections that exist within Azure.

次の手順Next steps

Power BI で埋め込みEmbedding with Power BI
Power BI Embedded 移行ツールPower BI Embedded migration tool
Power BI Embedded からコンテンツを移行するためのコード スニペットCode snippets for migrating content from Power BI Embedded
Power BI ダッシュボード、レポート、およびタイルを埋め込む方法How to embed your Power BI dashboards, reports and tiles
Power BI Premium とはPower BI Premium - what is it?
JavaScript API Git リポジトリJavaScript API Git repo
Power BI C# Git リポジトリPower BI C# Git repo
JavaScript 埋め込みサンプルJavaScript embed sample
埋め込み分析の容量計画に関するホワイト ペーパーEmbedded analytics capacity planning whitepaper
Power BI Premium ホワイト ペーパーPower BI Premium whitepaper

他にわからないことがある場合は、More questions? Power BI コミュニティで質問してみてくださいTry asking the Power BI Community