Power BI の更新
TaskBeacon は、監視対象の各セマンティックモデルの更新履歴を読み取ります。Failed の更新は Power BI のエラーコード付きで Failed(失敗)の実行になり、 進行中の更新は Running(実行中)として表示され(通常よりかなり長くかかる場合は Late(遅延))、完了した更新は 所要時間付きで OK になります。モデルのスケジュールされた更新時刻がジョブのスケジュールになるため、行われなかった更新は Missed(未実行)と表示されます。
必要なもの: 自社テナント内の Microsoft Entra アプリ登録(サービスプリンシパル)、サービスプリンシパルを一度許可する Fabric / Power BI 管理者、 そしてアプリをワークスペースに追加するワークスペースの管理者です。
1. アプリ登録を作成する
- Microsoft Entra admin center で App registrations → New registration に進みます。名前は例えば TaskBeacon monitor とし、シングルテナント、リダイレクト URI なしにします。
- Overview で Application (client) ID と Directory (tenant) ID をコピーします。
- Certificates & secrets → Client secrets → New client secret で、シークレットの Value をすぐにコピーします(表示されるのは一度だけです)。有効期限を控えておいてください。期限が切れると連携が止まり、新しいシークレットを貼り付けるまでエラーが表示されます。
- Power BI 用の API のアクセス許可は追加しないでください。Power BI REST API を呼び出すサービスプリンシパルには、Microsoft はアクセス許可を何も付けないことを推奨しています。アクセス権は、下記のワークスペースのロールによって与えられます。
2. サービスプリンシパルを許可する(Fabric 管理者、一度だけ)
Microsoft Entra のセキュリティグループ(例: Power BI API apps)を作成し、アプリを追加します。次に Fabric 管理ポータルの Tenant settings(2026 年時点では OneLake catalog → Govern → Configurations → Tenant settings から開きます)の Developer settings セクションで、そのセキュリティグループに対して Service principals can call Fabric public APIs を有効にします (古いページでは Allow service principals to use Power BI APIs という名前です)。組織全体ではなく特定のグループに対して有効にすると、範囲を狭く保てます。
3. 各ワークスペースにアプリを追加する
Power BI でワークスペースを開き、Manage access(Workspace access)→ Add people or groups で、アプリを名前で検索し、 Contributor ロールを付与します。Contributor は動作する最も低いロールです。更新履歴を読むにはセマンティックモデルへの書き込み権限が必要で、 Viewer にはその権限がありません。Member や Admin でも動作しますが、必要以上の権限を与えることになります。My workspace はサービスプリンシパルでは使えません。
4. TaskBeacon で接続する
Jobs → ▾ → Add integration…(連携を追加…)→ Power BI。テナント ID、クライアント ID、シークレットを貼り付けて、Test connection and continue(接続をテストして続行)を押します。 次に Choose what to watch(監視対象を選択)で、アプリが参照できるワークスペース内の更新可能なモデルがすべて ワークスペース / モデル の形で一覧表示されます。チェックを入れたモデルがジョブになります。
実行の読み取り方
- ポーリングのたびに直近 5 回の更新を読み取ります。ステータス Completed = OK、Failed = エラーコード付きの Failed(例: ModelRefreshFailed_CredentialsNotSpecified)、Unknown = 実行中です。
- 更新スケジュールは 1 日 1 回読み取ります。1 日に等間隔の時刻が複数ある場合はすべてを数えます。時刻の間隔が不規則な場合は、その日の最初の更新だけを予定とします。
- 対象はインポートモードのモデルのみです。DirectQuery やライブ接続のモデルには更新がないため、一覧に表示されません。OneDrive でホストされているモデルの更新は履歴に含まれません。
実環境ではまだテストされていません。結果をお知らせください(support@taskbeacon.io)。
ユースケース: チーム全員への Power BI 更新失敗の通知。その他のご質問: FAQ