メタデータ スキャンを組織のFabric ワークスペースで実行するには、その前に、Fabric管理者が設定する必要があります。 メタデータ スキャンの設定には、次の 2 つの手順が含まれます。
- 読み取り専用管理 API のサービス プリンシパル認証を有効にする。
- テナント設定を有効にして、詳細なセマンティック モデル メタデータ スキャンを行います。
読み取り専用の管理APIのサービス プリンシパル認証を有効にする
サービス プリンシパルは認証方法であり、Microsoft Entra アプリケーションが API Power BIアクセスできるようにするために使用できます。 この認証方法では、管理者ロールを持つサービス アカウントを維持する必要はありません。 代わりに、アプリで管理 API を使用できるようにするには、テナント設定の構成の一部として 1 回だけ承認を与える必要があります。
読み取り専用管理 API へのサービス プリンシパル アクセスを有効にする方法については、「読み取り専用管理 API の サービス プリンシパル認証を有効にする」を参照してください。
サービス プリンシパル認証を有効にしない場合は、標準の代理管理者アクセス トークン認証を使用してメタデータ スキャンを実行できます。
メタデータ スキャンのテナント設定を有効にする
次の 2 つのテナント設定によって、メタデータのスキャンが制御されます。
- 詳細なメタデータを使用して管理者 API の応答を強化する: この設定では、モデルのキャッシュを有効にし、テーブル、列、メジャーの低レベルセマンティック モデル メタデータ (名前や説明など) を使用して API 応答を強化します。
- DAX 式とマッシュアップ式を使用して管理者 API の応答を強化する: この設定では、API 応答に DAX 式とマッシュアップ クエリを含めることができます。 この設定は、最初の設定も有効になっている場合にのみ有効にすることができます。
これらの設定を有効にするには、 管理ポータル > テナント設定 > 管理 API 設定に移動します。