Power BI Embedded を設定する

適用対象: アプリ所有データ ユーザー所有データ

Power BI Embedded の使用を開始してレポートを他のユーザーと共有するには、Power BI 埋め込み分析セットアップ ツールを使用して作業を開始します。 この記事では、その方法について説明します。

Power BI 埋め込み分析を使うには、Microsoft Entra アプリケーションを Azure に登録する必要があります。 Microsoft Entra アプリで Power BI REST リソースのアクセス許可を確立し、Power BI REST API にアクセスできるようにします。

前提条件

Power BI 埋め込み分析環境を設定するには、次のいずれかが必要です。

開始する前に

アプリを登録する前に、次のソリューションのうち、ニーズに最も適しているものを決定します。

顧客向けに埋め込む

顧客向けに設計されたアプリを作成する場合は、顧客向けの埋め込みソリューション ("アプリ所有データ" ともいう) を使用します。 アプリを使用するために、ユーザーは Power BI にサインインする必要も、Power BI ライセンスを持っている必要もありません。 アプリにより、マスター ユーザー アカウント (Power BI へのサインインに使用される Power BI Pro ライセンス) またはサービス プリンシパルを使用して、Power BI に対して認証が行われます。

顧客向けの埋め込みソリューションは、通常、独立系ソフトウェア ベンダー (ISV) およびサードパーティ向けアプリケーションを作成する開発者によって使用されます。

組織向けに埋め込む

Power BI に対して、ユーザーが自分の資格情報を使用して認証する必要があるアプリケーションを作成する場合は、組織向けの埋め込みソリューション (別名 "ユーザー所有データ") を使用します。

組織向けの埋め込みソリューションは、通常、企業や大規模な組織で使用され、内部ユーザーを対象としています。

2 つのソリューションの詳細については、「Power BI の埋め込み分析ソリューションとは」を参照してください。

環境の設定方法

2 つの埋め込みオプションを理解したら、セットアップ ツールを使用して Power BI Embedded 環境を作成できます。

環境を手動で設定する場合は、次の数セクションの手順をスキップしてください。 代わりに、この記事の後半にある「手動での登録」の手順に従います。

重要

GCC 用に埋め込む場合は、「手動での登録」の手順に従ってください。

このツールを使用して環境を設定するには、Power BI 埋め込み分析セットアップ ツールに移動します。 目的の埋め込みオプションを選択します。

Screenshot of the Power BI embedded analytics setup tool. The options for embedding for your customers or for your organization are highlighted.

手順 1 - Power BI にサインインする

  1. セットアップ ツールの [手順 1] で、[サインイン] を選択します。 この手順で、Power BI にサインインします。 アカウントを選択するように求められた場合は、お使いの Power BI テナントに属しているユーザーでサインインします。 Microsoft Entra アプリは、このユーザーの下に登録されます。

    Screenshot of the Power BI embedded analytics setup tool. Under Step 1, the Sign in button is highlighted.

    Note

    既にサインインしている場合は、Microsoft Entra アプリの作成に使用するユーザーでサインインしていることを確認します。 ユーザーを変更するには、[サインアウト] を選択します。ツールが再起動したら、正しいユーザーでサインインします。

  2. [次へ] を選択して、次の手順に進みます。

    Screenshot of the Power BI embedded analytics setup tool after a user has signed in to Power BI. The Next button in highlighted.

手順 2 - アプリケーションを登録する

この手順では、Microsoft Entra アプリケーションを Azure に登録します。 Microsoft Entra アプリで Power BI REST リソースのアクセス許可を確立し、Power BI REST API にアクセスできるようにします。 これらの設定は後でいつでも変更できます。

  1. 顧客向けのアプリケーションを登録するには、次のフィールドに入力します。

    • [アプリケーション名] - アプリケーションに名前を付けます。

    • [API アクセス] - アプリケーションに必要な Power BI API (スコープとも呼ばれます) を選択します。 [すべて選択] を選択してすべての API を選ぶことができます。 Power BI アクセス許可の詳細については、「Microsoft ID プラットフォーム エンドポイントでのアクセス許可と同意」を参照してください。

    Screenshot of the Power BI embedded analytics setup tool. The step for registering an app is visible, with an app name box and API access options.

  2. 登録 を選択します。

  3. Microsoft Entra アプリのアプリケーション ID[概要] ボックスに表示されます。 この値を後で使用するためにコピーします。

    Screenshot of the Power BI embedded analytics setup tool, with a Summary box on the right. Information in the box includes an application ID.

手順 3 - ワークスペースを作成する (省略可能)

Power BI サービスでワークスペースを作成します。

  • Power BI ワークスペースが既にある場合は、 [スキップ] を選択します。

  • ワークスペースを作成するには、ワークスペースの名前を入力し、次に [ワークスペースの作成] を選択します。 ワークスペースの名前と ID は、[概要] ボックスに表示されます。 後で使用するために、これらの値をコピーします。

    ヒント

    埋め込み分析サンプル アプリを想定どおりに動作させるには、ツールを使用してワークスペースを作成する必要があります。

手順 4 - コンテンツをインポートする (省略可能)

以下のオプションの 1 つを選択します。

  • 独自の Power BI アプリがある場合は、 [スキップ] を選択できます。

  • サンプル レポートを使用してサンプル Power BI アプリを作成する場合は、[サンプル Power BI レポート]、次に [インポート] の順に選択します。

  • 独自のレポートを使用してサンプル Power BI アプリを作成する場合は、[.pbix ファイルのアップロード] を選び、ファイルを参照してから [インポート] を選択します。

手順 5 - アクセス許可を付与する (''顧客向けの埋め込み'' のみ)

[アクセス許可の付与] を選択し、ダイアログで [承諾] を選びます。 この手順により、Microsoft Entra アプリから、サインインしているユーザーで選んだ API (スコープとも呼ばれます) にアクセスできるようになります。 このユーザーは、マスター ユーザーとも呼ばれます。

サンプル アプリをダウンロードする (省略可能)

Power BI ワークスペースを作成し、このツールを使用してそこにコンテンツをアップロードした場合は、ここで [サンプル アプリケーションのダウンロード] を選択できます。

注意

省略可能のステージをスキップした場合でも、サンプル Power BI アプリをダウンロードできます。 ただし、ダウンロードしたアプリのコードには、登録時に入力されるプロパティがありません。 たとえば、ワークスペースを作成しない場合、サンプル アプリにはワークスペース ID が含まれません。

必ず [概要] ボックス内のすべての情報をコピーしてください。 Power BI 埋め込み環境を使用する準備ができました。

手動登録

Power BI 埋め込み分析セットアップ ツールを使用していない場合は、このセクションの手順を使用して、Microsoft Entra アプリを手動で登録します。 ただし、次のいずれかのソリューションを作成する場合にのみ、次の手順を実行します。

  • 組織向けの埋め込みアプリケーション
  • "サービス プリンシパル" を使用した、顧客向けの埋め込みアプリケーション

Microsoft Entra ID でアプリケーションを登録する方法の詳細については、Microsoft ID プラットフォームにアプリケーションを登録する方法に関するページを参照してください。

  1. Azure portal にサインインします。

  2. ページの右上隅で自分のアカウントを選んで Microsoft Entra テナントを選びます。

  3. [アプリの登録] を選択します。 このオプションが表示されない場合は、検索してください。

  4. [アプリの登録][新しい登録] を選択します。

  5. 以下のフィールドを設定します。

    • [名前] - アプリケーションに名前を付けます。

    • [Supported account type](サポートされているアカウントの種類) - だれがアプリケーションを使用できるかを選択します。

  6. (オプション) [リダイレクト URI] ボックスにダイレクト URL を追加します。

  7. [登録] を選択します。 アプリが登録されると、アプリの概要ページが表示され、そこでアプリケーション ID を取得できます。

その他の質問 Power BI コミュニティで質問してみてください