ジョブ用Power BIタスク

備考

プレビュー

Power BIタスク機能はパブリックプレビューです。

DatabricksワークスペースからMicrosoft Power BI onlineに手動で公開できますが、Power BIタスクを使用してPower BIセマンティックモデルを自動的に調整できます。

Databricks UI で Power BI に公開することについて詳しくは、DatabricksからPower BIサービスに公開するを参照してください。

要件

• Power BIに手動で公開する場合と同様の要件に従う必要があります。詳細については、DatabricksからPower BI Onlineに公開するを参照してください。
• Power BI 接続を持っているか、作成しておく必要があります。オーケストレーションのために Unity Catalog で Power BI 接続を作成するを参照してください。
• その接続の Unity Catalog USE CONNECTION 権限と、使用するテーブルとウェアハウスにアクセスするための権限SQL持っている必要があります。「Lakeflowジョブの ID、アクセス許可、および特権の管理」を参照してください。

Power BIタスクを構成する

Power BI接続が設定済みであれば、その接続を使用して公開を自動化するタスクを作成できます。

注記

ジョブUIは、その他の設定に基づいてオプションを動的に表示します。

Power BIタスクを構成するフローを開始するには:

1. タスクを追加したいジョブのジョブUIで、**タスク**タブに移動します。
2. タスクを追加をクリックします。
3. 「**タスク名**」を入力してください。
4. 種類 ドロップダウン メニューで、 Power BI を選択します。
5. タスクのプロパティを構成します（プロパティとその使用方法については、以下の表を参照してください）。
6. （オプション）リトライ、実行時間またはストリーミングバックログのしきい値、あるいは通知を構成するには、詳細タスク設定を参照してください。
7. タスクの保存 をクリックします。

注記

Databricks では、 Databricks サービスプリンシパルをタスクを 実行するIDとして 設定することをお勧めします。 ベスト・プラクティスについては、 ジョブ・ガバナンスのベスト・プラクティスを参照してください。サービスプリンシパルは、タスクで使用される Databricks テーブル、スキーマ、 Power BI 接続、および SQLウェアハウスにアクセスするために必要な権限を必要とします。

タスクを編集するときは、現在のユーザーの資格情報が使用されますが、タスクが実行されるときは、 IDとしての実行 が使用されます。 ID には、タスクを実行するための適切な権限が必要です。

Power BIタスクプロパティ	説明
SQLウェアハウス	セマンティックモデルの**インポート**モードでの更新、または**DirectQuery**モードでのクエリを処理するSQLウェアハウス。 Power BI タスクにはSQLウェアハウスが必要です。汎用コンピュートはサポートされていません。
Power BI接続	このタスクのPower BI接続。タスクはこの接続を使用してPower BIワークスペースとセマンティックモデルを取得し、Power BIに発行します。詳細については、オーケストレーションのためにUnity CatalogでPower BI接続を作成するを参照してください。
Power BIワークスペース	セマンティックモデルが公開されているPower BIワークスペース。
Power BIセマンティックモデル	公開するPower BIセマンティックモデル既存のモデルを選択するか、新しいモデル名を入力して [ 新しいセマンティック モデル <name> を公開 ] をクリックします。
既存のモデルを上書き	デフォルトでは、メタデータの更新は既存のモデルにのみ追加されます。このチェックボックスをオンにすると、タスクが実行されたときに、すべてのメタデータとデータの更新がPower BIセマンティックモデルに伝播されます。
Power BIクエリーモード	公開されるテーブルのデフォルトのクエリ モード DirectQuery が選択されている場合、 テーブルクエリモードの構成 プロパティを使用して個々のテーブルでクエリモードを設定することもできます。次のいずれかの値: Import モデルのデータは Power BI にキャッシュされます。データを更新するには、ユーザーはモデルを使用する前にモデルを更新する必要があり、モデルによって SQLウェアハウスにクエリが実行され、データがロードされます。 **DirectQuery** データはPower BIには格納されません。ユーザーがダッシュボードを作成またはロードすると、SQLウェアハウスに対して最新のデータがクエリされます。 Power BIのクエリモードは、Power BIのストレージモードとも呼ばれます。クエリモードに関する詳細情報については、Power BIサービスにおけるセマンティックモデルモードを参照してください。
更新するテーブル	セマンティックモデルのソーステーブルとスキーマ。このプロパティのスキーマを選択すると、タスクを実行したときに、その時点でのスキーマ配下のすべてのテーブルが更新に使用されます。タスクは、新しいテーブル、カラム、コメント、主キー/外部キー関係を更新します。
認証方法	セマンティック モデルが選択した SQLウェアハウスに対して認証する方法を定義します。OAuth を使用する場合、最初のタスクの実行後に Power BI で資格情報を構成する必要がある場合があります。PAT を使用すると、**IDとして実行** するための PATが生成されて埋め込まれます。
テーブルクエリーモードを設定する	Power BI クエリ モード として DirectQuery が選択されている場合は、必要に応じて、 デュアル ストレージ モードを使用するように個々のテーブルを設定できます。 デュアル ストレージ モードに設定されたテーブルは、クエリのコンテキストに応じて、 Import モードまたは DirectQuery モードとして機能できます。 詳細については、Power BIサービスにおけるセマンティックモデルモードを参照してください。
更新後にリフレッシュしてください。	このオプションは、クエリ モードとして Import が選択されている場合に使用できます。デフォルトでは、モデルのメタデータのみが更新されますが、このチェックボックスをオンにすると、データ更新もトリガーされます(これにより、 SQLウェアハウスがクエリされます)。この更新は、Power BI の更新履歴で確認できます。

Power BIタスクプロパティ	説明
SQLウェアハウス	セマンティックモデルの**インポート**モードでの更新、または**DirectQuery**モードでのクエリを処理するSQLウェアハウス。 Power BI タスクにはSQLウェアハウスが必要です。汎用コンピュートはサポートされていません。
Power BI接続	このタスクのPower BI接続。タスクはこの接続を使用してPower BIワークスペースとセマンティックモデルを取得し、Power BIに発行します。詳細については、オーケストレーションのためにUnity CatalogでPower BI接続を作成するを参照してください。
Power BIワークスペース	セマンティックモデルが公開されているPower BIワークスペース。
Power BIセマンティックモデル	公開するPower BIセマンティックモデル既存のモデルを選択するか、新しいモデル名を入力して [ 新しいセマンティック モデル <name> を公開 ] をクリックします。
既存のモデルを上書き	デフォルトでは、メタデータの更新は既存のモデルにのみ追加されます。このチェックボックスをオンにすると、タスクが実行されたときに、すべてのメタデータとデータの更新がPower BIセマンティックモデルに伝播されます。
Power BIクエリーモード	公開されるテーブルのデフォルトのクエリ モード DirectQuery が選択されている場合、 テーブルクエリモードの構成 プロパティを使用して個々のテーブルでクエリモードを設定することもできます。次のいずれかの値: Import モデルのデータは Power BI にキャッシュされます。データを更新するには、ユーザーはモデルを使用する前にモデルを更新する必要があり、モデルによって SQLウェアハウスにクエリが実行され、データがロードされます。 **DirectQuery** データはPower BIには格納されません。ユーザーがダッシュボードを作成またはロードすると、SQLウェアハウスに対して最新のデータがクエリされます。 Power BIのクエリモードは、Power BIのストレージモードとも呼ばれます。クエリモードに関する詳細情報については、Power BIサービスにおけるセマンティックモデルモードを参照してください。
更新するテーブル	セマンティックモデルのソーステーブルとスキーマ。このプロパティのスキーマを選択すると、タスクを実行したときに、その時点でのスキーマ配下のすべてのテーブルが更新に使用されます。タスクは、新しいテーブル、カラム、コメント、主キー/外部キー関係を更新します。
認証方法	セマンティック モデルが選択した SQLウェアハウスに対して認証する方法を定義します。OAuth を使用する場合、最初のタスクの実行後に Power BI で資格情報を構成する必要がある場合があります。PAT を使用すると、**IDとして実行** するための PATが生成されて埋め込まれます。
テーブルクエリーモードを設定する	Power BI クエリ モード として DirectQuery が選択されている場合は、必要に応じて、 デュアル ストレージ モードを使用するように個々のテーブルを設定できます。 デュアル ストレージ モードに設定されたテーブルは、クエリのコンテキストに応じて、 Import モードまたは DirectQuery モードとして機能できます。 詳細については、Power BIサービスにおけるセマンティックモデルモードを参照してください。
更新後にリフレッシュしてください。	このオプションは、クエリ モードとして Import が選択されている場合に使用できます。デフォルトでは、モデルのメタデータのみが更新されますが、このチェックボックスをオンにすると、データ更新もトリガーされます(これにより、 SQLウェアハウスがクエリされます)。この更新は、Power BI の更新履歴で確認できます。

このタスクを編集、複製、無効化、または削除するには、「Lakeflowジョブでタスクを構成および編集する」を参照してください。

トラブルシューティング

Power BI タスクがセマンティックモデルを更新している間は、Power BI サービスでセマンティックモデルを編集しないでください。そうすると、モデルが**保留中の変更**のままになる可能性があります。

Power BIへの公開のトラブルシューティングに関する情報については、Power BI のトラブルシューティングを参照してください。それでも問題が解決しない場合は、製品に関するフィードバックを送信できます。製品フィードバックの送信を参照してください。