メインコンテンツまでスキップ

Power BIを外部ナレッジソースとして接続する

備考

ベータ版

この機能はベータ版です。それを使用するには、アカウント管理者がアカウントコンソールの プレビュー ページから 外部知識 をオンにする必要があります。アカウントレベルのプレビューを管理するを参照してください。

DatabricksはPower BIセマンティックモデルからメタデータを取得できるため、Genieは回答時にPower BIのメジャー定義を使用できます。Power BIは、外部ナレッジソースです。

始める前に​

Power BIを外部ナレッジソースとして設定するには、Power BIとDatabricksの両方が必要です。セットアップの各部分には、異なる権限が必要です。

重要

外部知識 プレビューがオンになっている間、Databricksは、OAuth Machine to Machineを使用してPower BIタスクによって使用されるUnity Catalog内のすべてのPower BI接続(既存の接続やタスクを含む)を通じてメタデータを取り込みます。そのメタデータから作成されたオントロジー スニペットは、Power BIでのアクセス権に関係なく、Databricksアカウントのすべてのユーザーが利用できます。Databricksが取り込むものを制限するには、各接続のService Principalを、含めるPower BIワークスペースにのみ追加します。

Power BIの要件​

Power BI接続のService Principalは、メタデータを取得する各Power BIワークスペースに直接追加する必要があり、少なくとも コントリビューター ロールが必要です。他のワークスペースに追加する必要はありません。「ユーザーにワークスペースへのアクセス権を付与する」を参照してください。

Databricksの要件​

Power BI接続を作成してメタデータをプルするには、以下が必要です。

接続を作成してPower BIタスクをランする​

OAuth Machine to MachineでPower BI接続を使用するPower BIタスクが既に存在する場合は、新しい接続またはタスクを作成する必要はありません。 外部知識 プレビューがオンになった後にタスクが次に実行されたとき、Databricksはメタデータの取り込みを開始します。接続のService PrincipalがPower BIの要件を満たしていることを確認します。

それ以外の場合は、OAuthマシン間を使用するUnity CatalogにPower BI接続を作成し、その接続を使用してPower BIタスクを実行します:

  1. Microsoft EntraのService Principalの認証情報を保存するUnity Catalog接続を作成します。オーケストレーションのためにUnity CatalogでPower BI接続を作成するのステップに従い、以下を実行します:

    • 認証タイプ で、 OAuthによるマシン間通信 を選択します。
    • 資格情報には、Microsoft EntraからのクライアントID、クライアントシークレット、テナントIDを入力します。
  2. ジョブにPower BIタスクを追加し、そのタスクの接続を選択して、ジョブをランします。Power BIタスクを構成するをご覧ください。

タスクが初めて実行されるとき、Databricksは接続を通じてメタデータの取得を起動します。GenieがPower BIのメタデータから作成されたスニペットを使用して質問に回答すると、そのスニペットが回答の引用に表示されます。

Databricks が Power BI メタデータを取得する仕組み​

Databricksは、Unity CatalogのPower BI接続を介してPower BIからメタデータを読み取ります。以下のセクションでは、Databricksが読み込むメタデータ、使用するAPIと接続、およびそれから作成されたオントロジースニペットのデータアクセスがどのように機能するかを説明します。

Databricksが取り込むメタデータ​

Databricksは、Power BIワークスペースから次のメタデータを取得します。

  • セマンティックモデル : テーブル、カラム、データ型、ストレージモード。
  • メジャーおよびクエリーロジック : DAX メジャー数式、計算列、および Power クエリー (M) 式。
  • モデル構成 : セマンティックモデルダイアグラムのLayout。

オントロジー スニペットには、以下は含まれません。

  • 行レベルセキュリティ (RLS) ロールの定義とメンバー。
  • Power BIアセット所有者のEメールアドレス。

API、スコープ、および更新​

Databricksは、Unity CatalogのPower BI接続を使用して、Fabric Get Semantic Model Definition REST APIで各セマンティックモデルの定義を読み取ります。

各接続に対して、Databricksは接続のService PrincipalがアクセスできるPower BIワークスペースからメタデータを取得します。

Databricksは7日ごとにこのメタデータを更新します。メタデータはワークスペースのリージョンに留まり、Unity Catalogテーブルとしては表示されません。

オントロジースニペットとデータアクセス​

オントロジースニペットには、テーブル内のデータではなく、メジャーの定義やリレーションシップなどのメタデータが含まれています。そのデータへのアクセスは、引き続き Unity Catalog の権限によって管理されます。スニペットが参照するUnity Catalogテーブルへのアクセス権を持たないユーザーは、Genieを通じてそれらのテーブルをクエリーすることはできません。

Power BIアセットが削除された場合、または接続のService Principalがそのアセットにアクセスできなくなった場合、Genieはそのアセットから作成されたスニペットの使用を停止します。

制限​

  • Databricksは、Unity Catalogオブジェクトからデータを読み取るPower BIセマンティックモデルに対してのみ、オントロジスニペットを作成します。
  • Databricksは、レポートビューなどの使用アクティビティをキャプチャしません。
  • オントロジーのスニペットを特定のユーザーやグループに制限することはできません。提供を停止するには、アカウント管理者が 外部知識 プレビューをオフにします。

その他のリソース​