Databricks から Power BI サービスに発行する
このページでは、Databricks から Microsoft Power BI サービスにデータを発行する方法について説明します。Microsoft Power BI サービスは、ユーザーがデータに接続し、視覚化し、分析できるようにするクラウドベースのビジネス アナリティクス プラットフォームです。
DatabricksをデータPower BIソースとして統合すると、 サービス、スケーラブルなデータ処理とパフォーマンスDatabricksすべてのユーザーに。
Power BI Desktop を Databricks に接続する場合は、「 Power BI Desktop を Databricks に接続する」を参照してください。
Power BI 用の Databricks コネクタは、 Arrow Database Connectivity (ADBC) ドライバーをサポートしています。詳しくは こちらをご覧ください。
必要条件
-
データは Unity Catalogで、コンピュートが Unity Catalog 有効になっている必要があります。 Hive metastore は現在サポートされていません。
-
Power BI Premium ライセンス (Premium 容量、Premium Per User (PPU)、または Microsoft Fabric 容量) が必要です。
-
Power BI 容量で XMLA エンドポイント の 読み取り 書き込みを有効にする必要があります。手順については、この リンク をたどってください。
-
マシン間 (M2M) OAuthを使用して認証する場合は、 Databricks サービスプリンシパル が設定されていることを確認してください。 Power BIの Databricks でサービスプリンシパルを設定するを参照してください。
-
ユーザーが公開後に Power BI サービスでセマンティック モデルを編集する場合は、ワークスペース設定で ユーザーがデータ モデルを編集できる Power BI サービス (プレビュー) を有効にする必要があります。 XMLA エンドポイントを使用して接続を確立することで、 表形式エディター を使用してセマンティック モデルを編集することもできます。
-
Power BI ワークスペースでプライベート リンクを使用する場合は、Power BI でデータセットのデータソース資格情報を手動で更新する必要があります。
Databricks テーブルを Power BI セマンティック モデルに発行する
Databricks を データソースとして Power BI Online で使用する場合、Databricks UI から直接テーブルまたはスキーマからPower BIセマンティックモデルを作成できます。
-
カタログ エクスプローラーを開くには、Databricks ワークスペースにサインインし、サイドバーの
カタログ をクリックします。
-
右上のドロップダウン・リストからコンピュート・リソースを選択します。
-
カタログを開き、公開するスキーマまたはテーブルを選択します。Hive metastoreやサンプルカタログから選択しないでください。
-
スキーマ右上の [ BI ツールと併用 ] をクリックするか、テーブル右上の [ ダッシュボードで開く ] をクリックします。
-
[Power BI ワークスペースに発行 ] を選択します。
-
パートナーに接続 ダイアログで、認証するために Microsoft Entra ID に接続する をクリックします。
-
Databricks、登録済みの Entra ID アプリ Databricks データセット Publishing Integration に次の権限を付与する必要があります。
-
Content.Create
-
Dataset.ReadWrite.All
-
Workspace.Read.All
詳細については、「Microsoft Entra のアクセス許可」を参照してください。
-
-
これらのアクセス許可を受け入れることができない場合は、組織でこれらのアクセス許可に対して Entra 管理者の承認が必要になる場合があります。手順については、「 管理者の同意要求を確認する 」を参照してください。
-
"管理者の承認が必要です" というメッセージが表示された場合は、続行する前に、Power BI グローバル管理者が管理者の同意要求を有効にする必要がある場合があります。管理者 の同意が無効になっている場合の権限の付与を参照してください。
-
-
Power BI ワークスペース フィールドで、ワークスペースPower BIを選択します。
-
データセットモード で、DirectQuery または Import を選択します。
-
Power BIの認証方法 で、 OAuth または PAT (パーソナル アクセス トークン) を選択します。
Databricks では、きめ細かなアクセス制御とユーザー レベルの監査が可能になるため、OAuth の使用を推奨しています。OAuth資格情報は、データ ソース資格情報の 下の Power BI セマンティック モデル設定 ページで構成する必要がある場合があります。[Personal アクセストークン (PAT)] を選択すると、 Power BI がセマンティック モデルにアクセスできるように、PAT がユーザーに代わって作成されます。
M2M OAuth を使用して認証する場合は、発行後に Power BI サービスでこれを構成できます。「M2M OAuth の設定」を参照してください。
-
データセット名 で、 新しいデータ セットとして発行 または 既存のデータ セットを使用する を選択します。
既存のデータセットを使用する を選択すると、次の条件が当てはまります。
- セマンティック モデルが存在する場合、上書きされません。更新は、特定のスキーマに新しいレコードを追加するだけです。
- 選択したテーブルが既存のセマンティック モデルの一部でない場合は、追加されます。
- テーブルが既にセマンティック モデルにあり、前回の更新後に新しい列が追加された場合、それらの列は自動的に追加されます。
- 新しいテーブルに別のストレージモデルを選択して、 複合セマンティックモデルを作成できます。
既存のデータ接続を維持しながら更新する既存のセマンティックモデルがある場合は、[ 既存のデータセットを使用する] を選択します。新しいセマンティックモデルを使用して新しいセマンティックモデルを作成する場合は、[ 新しいデータセットとして公開] を選択します。
- セマンティック モデルが存在する場合、上書きされません。更新は、特定のスキーマに新しいレコードを追加するだけです。
-
Power BI に公開 をクリックします。
-
セマンティック モデルが発行されるまでに 10 秒から 20 秒かかる場合があります。発行が完了したら、 [Power BI を開く ] をクリックして、Power BI セマンティック モデルを新しいタブで開きます。
機能と注意事項
- 複数のテーブルを含むスキーマをパブリッシュすると、列を持つすべてのテーブルがパブリッシュされます。列のないテーブルは公開されません。
- Databricks のテーブルの列に対するコメントは、Power BI の対応する列の説明にコピーされます。
- 外部キーのリレーションシップは、公開されたデータセットに保持されます。ただし、Power BI では、任意の 2 つのテーブル間のアクティブなリレーションシップ パスが 1 つしかサポートされません。Databricks のスキーマに複数のパスが存在する場合、Power BI の対応するリレーションシップの一部は非アクティブに設定されます。Power BI のデータ モデル ビューでアクティブまたは非アクティブなリレーションシップは、後で変更できます。
- OAuthまたはオンプレミス データ ゲートウェイを使用する場合は、Power BI データセット設定ページの [データソース 資格情報] で資格情報を構成する必要がある場合があります。
- 現在、ユーザーはホーム テナントの Power BI ワークスペースにのみ直接発行できます。ゲスト ユーザーであるテナントでの発行はサポートされていません。
管理者の同意が無効になっている場合のアクセス許可の付与
管理者の同意が無効になっている場合、ユーザーはアクセス許可を必要とするアプリケーションの承認を要求できません。これは、ユーザーの同意がブロックされているか、Microsoft Entra 管理センターで検証済みの発行元に制限されており、管理者の同意要求が許可されていない場合に発生する可能性があります。
ユーザーが Power BI サービスに発行するアクセス許可を要求できるようにするには、同意要求を有効にして承認するには、 グローバル管理者 または クラウド アプリケーション管理者 のいずれかである必要があります。
ステップ 1: 管理者の同意リクエストを有効にする
グローバル管理者またはクラウド アプリケーション管理者は、最初に管理者の同意要求を有効にする必要があります。
- Microsoft Entra 管理センターで、 [同意とアクセス許可] に移動します。
- サイドバーから [管理者の同意設定 ] をクリックします。
- 管理者の同意要求を はい に切り替え ます。
- (オプション)同意要求の評価を支援できるレビュー担当者を指定するには、[ レビュー担当者] で [ユーザーの追加 ] を選択します。レビュー担当者は要求を評価できますが、最終的な管理者の同意を付与できるのはグローバル管理者のみであることに注意してください。
- 同意要求の有効期限が切れる までの期間を設定するには、同意要求の有効期限が切れるまで有効になります。
- ユーザーは、Power BI サービスに対する同意要求を送信できるようになりました。
ステップ 2: ユーザーからの同意要求を承認する
ユーザーが同意要求を送信した後、グローバル管理者またはクラウド アプリケーション管理者が要求を承認する必要があります。
- Microsoft Entra 管理センターで、サイドバーの [管理者の同意要求 ] をクリックします。
- Databricks データセット発行統合 要求を選択します。
- [ 権限と同意の確認 ] をクリックします。
- Microsoft Entra ID でサインインし、 [同意する] をクリックします。
Power BI へのアクセスを要求するユーザーは、Power BI サービスに発行できるようになりました。
M2M OAuth の設定
Databricks から Power BI サービスに発行した後、Power BI サービスで M2M OAuth を構成できます。サービスプリンシパルが設定されていることを確認してください Databricks。 Power BIの Databricks でサービスプリンシパルを設定するを参照してください。
M2M OAuth は、セマンティックモデルまたはサービスゲートウェイから設定できます。
M2M OAuth のセマンティック モデルを使用する
セマンティック モデルを使用して、Power BI サービスで M2M OAuth の Databricks 接続を構成します。セマンティック モデルの詳細については、「 Power BI サービスのセマンティック モデル」を参照してください。
資格情報を構成するには:
- Power BI で、セマンティック モデルを含むワークスペースに移動します。
- [その他のオプション] (水平方向のケバブ メニュー) > [設定] をクリックします。
- [ データソースの資格情報 ] に移動し、[ 資格情報の編集] をクリックします。
- [認証方法] で、[ 基本] を選択します。
- [ ユーザー名 ] に、サービスプリンシパル アプリケーション ID を入力します。
- [パスワード] に、サービスプリンシパル シークレットを入力します。
- データソースに適切なプライバシーレベル設定を選択します。
- SSO を有効にする場合は、最後のオプションを有効にします。
- [サインイン] をクリックします。
M2M OAuth のサービスゲートウェイの使用
Power BI VNet またはオンプレミスのデータ ゲートウェイから、Power BI サービス上の M2M OAuth の Databricks 接続を構成できます。オンプレミス ゲートウェイの Databricks クライアント資格情報には、Power BI ゲートウェイ v3000.270.10 以降が必要です。Power BI ゲートウェイの詳細については、 Microsoft の公式サイトを参照してください。
Power BI は、その REST APIsで VNet データ ゲートウェイを完全にはサポートしていません。 したがって、UI で Databricks クライアント資格情報 を使用するには、データソース接続を手動で更新する必要があります。
資格情報を構成するには:
-
Power BI で、右上の歯車アイコンをクリックして設定にアクセスします。
-
[接続とゲートウェイの管理] をクリックします。
-
[ + 新規 ] をクリックして、新しい接続を作成します。
-
[ オンプレミス ] または [仮想ネットワーク ] を選択します。必要な資格情報は、両方のゲートウェイで同じです。
-
[ゲートウェイ クラスター名] で、適切なゲートウェイを選択します。
-
[接続名] に、接続名を入力します。
-
[接続の種類] で、 [ Azure Databricks ] を選択します。
-
[Server ホスト名 ] に、Databricks SQLウェアハウス ホスト名を入力します。
-
[HTTP パス] に、ウェアハウスSQLHTTP パスを入力します。
-
[認証] で、認証資格情報を指定します。
- [認証方法] で、 [Databricks クライアント資格情報 ] を選択します。
- [ Databricks クライアント ID ] に、サービスプリンシパル クライアント ID を入力します。
- [ Databricks クライアント シークレット ] に、サービスプリンシパル クライアント シークレットを入力します。
-
[プライバシー レベル] で、[ 組織] を選択します。
-
作成 をクリックします。
トラブルシューティング
エラー | 注 |
---|---|
Power BI への発行を初めて起動するときの "承認が必要" | このメッセージが表示された場合は、この統合機能にアクセス許可を付与する前に、Entra 管理者の承認が必要です。Entra 管理者に連絡して、リクエストを承認します。手順については、この リンク をたどってください。 |
PowerBINotLicensedException | Power BI Premium ライセンス (Premium 容量、Premium Per User (PPU)、または Microsoft Fabric 容量) があることを確認します。 |
このデータセットをデプロイできませんでした。容量管理者に問い合わせて、Power BI Premium 容量の容量設定で XMLA 読み取り/書き込みサポートが有効になっていることを確認してから、もう一度やり直してください。追加情報については、製品ドキュメントの「XMLA読み取り/書き込みサポート」を参照してください。 | Power BI 容量管理者に連絡して、容量設定の [XMLA エンドポイント ] で 読み取り機能と書き込み 機能を有効にします。手順については、この リンク をたどってください。 |
XMLA エンドポイント機能は無効になっています。この機能を有効にするには、PowerBI.com で [Excel で分析] 機能を有効にします。 | Power BI 容量管理者に連絡して、容量設定の [XMLA エンドポイント ] で 読み取り機能と書き込み 機能を有効にします。手順については、この リンク をたどってください。 |
CapacityNotActive | Fabric または Power BI の容量が停止する可能性があります。 容量管理者に連絡して、容量の状態を確認してください。 |
' | セマンティック モデルを作成する権限があることを確認します。次に、Power BI に発行して、バージョン番号をインクリメントしてセマンティック モデルを発行することを再試行します。 |
Direct Lake モードを同じモデル内の他のストレージモードと一緒に使用することはできません。複合モデルは、Direct Lake モードをサポートしていません。サポートされていないテーブルを削除するか、Direct Lake モードに切り替えます。 | Power BI に発行すると、インポート モードまたは DirectQuery モードでセマンティック モデルが作成されるため、Direct Lake モードを使用する既存のデータセットへの発行には使用できません。詳細については、この リンク をたどってください。 |
' | Premium ライセンス モードで Power BI ワークスペースに発行していることを確認します。Pro ライセンス モードのワークスペースに公開することはできません。 |
' | Power BI ワークスペースに閲覧者ロールがある場合があります。セマンティック モデルを作成する権限があるかどうかを確認します。詳細については、この リンク をたどってください 情報. |
「データソースの資格情報を更新できませんでした([Microsoft][thriftextension] (14) HTTP接続中にサーバーからの予期しない応答:未承認/禁止エラー応答が返されましたが、トークンの有効期限が切れたメッセージは受信されませんでした。」 Power BIでデータソースの認証情報を編集する場合にこちらのエラーが発生する。 | Databricks ワークスペースがパブリックにアクセスできるかどうかを確認します。ワークスペースで Private Link または IP アクセス リストを使用している場合は、Power BI オンプレミス ゲートウェイを構成する必要がある場合があります。 |