Microsoft Power BI ワークスペース コレクションの概要

  • [アーティクル]

Power BI ワークスペース コレクション は、アプリケーション開発者が自分のアプリケーションに対話型の Power BI レポートを追加できるようにする Azure サービスです。 Power BI ワークスペース コレクションを既存のアプリケーションと連携させるために、ユーザーのサインイン方法を再設計したり変更したりする必要はありません。

重要

Power BI ワークスペース コレクションは非推奨となっており、2018 年 6 月または契約に定める日までに限り利用できます。 アプリケーションの中断を避けるため、Power BI Embedded への移行をご検討ください。 Power BI Embedded にデータを移行する方法については、Power BI ワークスペース コレクション コンテンツを Power BI Embedded に移行する方法に関するページを参照してください。

Microsoft Power BI ワークスペース コレクションのリソースは、Azure Resource Manager API を使用してプロビジョニングします。 この場合、プロビジョニング対象のリソースは Power BI ワークスペース コレクションです。

Power BI ワークスペース コレクションの一般的なフロー

ワークスペース コレクションの作成

ワークスペース コレクション はトップレベルの Azure リソースであり、アプリケーションに埋め込まれるコンテンツのコンテナーです。 ワークスペース コレクションは、次の 2 つの方法で作成できます。

  • Azure Portal を使用して手動で作成する
  • Azure Resource Manager API を使用してプログラムで作成する

Azure portalを使用してワークスペース コレクションを構築する手順について説明します。

  1. Azure portal: を開いてサインインしますhttps://portal.azure.com。

  2. 上のパネルの [+ 新規] を選択します。

    Azure Portal の [+ 新規]

  3. [データ + 分析] で [Power BI ワークスペース コレクション] を選択します。

  4. Power BI ワークスペース コレクションのサブスクリプションを既にお持ちの場合には、最初のメッセージの下部で [ワークスペース コレクションを作成する] を選択します。

  5. [ワークスペース コレクション] に、必要な情報を入力します。

    ワークスペース コレクションの作成

  6. ［作成］ を選択します

ワークスペース コレクションのプロビジョニングにはわずかに時間がかかります。 処理が完了すると、ワークスペース コレクションが表示されます。

Azure Portal でのワークスペース コレクション

作成結果には、ワークスペースを作成し、そこにコンテンツをデプロイする API を呼び出すために必要な情報が含まれています。

Power BI API のアクセス キーの表示

Power BI REST API を呼び出すために必要な最も重要な情報の 1 つが アクセス キーです。 アクセス キーは、API 要求の認証に使用される アプリ トークン を生成するために使用します。 アクセス キーを表示するには、[設定] の [アクセス キー] をクリックします。 アプリ トークンの詳細については、「Authenticating and authorizing with Power BI Workspace Collections (Power BI ワークスペース コレクションでの認証と承認)」をご覧ください。

Azure Portal のワークスペース コレクション設定内のアクセス キー

2 つのキーがあることに注意してください。

アクセス キー内の 2 つのキー

これらのキーをコピーし、アプリケーションに安全に格納します。 これらのキーを使用するとワークスペース コレクションのすべてのコンテンツにアクセスできるため、これらのキーをパスワードと同じように慎重に扱うことが重要です。

キーは 2 つ表示されますが、一度に使用するキーは 1 つのみです。 2 つ目のキーは、サービスへのアクセスを中断することなく定期的にキーを再生成できるようにするために提供されます。

アプリケーション用の Power BI のインスタンスと アクセス キーが準備できたら、レポートをアプリにインポートできます。 レポートのインポート方法を説明する前に、次のセクションで、アプリに埋め込む Power BI データセットとレポートの作成について説明します。

ワークスペースの使用

ワークスペース コレクションを作成したら、レポートとデータセットを格納するワークスペースを作成する必要があります。 ワークスペースを作成するには、Post Workspace REST API を使用する必要があります。

Power BI Desktop を使用した、アプリに埋め込む Power BI データセットとレポートの作成

アプリケーション用の Power BI インスタンスを作成し、アクセス キーの準備ができたら、埋め込む Power BI データセットとレポートを作成する必要があります。 データセットとレポートは、Power BI Desktopを使用して作成できます。 Power BI Desktop は無料でダウンロードできます。 または、 Retail Analysis Sample PBIXをダウンロードしてすぐに開始できます。

Note

Power BI Desktop の使用方法の詳細については、「Power BI Desktop の概要」を参照してください。

Power BI Desktop でデータ ソースに接続する場合、データのコピーを Power BI Desktop にインポートする方法と、DirectQuery を使ってデータ ソースに直接接続する方法があります。

インポートする方法と DirectQuery を使う方法の違いを次に示します。

インポート DirectQuery
テーブル、列、 データ が Power BI Desktopにインポートまたはコピーされます。 視覚化の際、 Power BI Desktop はデータのコピーを照会します。 基になるデータに加えられた変更を表示するには、更新する (現在の完全なデータセットをもう一度インポートする) 必要があります。 テーブルと列のみが Power BI Desktop にインポートまたはコピーされます。 視覚化の際、Power BI Desktop は基になるデータ ソースを照会します。そのため、常に最新のデータが表示されます。

データ ソースに接続する方法の詳細については、「 データ ソースへの接続」を参照してください。

Power BI Desktop で作業を保存すると、PBIX ファイルが作成されます。 このファイルには、レポートが含まれます。 さらに、データをインポートした場合は、完全なデータセットが PBIX に含まれます。また、DirectQuery を使用した場合は、データセット スキーマのみが PBIX に含まれます。 Power BI インポート API を使用して、PBIX をワークスペースにプログラムでデプロイします。

Note

Power BI ワークスペース コレクションには、データセットが指し示すサーバーとデータベースを変更したり、データベースへの接続にデータセットが使用するサービス アカウント資格情報を設定したりするための追加の API が用意されています。 「Post SetAllConnections」および「Patch Gateway Datasource」を参照してください。

API を使用した Power BI データセットとレポートの作成

データセット

REST API を使用して Power BI ワークスペース コレクション内にデータセットを作成できます。 次に、そのデータセットにデータをプッシュできます。 これを使用すると、Power BI Desktop を使用せずにデータを処理できます。 詳細については、「Post Datasets (データセットのポスト)」を参照してください。

Reports

JavaScript API を使用して、アプリケーションで直接データセットからレポートを作成できます。 詳細については、「Create a new report from a dataset in Power BI Embedded (Power BI ワークスペース コレクションにおけるデータセットからの新しいレポートの作成)」を参照してください。

参照

Get started with Microsoft Power BI Embedded sample (Microsoft Power BI Embedded のサンプルの使用)
Power BI ワークスペース コレクションでの認証と承認
レポートの埋め込み
Power BI ワークスペース コレクションにおけるデータセットからの新しいレポートの作成レポートの保存
Power BI Desktop
JavaScript 埋め込みサンプル

その他の質問 Power BI コミュニティを利用してください。