Power BI レポートで OneLake イメージとマップ ファイルを使用する

適用対象:✅Power BI デスクトップとPower BI サービス

認証されたファイルを Power BI レポートで使用する場合は、イメージ ファイルと図形マップ ファイルを Microsoft OneLake に格納します。 Power BIでは、各レポート ビューアーのMicrosoft Entra ID を使用して OneLake ファイルを読み込みます。 ファイルには匿名アクセスは必要ありませんが、各ビューアーには読み取りアクセス許可が必要です。

この記事では、レイクハウスにファイルをアップロードし、ファイルの URL をコピーし、レポートで URL を使用する方法について説明します。

Prerequisites

  • レイクハウスを作成してファイルをアップロードできるMicrosoft Fabric ワークスペース。
  • Power BI Desktop または Power BI サービスでレポートを編集するアクセス許可。
  • ビューアー アクセス、ワークスペース 管理者 または メンバー ロール、またはこれらのロールのいずれかを持つユーザーからのサポートを構成するには。

OneLake に画像をアップロードする

Lakehouse には、イメージ やその他の非構造化ファイルを OneLake に格納するためのファイル領域が用意されています。

  1. Fabric ワークスペースに lakehouse を作成します。
  2. レイクハウスを開き、Lakehouse エクスプローラーで [ファイル ] を展開します。
  3. [ファイル] またはフォルダーのコンテキスト メニューを開き、[ファイルのアップロード>アップロード] を選択します。
  4. イメージ ファイルを選択し、[ アップロード] を選択します。

OneLake ファイル エクスプローラーを使用して画像をアップロードすることもできます。 ファイル エクスプローラーで、ローカル フォルダーから lakehouse Files フォルダーにファイルWindowsドラッグします。

OneLake ファイルの URL をコピーする

レポートで使用する各画像の URL をコピーします。

  1. Lakehouse エクスプローラーで、[ ファイル] の下にあるイメージを見つけます。
  2. イメージ ファイルのコンテキスト メニューを開き、[ プロパティ] を選択します。
  3. [プロパティ] ウィンドウで、URL 値をコピーします。

URL は OneLake HTTPS 形式を使用します。 例えば次が挙げられます。

https://onelake.dfs.fabric.microsoft.com/<workspace-guid>/<item-guid>/Files/<path>/<file-name>

OneLake パスの詳細については、「 OneLake URI 構文」を参照してください。

レポートに URL を追加する

URL を追加する方法は、レポートで 1 つの画像を使用するか、データに基づいて画像を選択するかによって異なります。

[書式] ウィンドウに URL を入力する

ビジュアルに 1 つの画像が表示される場合は、このメソッドを使用します。

  1. 画像やカードのビジュアルなど、イメージ URL をサポートするビジュアルを選択します。
  2. [ 表示形式 ] ウィンドウで、イメージの設定を開きます。
  3. イメージ ソースの場合は、[ URL の入力] を選択します。
  4. OneLake ファイルの URL を貼り付けます。

イメージ設定の場所と名前は、ビジュアルによって異なります。 例については、「 イメージ ビジュアルの作成」を参照してください。

イメージ URL 列を使用する

各行またはカテゴリで異なる画像を表示できる場合は、列を使用します。

  1. ソース データの列に OneLake ファイルの URL を追加します。
  2. Power BI デスクトップで、テーブル ビューを開き、列を選択します。
  3. [ 列ツール ] タブで、[ データ カテゴリ ] を [イメージ URL] に設定します。
  4. データからの画像をサポートするビジュアルに列を追加します。

詳細については、「Power BI デスクトップでデータ カテゴリを指定する」および「テーブル、マトリックス、またはスライサーに画像を表示する」を参照してください。

画像URL測定を使用する

画像 URL がレポートのフィルター コンテキストに応答する必要がある場合は、データ分析式 (DAX) メジャーを使用します。 次の例では、OneLake ファイルの URL が 1 つ返されます。

Image URL = "https://onelake.dfs.fabric.microsoft.com/<workspace-guid>/<item-guid>/Files/<path>/<file-name>"
  1. OneLake ファイルの URL を返すメジャーを作成します。
  2. メジャーを選択し、次にメジャー ツールタブを開きます。
  3. データ カテゴリをイメージ URL に設定します。
  4. ビジュアルにメジャーを追加するか、画像設定のフィールドとして使用します。

メジャーの作成の詳細については、「Power BI Desktop でデータ分析用のメジャーを作成する」を参照してください。

ビジュアルで OneLake イメージを使用する

OneLake イメージ URL は、次のレポート シナリオで使用できます。

ビジュアルがイメージ URL のサポートを引き続き追加するため、他のシナリオが存在する可能性があります。 画像 URL を受け入れるかどうかを確認するために使用するビジュアルのドキュメントを確認します。

レポート ビューアーにアクセス権を付与する

レポート ビューアーは、レポートへのアクセス権と OneLake 内の画像ファイルへの読み取りアクセス権がある場合にのみ、OneLake イメージを表示できます。 レポートまたはセマンティック モデルへのアクセスは、ファイルへのアクセス権を自動的に付与しません。

各ビューアーに、レイクハウスアイテムに対する 読み取り アクセス許可を付与します。 次に、イメージを含むフォルダーに対する OneLake セキュリティ の読み取り アクセス許可を付与します。 または、lakehouse アイテムに ReadAll 権限を付与すると、Tables と Files 配下のすべてのコンテンツにアクセスできます。 最小特権の原則に従い、閲覧者が必要とするフォルダーにのみアクセス権を付与します。

詳細については、 OneLake セキュリティ アクセス制御モデル と OneLake セキュリティのベスト プラクティスに関するページを参照してください。

Considerations

  • Power BIでは、BMP、JPG、JPEG、GIF、PNG、SVG の画像 URL がサポートされます。 Azure Mapsマーカー画像には SVG ファイルが必要です。
  • ファイルを移動または名前変更すると、そのパスが変更されます。 いずれかの変更後に、レポートまたはセマンティック モデルの URL を更新します。
  • 画像が大きいと、レポート ページの表示に必要な時間が長くなる可能性があります。 ビジュアルに適した画像のサイズとファイル サイズを使用します。
  • OneLake URL には認証が必要です。 ファイルを読み取るアクセス許可を持たないレポート ビューアーには、その画像が表示されません。
  • Web への発行やその他の匿名埋め込みシナリオでは、OneLake ファイル URL はサポートされません。これらのシナリオでは OneLake に対して認証できないためです。
  • デプロイ パイプラインでは、OneLake イメージの URL は書き換えられません。 新しいステージにデプロイされたレポートは、元のワークスペース内のファイルを引き続き参照します。 ターゲット ステージでイメージをポイントするには、パラメーターを使用するか、デプロイ後に URL を更新します。

関連するコンテンツ

  • 最終更新: