Power BI Embedded に関してよく寄せられる質問

Microsoft Power BI Embedded (PBIE) を利用すれば、アプリケーション開発者は、完全にインタラクティブな優れたレポートをアプリケーションに埋め込むことができます。データの視覚エフェクトやコントロールを自分で一から構築する必要はありません。

アプリケーションをコーディングしている開発者やソフトウェア企業です。独立系ソフトウェア ベンダー (ISV) とも呼ばれます。

Power BI は、サービスとしてのソフトウェアの分析ソリューションです。組織はその最も重要なビジネス データを 1 つのビューで見ることができます。

Microsoft は、顧客が分析に関する決定を行うときに役立つビジュアルをアプリケーションに埋め込もうと考えている ISV のために Power BI Embedded を開発しました。 これにより、ISV は独自の分析ソリューションを自分で構築する必要がなくなります。 埋め込み分析を使用すると、ビジネス ユーザーはビジネス データにアクセスしてクエリを実行し、アプリケーション内で分析情報を生成できます。

Power BI Premium は、組織、パートナー、顧客、サプライヤーを 1 つのビューで見ることができる完全 BI ソリューションを望む企業向けです。 Power BI Premium は組織の意思決定に役立ちます。 Power BI Premium は SaaS 製品であり、ユーザーはモバイル アプリ、社内で開発したアプリを使用して、または Power BI ポータルでコンテンツを利用できます。

Power BI Embedded は、アプリケーションにビジュアルを埋め込むことを望む ISV 用です。 Power BI Embedded はアプリケーション開発者向けであり、そのアプリケーションを入手すれば、組織の内外を問わず、誰でも Power BI Embedded 容量に保存されているコンテンツを利用できます。Power BI Embedded は顧客の意思決定に役立ちます。 Power BI Embedded 容量に入っているコンテンツを、ワンクリック Web 公開やワンクリック SharePoint 公開で共有することはできません。

Microsoft は、企業に、エンタープライズ グレードのセルフサービス クラウド BI ソリューションである Power BI Premium を購入することをお勧めします。 ISV には、クラウドを利用した埋め込み分析コンポーネント用に Power BI Embedded の購入をお勧めします。 ただし、お客様が購入する製品に制限はありません。

ISV (通常は大規模) が、アプリの埋め込みに加えて、P SKU を使用し、事前パッケージ済みの Power BI サービスのベネフィットを組織内でさらに利用する場合もあります。

Premium と Embedded の違いについては、「どの SKU を使用すべきか」を参照してください。

PRO または Premium Per User (PPU) のライセンスでの埋め込みトークンは、開発テストを意図したものであるため、Power BI マスター アカウントまたはサービス プリンシパルで生成できるトークンの数には制限があります。 運用環境で埋め込むには、容量を購入してください。 容量を購入する場合、生成できる埋め込みトークンの数に上限はありません。 開発テストでは、Pro ライセンスで埋め込み無料試用版トークンを使用できます。 運用環境に埋め込むには、容量を購入する必要があります。

Embedded Premium 容量には、面倒な設定の要らない垂直自動スケーリング機能はありません。 Embedded Premium 容量の代替自動スケーリング オプションの詳細については、「Embedded の自動スケーリング (./azure-pbie-scale-capacity.md#autoscale-your-capacity)」をご覧ください。

Power BI Embedded Premium では、使用率レコードを 30 秒ごとに集計することによって使用率のレベルを評価します。 各評価は、"対話的な使用率" と "バックグラウンド使用率" という 2 つの異なる集計で構成されます。

"対話的な使用率" は、現在の 30 秒の評価サイクルか、またはほぼその評価サイクルで完了したすべての対話型の操作を考慮することによって評価されます。

バックグラウンド使用率は、過去 24 時間以内に完了したすべてのバックグラウンド操作を考慮することによって評価されます。ここで、各バックグラウンド操作は、その合計 CPU コストの 1/2880 にのみ寄与します (各 24 時間の期間内に 2880 の評価サイクルが存在します)。

容量は、定義された数の仮想コアで構成されます。 Microsoft Fabric Capacity Metrics アプリは、容量の仮想コアの使用率を追跡します。 アプリで報告された CPU 使用率によって、自動スケーリングの必要性が決まります。

1 つの仮想コアを含む A1 容量がある場合、各評価サイクル クォータは 30 秒 (1*30) の CPU 使用率になります。 お使いの CPU 使用率の合計が容量の仮想コア クォータの合計を超えた場合、その容量は一時的な "対話型の要求遅延" モードになります。その間、対話型の各要求 (レポートの読み込みや、ビジュアルの相互作用など) は、実行のためにエンジンに送信される前に遅延されます。 遅延の量は、検出されたオーバーロードの量に比例します。 100% のオーバーロードでは 20 秒の遅延が発生するのに対して、10% 未満のオーバーロードは許可されます。

以前の評価が 100% を超えるリソース使用率になっている場合、その容量は "対話型の要求遅延" モードのままになります。

次のイベントは対話型の操作です。

• データセット - レポート ビュー、クエリ、XMLA 読み取り
• データフロー
• ページ割り付けレポート - ページ割り付けレポートのレンダリング

次のものはバックグラウンド操作です。

• データセット - スケジュールされた更新、オンデマンドの更新、バックグラウンド クエリ (更新後)
• データフロー - スケジュールされたデータフローの更新
• ページ割り付けレポート - データ ドリブン サブスクリプションのレンダリング
• AI

メトリック レポートのデータセットには 30 ～ 45 日間のデータが保持されます。 このレポートを使用すると、容量の最大リソースにどれだけ近づいているかを示すことができます。また、月単位のスナップショットを保存している場合は、それらを比較して、増加の傾向を示したり、100% のリソース使用率に達する速度を推定したりすることができます。

Embedded Premium には次の 2 つのオプションがあります。

• Power BI 管理ポータルの [容量管理] ページには、使用率通知のチェックボックスがあります。 ユーザーは、アラートがトリガーされるしきい値 (既定値は 80%) と、使用率のアラートが送信されるメール アドレスを選択できます。
• Premium CPU メトリックを使用して Azure アラートを構成します。

Power BI サービスでは、90 日間の使用率データを格納します。 これより長いデータ保有期間が必要なユーザーは、Bring Your Own Log Analytics (BYOLA) を使用して、さらに多くの使用率データを格納できます。これは、Embedded Premium のお客様が Embedded Premium の一般公開 (GA) 日までに使用できるようになります。

使用率レポートの左側にある横棒グラフ ビジュアルには、レポートの期間中のワークスペース間の使用率情報が表示されます。 各ワークスペースが、チャージバックを適用できるさまざまな ISV の顧客、部署、コスト センター、またはその他のエンティティを表している場合は、この横棒グラフ ビジュアルをチャージバックに使用できます。

「Power BI Embedded の分析の容量と SKU」の記事を参照してください。

• 組織のディレクトリにサインインします (Microsoft アカウントはサポートされていません)。
• Power BI テナントを用意する必要があります。つまり、ディレクトリの少なくとも 1 名のユーザーが Power BI にサインアップしている必要があります。
• 組織のディレクトリに Azure サブスクリプションを用意する必要があります。

• Power BI 管理ポータルを使用します。

• Power BI で Microsoft Fabric 容量メトリック アプリをダウンロードします。

• Azure 診断ログを使用します。

現在、自動的なスケーリングはありませんが、いつでもすべての API をスケーリングに利用できます。

容量のプロビジョニング (拡張、再開、作成) は失敗することがあります。 Get Details API を使って、容量の ProvisioningState を確認できます。Capacities - Get Details を使用します。

Multi-geo 機能では、Power BI ホーム テナントの場所とは異なるリージョンで Power BI Embedded 容量を購入できます。

ユーザーがワークスペース、アプリ、またはアイテムへのアクセス許可を付与されても、API 呼び出しですぐに利用できない場合があります。 結果として、"GET" API の応答にアイテムが含まれていなかったり、アイテムを使おうとするとエラーが発生したりする可能性があります。 ユーザーは、ユーザーのアクセス許可を更新する refreshUserPermissions API を呼び出すことによって、この問題を解決できます。

PBI ポータルを使って、PBI テナント リージョンを確認できます。

https://app.powerbi.com/> ? > Power BI について

• サブスクリプションの種類が CSP の場合、ご自身のテナントに対して PBIE を作成できます。
• パートナー アカウントは顧客テナントにサインインし、顧客テナントの代わりに PBIE を購入し、Power BI 容量の管理者として顧客テナント ユーザーを指定できます。

Power BI では、組織のアカウントでサインアップすることが求められます。 Microsoft アカウントを使って Power BI にサインアップする試みはサポートされていません。

はい。PowerShell コマンドレットや Azure Resource Manager REST API を使用して、PBIE リソースを作成および管理できます。

• REST API
• PowerShell コマンドレット

ソリューションを運用に昇格させるには、アプリケーションで使う Power BI コンテンツ (ワークスペース) を、Power BI Embedded (A SKU) 容量に割り当てる必要があります。

Power BI Embedded は非リージョンです。 これは、特定の Azure リージョンに依存しないことを意味します。

すべての Azure 製品に関するリージョン情報については、「リージョン別の Azure 製品」を参照してください。

Power BI Embedded では引き続き、マスター ユーザー (Power BI Pro または Premium Per User (PPU) のライセンスが与えられた指名ユーザー) の認証には Microsoft Entra ID が使用され、Power BI 内のアプリケーションの認証にはサービス プリンシパルが使用されます。

ISV は、アプリケーション用に独自の認証と認可を実装できます。

Microsoft Entra テナントが既にある場合は、既存のディレクトリを使用できます。 埋め込みアプリケーション コンテンツのセキュリティ用に新しい Microsoft Entra テナント作成することもできます。

Microsoft Entra トークンを取得するには、Microsoft 認証ライブラリのいずれかを使用します。 複数のプラットフォームで利用可能なクライアント ライブラリがあります。

登録済みアプリのメイン画面の "オブジェクト ID" が、アプリのオブジェクト ID です。

[ローカル ディレクトリでのマネージド アプリケーション] > [プロパティ] セクションで示されているオブジェクト ID が、使用する必要のあるサービス プリンシパル オブジェクト ID です。 このオブジェクト ID は、操作に対するサービス プリンシパルを参照するため、またはサービス プリンシパル オブジェクト ID を変更するためのものです。 ワークスペースに対する管理者としてのサービス プリンシパルの割り当てなどです。

Azure で Power BI Embedded を購入する前に、Power BI アカウントを用意する必要があります。 Power BI Embedded がデプロイされているリージョンによって、Power BI アカウントが決まります。 Azure の Power BI Embedded リソースを次の目的で管理します。

• 拡大/縮小
• 容量管理者の追加
• サービスの一時停止/再開

PowerBI.com を利用し、Power BI Embedded 容量のワークスペースの割り当て/割り当て解除を行います。

RLS と JavaScript のフィルターを使用するタイミングについて、混乱することがよくあります。 1 つは特定のユーザーが表示できるものの制御に関する方法であり、もう 1 つはユーザーの表示の最適化に関するものです。

RLS の場合、ISV の開発者が、モデルの作成と埋め込みトークンの生成の一部として、データのフィルター処理を制御します。 エンド ユーザーには、ISV によって表示が許可されているもののみが表示されます。 この場合、ユーザーはフィルター処理されているものより少なく表示することはできますが、RLS の構成をバイパスして許可されているものよりも多く表示することはできません。

クライアント側のフィルター処理 (JavaScript) の場合、ISV では最初のビューでエンド ユーザーに表示されるものを決める場合はありますが、ISV ではエンドユーザーがビュー自体に適用する可能性がある変更を制御することはできません。 ユーザーの JavaScript クライアント コードでバックエンドでのデータのフィルター処理をトリガーできるため、それは安全とは見なされません。

Power BI でサービス プリンシパルを使用できるようにすると、アプリケーションの AD アクセス許可は無効になります。 アプリケーションのアクセス許可はその後、Power BI 管理ポータルを介して管理されます。

サービス プリンシパルは、対象セキュリティ グループの Power BI テナントのすべての設定のアクセス許可を継承します。 アクセス許可を制限するには、サービス プリンシパル専用のセキュリティ グループを作成し、関連する有効な Power BI 設定の [特定のセキュリティ グループを除く] リストに追加します。

このような状況は、新しいワークスペースに管理者としてサービス プリンシパルを追加するときに問題となります。 このタスクは API または Power BI サービスを使用して管理できます。

アプリケーション ID ("クライアント ID" とも呼ばれます) は、認証のためにアプリケーション ID を渡すときに、アクセス トークンを作成する目的で使用されます。

ワークスペースに管理者としてサービス プリンシパルを適用するなど、サービス プリンシパルを各種操作または変更のために参照するには、 サービス プリンシパル オブジェクト ID を使用します。

"顧客向けの埋め込み" の方法を使って改ページ対応レポートの視覚化を含む Power BI レポートを埋め込むには、サービス プリンシパルを使い、次を含むマルチリソース埋め込みトークンを使ってレポートを埋め込みます。

• Power BI レポート ID
• (視覚化が接続されているレポートの) 改ページ対応レポート ID
• (Power BI レポートの) データセット ID

サービス プリンシパルには、両方のレポート (改ページ対応と Power BI) へのアクセス権が必要です。 トークンの生成呼び出しの要求本文の例:

{
  "datasets": [
    {
      "id": "a5d577c7-0568-4180-a6d3-0f6cc0ca3df4"
    }
  ],
  "reports": [
    {
      "allowEdit": false,
      "id": "05024421-b4df-483c-a2ce-61202d0323ce"
    },
    {
      "id": "f8612306-f3a8-40e1-a448-d8e05992a007"
    }
  ]
}

いいえ - サービス プリンシパルを使用して Power BI にサインインすることはできません。

また、埋め込みトークンの生成時のみ、外部アプリケーション (SaaS 埋め込み) でユーザーとしてコンテンツを利用できません。

Power BI Embedded のパフォーマンス

Power BI Embedded は Azure からお買い求めいただけます。

コンシューマーは、購入した既存の Power BI Premium を現在の契約期間の終了まで支払い続け、その時点で必要に応じて購入した Power BI Premium を切り替えることができます。

いいえ。Power BI Embedded には、ソリューションをデプロイし、顧客に配信するために必要な Azure ベースの容量が含まれています。

顧客は時間単位で使用方法を変更できます。 Power BI Embedded サービスには、月または年単位のコミットメントはありません。

Power BI Embedded は、デプロイしたノードの種類に基づき、予測可能な時間レートで課金されます。 リソースが有効である限り、使用していなくても課金されます。 課金を停止するには、リソースを一時停止する必要があります。

REST API を使うには、Power BI Pro または Premium Per User (PPU) のライセンスまたはサービス プリンシパルが必要です。 アナリストが Power BI ワークスペースにレポートを追加するには、Power BI Pro または Premium Per User (PPU) のライセンスまたはサービス プリンシパルが必要です。 管理者が Power BI のテナントと容量を管理するには、Power BI Pro または Premium Per User (PPU) のライセンスが必要です。

Power BI Embedded では、埋め込みコンテンツの管理と検証に Power BI ポータルを利用できるため、PowerBI.com 内でアプリを認証し、正しいリポジトリのレポートにアクセスするには、Power BI Pro または Premium Per User (PPU) のライセンスが必要です。

ただし、自分のアプリケーション内で埋め込みレポートを作成または編集する場合、エンド ユーザーは Power BI ユーザーである必要がないため、Pro または Premium Per User (PPU) のライセンスは必要ありません。

はい。Power BI Embedded の Azure クレジットをご利用いただけます。

Power BI Embedded は Azure の一部であるため、Azure 登録時に受け取った $200 のクレジットを使ってサービスを利用することが可能です。

Power BI Embedded は国/地域内クラウドにも利用できます。

非営利団体や教育機関のための特別な Azure 料金はありません。

Power BI ワークスペース コレクション (Power BI Embedded バージョン 1) は、Power BI ワークスペース コレクション Azure リソースに基づくソリューションです。 このソリューションを利用すると、Power BI ワークスペース コレクション ソリューションの下にある Power BI コンテンツ、専用 API、および Power BI に対してアプリケーションを認証するワークスペース コレクション キーを使って、顧客向けの Power BI Embedded アプリケーションを作成できます。

はい。ただし、Power BI ワークスペース コレクション ソリューションを既に使っているお客様は、非推奨になるまで引き続き使用できます。 お客様は、新しいワークスペース コレクション、および Power BI ワークスペース コレクション ソリューションをまだ使用する Power BI Embedded アプリケーションを作成することもできます。

ただし、これはどの Power BI ワークスペース コレクション ソリューションにも新しい機能が追加されないことも意味します。 お客様には、新しい Power BI Embedded ソリューションへの移行を計画することをお勧めします。

既に Power BI ワークスペース コレクション ソリューションを使っているお客様は、サポート契約が終了するまで、引き続き使用できます。

使用できるリージョンは、オーストラリア南東部、ブラジル南部、カナダ中部、米国東部 2、東日本、米国中北部、北ヨーロッパ、米国中南部、東南アジア、英国南部、西ヨーロッパ、インド西部、米国西部です。

Power BI Embedded ソリューションには、Power BI ワークスペース コレクションでは使用できない機能がいくつかあります。

次のような機能です。

• PBI データ ソースはすべてサポートされています。 Power BI ワークスペース コレクション データ ソースは、2 つだけサポートされています。
• Q&A、更新、ブックマーク、ダッシュボードとタイルの埋め込み、カスタム メニューなどの機能は、Power BI Embedded ソリューションでのみサポートされます。
• 容量の課金モデル。

埋め込みのセットアップ ツールを使うと、サンプル アプリケーションを簡単にダウンロードして Power BI で埋め込みを開始することができます。

• 顧客向けの埋め込みでは、Power BI のアカウントがないユーザーのためにダッシュボードとレポートを埋め込むことができます。 埋め込みセットアップ ツールで、"顧客向けの埋め込み" ソリューションを実行します。
• 組織向けの埋め込みを使って、Power BI サービスを拡張することができます。 埋め込みセットアップ ツールで、"組織向けに埋め込む" ソリューションを実行します。

顧客向けの埋め込みエクスペリエンスを使用している場合、PowerBI-Developer-Samples.zip ファイルを保存して解凍します。 次に、PowerBI-Developer-Samples-master\App Owns Data フォルダーを開き、PowerBIEmbedded_AppOwnsData.sln ファイルを実行します。

組織向けの埋め込みエクスペリエンスを使用している場合、PowerBI-Developer-Samples.zip ファイルを保存して解凍します。 次に、PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app フォルダーを開き、pbi-saas-embed-report.sln ファイルを実行します。

Microsoft Entra 登録済みアプリケーションを編集する方法については、「クイック スタート: Microsoft Entra ID でアプリケーションを更新する」を参照してください。

Power BI データの編集方法は、こちらをご覧ください。

詳しくは、「埋め込みアプリケーションのトラブルシューティング」をご覧ください。

他にわからないことがある場合は、 Power BI コミュニティを利用してください。