メタデータ スキャンを使用すると、組織の Fabric アイテムのすべてのメタデータをカタログ化してレポートできるため、組織の Microsoft Fabric データのガバナンスが容易になります。 これを実現するには、"スキャナー API" と総称される一連の管理 REST API を使用します。
スキャナー API を使用すると、アイテム名、所有者、秘密度ラベル、保証状態などの情報を抽出できます。 Power BI セマンティック モデルの場合は、テーブル名や列名、メジャー、DAX 式、マッシュアップ クエリなど、含まれているオブジェクトのメタデータの一部を抽出することもできます。 これらのセマンティック モデル内部オブジェクトのメタデータは、サブアーティファクト メタデータと呼ばれます。
メタデータ スキャンで返される成果物とサブアーティファクトメタデータのより広範な一覧については、 Admin - WorkspaceInfo GetScanResult API のドキュメントを参照してください。
スキャナー API を次に示します。 パブリック クラウドとソブリン クラウドの両方をサポートします。
Von Bedeutung
スキャン用に開発したアプリは、標準の委任された管理者アクセス トークンまたはサービス プリンシパルを使用して認証できます。 2 つの認証パスは相互に排他的です。 サービス プリンシパルで実行する場合、アプリに Power BI 管理者の同意が必要なアクセス許可が設定されていない必要があります。 詳細については、「 管理者 API のサービス プリンシパル認証を有効にする」を参照してください。
基本的なフロー
組織内でメタデータ スキャンを設定する: メタデータ スキャンを実行する前に、Fabric 管理者が組織内で設定する必要があります。 ファブリック管理者には、 メタデータスキャンの設定が表示されます。
管理者の読み取り専用 API のサービス プリンシパル認証を有効にします。 サービス プリンシパルは、Microsoft Entra アプリケーションが Microsoft Fabric のコンテンツと API にアクセスできるようにするために使用できる認証方法です。 管理者 API のサービス プリンシパル認証を有効にするを参照してください。
メタデータ スキャンの実行: スキャンの実行方法を示すチュートリアルについては、「 メタデータ スキャン を実行する」を参照してください。
ライセンス
メタデータ スキャンには特別なライセンスは必要ありません。 これは、Premium 以外のワークスペースにある項目を含め、テナントのすべてのメタデータに対して機能します。