Microsoft Azure Power BI Service (リポジトリー) - インポート

ブリッジの仕様

ベンダー	Microsoft
ツール名	Azure Power BI
ツールバージョン	2.x
ツールのWebサイト	https://powerbi.microsoft.com/
サポートされている方法論	[ビジネスインテリジェンス] マルチモデル、メタデータリポジトリー、データストア(物理データモデル、OLAPディメンショナルモデル、ストアドプロシージャー式解析)、BIレポート(リレーショナルソース、ディメンショナルソース、式解析、レポートストラクチャー) Java REST API経由の
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: Java REST API経由のMicrosoft / Azure Power BIバージョン2.x
https://powerbi.microsoft.com/をご覧ください。
メタデータ: [ビジネスインテリジェンス] マルチモデル、メタデータリポジトリー、データストア(物理データモデル、OLAPディメンショナルモデル、ストアドプロシージャー式解析)、BIレポート(リレーショナルソース、ディメンショナルソース、式解析、レポートストラクチャー)
コンポーネント: MicrosoftAzurePowerBIバージョン11.2.0

免責事項
このインポートブリッジでは、インターネットに接続して次のサードパーティライブラリーをダウンロードする必要があります。
- オープンソースのサードパーティライブラリーのダウンロードはhttps://repo.maven.apache.org/maven2/などへ
- その他のサードパーティソフトウェア(データベース特定のJDBCドライバーなど)は該当するサイトへ

ダウンロードされたサードパーティライブラリーは、$HOME/data/download/MIMB/に格納されています。
HTTPSが失敗した場合、インポートブリッジはHTTPを試します。
- インターネットへのアクセスにプロキシを使用している場合は、JREでそのプロキシを設定する必要があります(Miscellaneousパラメーターで -j オプションをご覧ください)。
- インポートブリッジではインターネットにフルにアクセスできない場合は、インターネットアクセスがある別のサーバーから$HOME/data/download/MIMB/ディレクトリーをコピーします。$HOME/bin/MIMB.sh (または.bat) -dというコマンドを使えば、すべてのブリッジで使用される全サードパーティライブラリーを一度にダウンロードできます。

このインポートブリッジを実行すると、ライセンス規約の責任、およびダウンロードしたサードパーティソフトウェアライブラリーによって生じる潜在的なセキュリティの脆弱性を受け入れることになります。

概要
このインポートブリッジは、Power BI REST API (デフォルトでは管理者API)を使い、Microsoft AzureクラウドでホストされているMicrosoft Power BIサービスからビジネスインテリジェンス(BI)レポートメタデータをインポートします。

このインポートブリッジでは、次のオブジェクトタイプのカタログを作成できます。
- ワークスペース(グループ)
- ダッシュボード
- Power BIレポート
- データセット
- データソース

要件

- 認証要件:
Microsoft AzureクラウドでホストされているPower BIサービスに接続する場合、インポートブリッジはAzure Active Directory認証を使います。
このブリッジは、Microsoft Authentication Library (MSAL)に依存してAzure Active Directoryを認証します。

Azureグローバルクラウドにアプリケーションを登録するためには、次の設定手順が必要です。
- Azure管理コンソール: https://portal.azure.com/
に接します - 組織に対応するAzure Active Directoryを作成するか、開きます。
- アプリの登録ページで[ネイティブクライアント]タイプの[MIMB]という名前のアプリケーションの登録を作成し、そのクライアントID (アプリケーションID)を書き留めておきます。
- Power BIサービスアプリケーションに必ず権限を追加し、必要な権限を付与します。
たとえば、Power BI Serviceの次の権限を付与できます:
Dashboard.Read.All、Dataflow.Read.All、Dataset.Read.All、Gateway.Read.All、Report.Read.All、Tenant.Read.All、Workspace.Read.All

アプリケーションをAzureナショナルソブリンクラウドに登録する場合は、政府のクラウド環境に合わせて、Azure管理コンソールに別のURLを使用して同様の手順を実行する必要があります。
詳細は、次をご覧ください: https://docs.microsoft.com/en-us/azure/active-directory/develop/authentication-national-cloud
[Azure環境]パラメーターを使って、政府のクラウド環境を指定してください。

インポートブリッジはクライアントID (アプリケーションID)情報を使用してAzureに接続し、認証トークンを取得します。
詳細:
https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-integrating-applications

または、このページを使用してアプリケーションをAzure Active Directoryに登録することも可能です:
https://dev.powerbi.com/apps
Azure管理コンソールを使って特定の権限に関する承認を与えなければならない場合もあります。

また、Azure Active Directory管理コンソール(画面左下)とPower BIサブスクリプション(ライセンス)を介してOffice 365 Admin Centerでユーザーを設定することもできます:
https://admin.microsoft.com/
これによって、ユーザーやグループ、アプリケーションの登録など、きめ細かな設定が可能になります。

Azure Active Directoryに対する認証の方法には次の2つがあります:
- 通常のユーザーとして: 通常、ログインユーザーはメールアドレスの形式となります。例:
UserName@DirectoryName.onmicrosoft.com
- サービスプリンシパルとして: ユーザー名パラメーターは空のままにしておき、テナントIDは入力する必要があります。

インポートブリッジでは、データセットテーブルストラクチャーとPowerQueryマッシュアップ式を取得できるよう、Microsoftの強化済みメタデータスキャンAPIが必要です。
これらは管理者APIの一部としてのみ使用でき、次の設定ステップに従う必要があります。

サービスプリンシパルとして認証するためには、このページで追加権限を設定できます:
https://app.powerbi.com/admin-portal/tenantSettings
- 開発者設定 / サービスプリンシパルがPower BI APIを使用することを許可
- 管理者API設定 / サービスプリンシパルが読み取り専用Power BIの管理者APIを使用することを許可
- 管理者API設定/詳細なメタデータが含まれている管理者APIレスポンス(データセットテーブルおよびカラムに対して)を強化
- 管理者API設定/DAXおよびマッシュアップ式が含まれている管理者APIレスポンス(データセット来歴メタデータに対して)を強化
また、レポートのダウンロードを有効にするためには、次のように設定します:
- 設定をエクスポートおよび共有共有 / レポートをダウンロード

- APIの要件:
このインポートブリッジはデフォルトでPower BI Admin APIを使用します。

管理者APIを使うためには、以下の操作が必要です:
- 委任された権限(サインイン済みユーザーとしてログイン)の使用時、ユーザーにはPower BI管理者ロールが必要です。
- サービスプリンシパル認証をお使いの場合に、Azure Active Directoryコンソール経由で、アプリ(Tenant.ReadWrite.All、Tenant.Read.All)に付与されているPower BIロールを削除します。
- Azure ActiveDirectoryで、セキュリティグループを作成し、そこにサービスプリンシパルアカウントを追加します。
- サービスプリンシパルとセキュリティグループ(またはそのいずれか)に対し、ワークスペースへのアクセスを有効にします。
メニューの[ワークスペース] / [アクセスを管理] / [人またはグループを追加]メニューで
ユーザーまたはグループ(またはサービスプリンシパルアカウント)を選択します
[コントリビューター]または[管理者]として設定します
- レポートをダウンロードする場合は、ユーザーまたはグループがワークスペースにコントリビューターまたは管理者として割り当てられている必要があります
詳細は、次をご覧ください:
https://docs.microsoft.com/en-us/power-bi/admin/service-admin-metadata-scanning
https://docs.microsoft.com/en-us/power-bi/admin/service-admin-metadata-scanning-setup
https://docs.microsoft.com/en-us/power-bi/admin/read-only-apis-service-principal-authentication
https://docs.microsoft.com/en-us/power-bi/developer/embedded/embed-service-principal#service-principal-vs-master-account

このインポートブリッジは、次の方法で(Admin APIの代わりに)通常のAPIを使用することもできます:
- Miscellaneousパラメーターである-api.userを設定
このような場合、詳細な来歴メタデータは抽出されません。

よくある質問
- If you experience the error message below, you may need the administrator to grant consent.
AADSTS65001: ユーザーまたは管理者は、ID '{client-id}'がMIMBであるアプリケーションの使用に同意していません。このユーザーとリソースに対する対話型認証リクエストを送信します。
次のようなURLを使って、管理者に同意を求めます: https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={client-id}
詳細: https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/grant-admin-consent

制限事項
現在判明している一般的な制限事項は、MIMB Known Limitationsか、バンドルされているDocumentation/ReadMe/MIMBKnownLimitations.htmlをご覧ください。

- 管理者APIの制限事項:
- 管理者API経由で抽出されるDataSetメタデータは(Datasetsのテーブル構造やPowerQueryのマッシュアップ式が抽出されるなど)充実していますが、PBITインポートブリッジから完全に抽出されるTabular Object Model (TOM)ほど完全ではありません。
- 管理者API経由で抽出されるレポートメタデータは、PBITインポートブリッジから抽出されるものに比べると非常に限定的です。
- その他の管理者APIの制限事項は以下に記載されています: https://docs.microsoft.com/en-us/power-bi/admin/service-admin-metadata-scanning
- 詳細なレポートのメタデータについては、ブリッジはレポートをダウンロードする機能に依存しています。
レポートダウンロードの制限はこちらに記載されています: https://learn.microsoft.com/en-us/power-bi/create-reports/service-export-to-pbix#limitations

- 標準APIの制限事項:
- 来歴メタデータは、テーブルレベルとカラムレベルではなく、モデルレベルか接続レベルでのみ使用できます。
- Power BIは、[Push]、[Streaming]、[PushStreaming]、[AzureAS]、[AsOnPrem]というデータセットの6つのタイプと、アップロードされたPBIXファイルからのデータセットをサポートしています。
- APIの制限事項があるため、データセットのストラクチャー(テーブルおよびカラムに関して)は、[Push]および[PushStreaming]に対してのみ公開されます。

- PowerQuery M言語解析の制限事項:
- ブリッジは、各テーブルクエリーの来歴を理解するためにPowerQuery M言語解析に依存します。
PowerQuery言語の一部のコンセプトは十分にサポートされていない場合があります:
- 一部の関数(データアクセス関数、データ操作関数)
- サブクエリー、パラメーター、またはカスタム/ラムダ関数に依存する複合クエリー
- 他のスクリプト言語(Kusto、Python、R)に依存するクエリー

サポート
トラブルシューティングパッケージを次の項目と共に提供してください。
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)

ブリッジパラメーター

ブリッジのマッピング

マッピング情報は利用できません