接続のトラブルシューティング
認証には成功しているのにデータが返されない場合、またはメタデータやワークスペースへのアクセス時にエラーが発生する場合は、以下の点を確認してください。
データセットのプレビューが空白、またはテーブルが返されない場合
- AzureTenant の値が正しいか確認してください。この値は、Power BI ワークスペースが存在するテナントID(GUID または確認済みドメイン)と一致している必要があります。
- Power BI ワークスペースがPremium 容量に割り当てられていることを確認してください。Premium でないワークスペースは、XMLA エンドポイント経由ではアクセスできません。
- サービスプリンシパルを使用する場合は、そのワークスペースの管理者(Admin)として割り当てられている必要があります。Viewer やContributor ロールでは不十分です。
OAuth トークンのリフレッシュに関する問題
- トークンの有効期限切れに関するエラーが発生した場合は、初回のトークン交換後にInitiateOAuth がREFRESH に設定されていることを確認してください。
- 特にヘッドレス環境では、OAuthSettingsLocation がドライバーの読み書き可能なファイルを指していることを確認してください。
- リフレッシュトークンは、有効期限が切れたり、取り消されたりする場合があります。その場合は、OAuth フロー全体を再実行する必要があります。
管理者の同意がない、またはアクセス許可の構成ミス
- Entra 管理センターのAPI のアクセス許可セクションで、アプリケーションのアクセス許可を確認してください。
- アプリがアプリケーションのアクセス許可を使用する場合、管理者によるテナント全体への同意が必要です。。
- 必要なアクセス許可(Dataset.Read.All)が不足していたり、アクセス許可の種類(委任されたアクセス許可とアプリケーションのアクセス許可)が誤っていると、エラーが表示されずに失敗することがあります。
Azure テナントの問題
- テナントID が欠落しているか誤っている場合、認証には成功してもデータが取得できないことがあります。
- GUID またはテナントの確認済みドメイン名のいずれかを使用できますが、ワークスペースがホストされているテナントと一致している必要があります。
アクセス許可の反映に時間がかかる場合
- ロール(ワークスペースへのサービスプリンシパルのアクセスなど)を割り当てた後、アクセス許可が反映されるまでに数分かかることがあります。
- アプリが登録または更新されたばかりの場合は、数分待ってから接続を再試行してください。