Power BI のページ分割されたレポートを埋め込む
Power BI 埋め込み分析を使用すると、完全に統合された対話型アプリケーションにページ分割されたレポートが表示される Power BI コンテンツを作成できます。 最適なソリューションを使用してページ分割されたレポートを、顧客向けまたは組織向けに埋め込むことができます。
この記事では、埋め込みのサンプル チュートリアルを使用して、ページ分割されたレポートを埋め込む方法について説明します。
前提条件
開始するには、以下が必要です。
独自の Microsoft Entra テナントのセットアップ
Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。
メソッド
サンプル アプリを使用してページ分割されたレポートを埋め込むには、次の手順に従います。
ステップ 1 - ワークスペースを作成する
サービス プリンシパルを使ってアプリケーションにサインインしている場合は、ワークスペースを作成する必要があります。
また、サービス プリンシパルは、Power BI ワークスペースの管理者またはメンバーである必要があります。
ステップ 2 - 容量を作成する
埋め込み対象の改ページ対応レポートをインポートまたはアップロードする前に、レポートを含むワークスペースを容量に割り当てる必要があります。 選択できる容量には、次の 2 種類があります。
- Power BI Premium - 改ページ対応レポートを埋め込むには、EM または P SKU が必要です。 このサブスクリプションの詳細については、「Power BI Premium とは」を参照してください。
- Azure Power BI Embedded - Microsoft Azure portal で容量を購入できます。 このサブスクリプションは、A SKU を使用します。 Power BI Embedded 容量の作成方法の詳細については、「Create Power BI Embedded capacity in the Azure portal」 (Azure Portal で Power BI Embedded 容量を作成する) をご覧ください。
次の表は、各 SKU のリソースと制限を示しています。 ニーズに最適な容量を判断するには、シナリオに応じてどの SKU を購入すればよいかをまとめた表を参照してください。
容量ノード | 仮想コア | RAM (GB) |
---|---|---|
EM1/A1 | 1 | 2.5 |
EM2/A2 | 2 | 5 |
EM3/A3 | 4 | 10 |
P1/A4 | 8 | 25 |
P2/A5 | 16 | 50 |
P3/A6 | 32 | 100 |
ステップ 3 - 容量にワークスペースを割り当てる
容量を作成したら、アプリ ワークスペースをその容量に割り当てます。
サービス プリンシパルを使って容量をワークスペースに割り当てるには、Power BI REST API を使います。 Power BI REST API の使用時は必ずサービス プリンシパル オブジェクト ID を使ってください。
注意
Power BI REST API を使用して、ページ分割されたレポートをワークスペースにインポートすることもできます。
ステップ 4 - ページ分割されたレポートを作成してアップロードする
Power BI レポート ビルダーを使用して、ページ分割されたレポートを作成し、レポートをサービスにアップロードできます。
注意
改ページ対応レポートをアップロードするユーザーには、ワークスペースに発行するための Power BI Pro または Premium Per User (PPU) のライセンスが必要です。
ステップ 5 - サンプル アプリケーションを使用してコンテンツを埋め込む
「顧客向けにコンテンツを埋め込む」チュートリアルの手順に従います。 「ステップ 4 - Power BI レポートを作成して発行する」をスキップし、チュートリアルで示したサンプル レポートの代わりに、アップロード済みの改ページ対応レポートを使います。
Power BI のセマンティック モデルをデータ ソースとして使用するには:
- テナント設定 [XMLA エンドポイントとオンプレミスのデータセットによる "Excel で分析" の許可] が有効になっていることを確認します。
- Power BI ポータルで、「Premium 容量の読み取り/書き込みを有効にするには」の説明に従って、[XMLA エンドポイント] を [読み取り専用] または [読み取り/書き込み] に設定します。 エンドポイントを設定する必要があるのは、容量ごとに 1 回だけです。
- 要求内に指定したデータセット ID と 読み込み専用 に設定した XmlaPermissions を使用し、マルチリソース埋め込みトークンを生成します。
シングル サインオン (SSO) が有効なデータ ソースを使うには:
- データ ソースが改ページ対応レポートに直接接続する場合、改ページ対応レポートのデータ ソースである Power BI セマンティック モデルに接続する場合、Power BI は SSO 対応データ ソースをサポートします。
- SSO 対応データ ソースを使って改ページ対応レポートを埋め込む場合は、マルチリソース埋め込みトークンを生成するときに、データ ソースの ID BLOB を
DatasourceIdentity
に指定する必要があります。
埋め込みトークンの詳細については、「埋め込み分析アクセス トークン」を参照してください。
考慮事項と制限事項
- サポートされているデータセットとその認証方法の完全な一覧については、「Power BI のページ分割されたレポートでサポートされるデータ ソース」を参照してください。
- サービス プリンシパルを使用する必要があります。 マスター ユーザーを持つことはできません。
- Premium Per User (PPU) は使用できません。
- Power BI セマンティック モデルを使って改ページ対応レポートを埋め込む場合、2 つの条件が適用されます。
- 改ページ対応レポートと Power BI セマンティック モデルは、Premium Per Capacity または Embedded ワークスペースに存在する必要があります (2 つの異なるワークスペースに存在することができます)。
- 埋め込みトークンを生成するユーザーには、レポートとセマンティック モデルの両方のワークスペースで、"書き込み" アクセス許可が必要です。
- 現在、シングル サインオン (SSO) が有効な Azure Analysis Services に接続されている改ページ対応レポートを埋め込むことはできません。
- 改ページ対応レポートでは、クライアント側のイベント (
loaded
やrendered
など) はサポートされていません - ページ分割されたレポートでは、クライアント側の setAccessToken API はサポートされていません (レポートを再読み込みせずに acccess トークンを更新することはできません)。
- リアルタイム データセット (プッシュ データセット) を使った改ページ対応レポートの埋め込みは、サポートされていません。