PowerBI メタデータコレクター

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:31分
  • PowerBI メタデータ コレクターは、PowerBI アカウントのメタデータへの読み取り専用アクセスを提供します。

    Power BI は、無関係なデータ ソースを一貫性のある、視覚的に没入型のインタラクティブな分析情報に変換するために連携するソフトウェア サービス、アプリ、コネクタのコレクションです。データソースには、Excel スプレッドシート、クラウドベースのデータウェアハウス、またはオンプレミスのハイブリッドデータウェアハウスが含まれます。Power BI を使用すると、データ ソースに接続し、重要な情報を視覚化して検出し、組織全体で分析情報を共有できます。

    Power BI コレクターは、Power BI サービス ワークスペースからメタデータを収集します。収集されたメタデータを使用して、ワークスペース全体のレポートとダッシュボードを検出し、影響分析を実行して、アップストリームのデータソースへの変更が Power BI レポートにどのように影響するかを理解します。

    サポートされているバージョン

    コレクターは Power BI Cloud API v 1.0 をサポートしています。

    サポートされている認証

    Power BI では、次の 2 つの認証方法がサポートされています。
    • サービスプリンシパル
    • ユーザーとパスワード
    コレクターは、認証されたアカウントがアクセスできるすべての Power BI アプリとワークスペースのメタデータを収集します。

    カタログ化されたメタデータ

    Power BI コレクターは、次の情報をカタログ化します。

    表 : 1. 収集されたメタデータ
    オブジェクト 収集される情報
    ワークスペース タイトル、説明
    アプリケーション タイトル、説明
    Power BI メジャー タイトル、説明、非表示、式
    レポート タイトル、レポートタイプ、外部 URL、埋め込み URL、プレビュー画像 (ページネーションされたレポートタイプではサポートされていません)、作成日、最終変更日、作成者、最終変更者、説明
    レポートページ タイトル 注: Power BI API の制限により、サービス プリンシパル認証を使用する場合は、アプリ内のレポート ページをカタログ化できません。
    ダッシュボード タイトル、外部 URL、埋め込み URL
    ダッシュボードタイル タイトル、埋め込み URL
    データソース タイトル、データソースタイプ、接続の詳細 (種類とパス)
    セマンティックモデル タイトル、外部 URL、説明、作成日、作成者、リフレッシュスケジュール
    データフロー タイトル、最終変更日、説明、作成者、スケジュールをリフレッシュ
    Power BI テーブル (セマンティック モデルとデータフロー) タイトル、非表示、入力済みデータ、説明、ソース式
    Power BI 計算テーブル タイトル、非表示、入力済みデータ、説明、ソース式
    Power BI 列 タイトル、説明、データタイプ、列タイプ、非表示、式
    表形式ファイル ファイルパス、ファイル名
    ファイルディレクトリ ディレクトリパス
    データベース タイトル、タイプ、識別子、サーバー、ポート
    データベーススキーマ タイトル
    データベーステーブル タイトル
    データベース列 タイトル
    テーブル タイトル、説明
    タイトル、タイプ
    計算グループ タイトル、説明
    計算アイテム タイトル、説明、式

    オブジェクト間の関係

    カタログページには、次のデータ資産タイプ間の関係が表示されます。

    表 : 2. カタログオブジェクト間の関係
    データ資産ページ 関係
    アプリケーション レポート、ダッシュボード、ワークスペース
    Power BI 列 Power BI テーブル
    データソース セマンティックモデル、データフロー、表形式データソース (データベース、表形式ファイル)
    タイル ダッシュボード、レポート、セマンティックモデル
    ダッシュボード タイル、ワークスペース
    ダッシュボードタイル 関連するセマンティックモデル
    セマンティックモデル ダッシュボードタイル、レポート
    レポート タイル、ワークスペース、レポートページ (ページネーションされたレポートタイプには適用されません)、セマンティックモデル (ページネーションされたレポートタイプには適用されません)、レポート
    注:
    Power BI では、アプリ レポートとそれに関連するワークスペース レポートは、一意のレポート ID を持つ 2 つの別々のレポートです。コレクターはそれらの間の関係をカタログ化します。
    レポートページ レポート (ページネーションされたレポートタイプには適用されません)
    セマンティックモデル タイル、ワークスペース、レポート、テーブル、データソース、セマンティックモデル、データフロー
    ワークスペース レポート、セマンティックモデル、データフロー、ダッシュボード、アプリ
    データフロー ワークスペース、テーブル、データソース、データフロー
    Power BI テーブル セマンティック モデル、データフロー、Power BI 列、Power BI 測定
    Power BI 測定 Power BI テーブル
    表形式データソース (データベース、表形式ファイル) データソース
    計算グループ Power BI テーブル
    計算アイテム 計算グループ

    PowerBI のリネージ

    次のリネージ情報は、Power BI コレクターによって収集されます。コレクターは、 Power BI スキャナー API を使用して、ソース テーブルと列へのリネージを確立します。スキャナー API の制限事項を必ず理解してください

    表 : 3. オブジェクト別のリネージ可用性
    オブジェクト 利用可能なリネージ
    ダッシュボードタイル 関連するセマンティックモデル
    セマンティックモデル 関連するデータフロー、セマンティックモデル
    データフロー データフロー
    Power BI 列 列がデータのソースとなる、または値を計算する関連列。
    注:
    リネージは、サーバー名、スキーマ名、テーブル名、またはデータベース名の代わりにパラメーターを使用する Power BI 式から収集できます。テーブル レベルおよび列レベルのリネージとカタログ リレーションシップは、Power BI API を介してテーブル、列、およびレポート間で使用できません。
    Power BI テーブル テーブルのデータのソースである関連テーブル 注:
    注:
    コレクターは、API によって返された Power BI 式を使用して、ソース列/テーブルへのリネージを解析します。
    Power BI 計算テーブル 計算テーブルの値の派生元となる Power BI テーブルと列。
    Power BI 測定 測定のデータのソースである関連列

    次の表に、サポートされているテーブル操作と変換、およびサポートされていないテーブル操作と変換を示します。これには、リネージメタデータの収集で使用されるソース式、計算列、およびメジャー式が含まれます。リストにない操作は収集されません。

    表 : 4. リネージメタデータの収集でサポートされている変換と式
    カテゴリ カテゴリ
    サポートされているパラメーター化された式 コレクターは、フルソース、サーバーまたはホスト、ウェアハウス、データベース名、スキーマ名、テーブル名、および SQL 式の値の代わりにパラメーターを使用するソース式を解析します。
    サポートされているデータ関数 Csv.Document、Excel.Workbook、File.Contents、Folder.Contents、Folder.Files、Json.Document、Odbc.DataSource、Odbc.InferOptions、Odbc.Query、Xml.Document、Web.Contents、Web.Headers、Web.BrowserContents、AmazonRedshift.Database、Sql.Database、Sql.Databases、Snowflake.Databases、PostgreSQL.Database、Databricks.Catalogs、Oracle.Database、Denodo.Contents、Databricks.Query、DatabricksMultiCloud.Catalogs、AnalysisServices.Database、GoogleBigQuery.Database
    サポートされているテーブル関数 Table.AddColumn, Table.AddIndexColumn, Table.RenameColumns, Table.NestedJoin, Table.ExpandTableColumn, Table.SplitColumn, Table.DuplicateColumn, Table.CombineColumns
    サポートされていないテーブル操作 Table.Pivot, Table.PromoteHeaders, Table.DemoteHeaders, Table.PrefixColumns, Table.TransformColumnNames, Table.Unpivot, Table.UnpivotOtherColumns, Table.AddFuzzyClusterColumn, Table.AddJoinColumn, Table.AggregateTableColumn, Table.Combine, Table.CombineColumnsToRecord, Table.ExpandRecordColumn, Table.Join, Table.Transpose
    サポートされているデータフロー関数 PowerPlatform.Dataflows、PowerBI.Dataflows
    サポートされている値関数 Value.NativeQuery
    サポートされている計算列 テーブル参照のある列とない列、英数字、スペース、ハイフン、アンダースコアを含む列またはテーブルを含む計算列式からのリネージがサポートされています
    サポートされている対策 英数字、スペース、ハイフン、アンダースコア、周囲の引用符を含む列またはテーブルを含むメジャー式からのリネージがサポートされています

    PowerBI コレクターを実行する準備をする

    コレクターを実行する前に、Azure アプリケーションの登録、認証、および権限を設定します。

    始める前に

    必要なロール:admin

    重要:
    Power BI アドミン ポータルの設定を有効にするには、Power BI 管理者が必要です。

    このタスクについて

    コレクターは Azure アプリケーション登録を使用し、サービスプリンシパルまたはユーザー名とパスワードの 2 つの認証方法をサポートしています。アプリケーションを登録し、認証を構成し、メタデータスキャンを有効にして、テナント ID を取得する必要があります。必要に応じて、レポート画像の収集とリネージマッピングを構成します。

    手順

    1. Azure でアプリケーションを登録し、クライアント認証情報を作成します。

      Power BI アプリケーションの登録」を参照してください。

    2. 希望する方法に基づいて認証を構成します。
    3. メタデータスキャンを有効にして、詳細なデータソース情報にアクセスします。

      Power BI メタデータ スキャンを構成する」を参照してください。

    4. Power BI テナント ID を取得します。

      Power BI テナント ID を取得」を参照してください。

    5. オプション: Power BI レポートからプレビュー画像を収集するようにレポート画像収集を構成します。

      Power BI レポートの画像収集を構成する」を参照してください。

    6. オプション: ODBC 接続、サーバーエイリアス、またはカスタム SQL ステートメントのリネージマッピングを構成します。

      Power BI リネージマッピングの構成」を参照してください。

    Power BI アプリケーションの登録

    Azure にアプリケーションを登録し、Power BI コレクター認証用のクライアント資格情報を作成します。

    始める前に

    必要なロール:admin

    Azure Active Directory にアプリケーションを登録する権限が必要です。

    このタスクについて

    Azure でアプリケーションを登録して、Power BI コレクター認証に必要なクライアント ID とクライアントシークレットを取得します。

    手順

    1. Azure で新しいアプリケーションを登録します。
      1. Azure ポータルに移動します。
      2. Azure サービスから [アプリの登録 ] を選択します。
      3. [ 新規登録] を選択します。
      4. 登録情報を入力します。
        • アプリケーション名:DataDotWorldPowerBIApplication
        • サポートされているアカウントの種類:この組織ディレクトリ内のアカウントのみ
      5. [ 登録] を選択して登録を完了します。
    2. クライアントシークレットを作成します。
      1. アプリケーションページで、[ 証明書とシークレット] を選択します。
      2. [新しいクライアントシークレット (New client secret)] を選択します。
      3. シークレットの説明を追加します。
      4. 希望する有効期限を選択します。
      5. [Add (追加)] を選択します。
      6. シークレット値をコピーします。

        この値は安全に保存してください。Power BI コレクターを構成するときに使用します。

    3. クライアント ID を取得します。
      1. アプリケーションページの左側のサイドバーにある [ 概要 ] タブを選択します。
      2. [Essentials] セクションからクライアント ID をコピーします。

        この値を保存します。Power BI コレクターを構成するときに使用します。

    Power BI サービスプリンシパル認証を構成する

    サービスプリンシパル認証を設定して、Power BI メタデータ収集を有効にします。

    始める前に

    必要なロール:admin

    サービスプリンシパル設定を有効にするには、Power BI 管理者である必要があります。

    重要:
    サービス プリンシパルで実行する場合は、アプリに Power BI 管理者の同意が必要なアクセス許可が設定されていない必要があります。詳細については、 Microsoft のドキュメントを参照してください。

    このタスクについて

    サービスプリンシパル認証を使用する場合、コレクターはパーソナルワークスペース、ユーザーワークスペース、およびレポートページを除くすべてのオブジェクトを収集します。テナント内のすべてのアプリとワークスペースを収集するには、[テナント内のすべてのワークスペースとアプリのカタログ化] を有効にします。個人用ワークスペースとユーザーワークスペースを含めるには、ユーザーの [自分のワークスペース] のカタログコンテンツを有効にします。

    注:
    レポートページを収集するには、サービスプリンシパルに各ワークスペースへのアクセス権を付与します。admin API にはレポートページのエンドポイントがありません。

    手順

    1. Power BI 管理者アカウントを使用して Power BI にサインインします。
    2. 移動先 設定 > アドミンポータル.
    3. サービスプリンシパル API アクセスを有効にします。
      1. [ 開発者設定] で、[ サービス プリンシパルは Fabric API を使用できます] を見つけます
      2. 設定を有効にします。
      3. 設定を組織全体に適用するか、特定のセキュリティグループに適用するかを選択します。

        特定のセキュリティグループを使用している場合は、グループにサービスプリンシパルが含まれていることを確認します。

      4. [適用] を選択して変更を保存します。
    4. オプション: データフローとレポートページにアクセスするために、サービスプリンシパルをワークスペースに追加します。

      データフローでは、サービス プリンシパルに少なくともワークスペースへの共同作成者アクセス権が必要です。レポート ページの場合、admin API はレポート ページのエンドポイントを提供しないため、サービス プリンシパルにもワークスペースへのアクセスが必要です。

      1. ワークスペースを開きます。
      2. [ アクセスの管理] を選択します。
      3. サービスプリンシパルまたはサービスプリンシパルが属するセキュリティグループを検索します。
      4. 適切なアクセスレベルを選択します。

        データフローを使用する場合は、少なくとも [共同作成者アクセス] を選択します。それ以外の場合は、[ビューアー] を選択します。

      5. [Add (追加)] を選択します。

    Power BI ユーザー名とパスワードの認証を構成する

    ユーザー名とパスワードの認証の API アクセス許可を設定して、Power BI メタデータ収集を有効にします。

    始める前に

    必要なロール:admin

    Azure Active Directory で API 権限を構成する権限が必要です。

    注:
    テナントのアドミンのみがアドミンの同意を付与できます。

    このタスクについて

    ユーザー認証を使用する場合、コレクターはパーソナルワークスペース、ユーザーワークスペース、およびレポートページを除くすべてのオブジェクトを収集します。テナント内のすべてのアプリとワークスペースを収集するには、[テナント内のすべてのワークスペースとアプリのカタログ化] を有効にします。個人用ワークスペースとユーザーワークスペースを含めるには、ユーザーの [自分のワークスペース] のカタログコンテンツを有効にします。

    レポートページを収集するには、各ワークスペースへのアクセス権をユーザーに付与します。admin API にはレポートページのエンドポイントがありません。

    注:
    テナント内のすべてのワークスペースとアプリをカタログ化するには、ユーザーがメタデータ スキャンのための Microsoft 365 グローバル管理者または Power BI サービス管理者の権限を持っている必要があります。詳細については、 Power BI のドキュメントを参照してください。

    手順

    1. Azure ポータルに移動し、アプリケーション登録を開きます。
    2. [API 権限] を選択します。
    3. Microsoft Graph のアクセス許可を追加します。
      1. [権限を追加 (Add a permission)] を選択します。
      2. [Microsoft Graph] を検索して選択します。
      3. 次の権限を追加します。
        • アプリケーションのアクセス許可:Application.Read.All
        • 委任された権限:User.Read (デフォルトでアサインされています)
    4. Power BI サービスのアクセス許可を追加します。
      1. [権限を追加 (Add a permission)] を選択します。
      2. Power BI サービスを検索して選択します。
      3. [委任されたアクセス許可] を選択します。
      4. 次の権限を追加します。
        • App.Read.All
        • Dashboard.Read.All
        • Dataflow.Read.All
        • Dataset.Read.All
        • Report.Read.All
        • Tenant.Read.All
        • Workspace.Read.All
    5. [アクセス許可の追加] ボタンの横にある [アドミンの同意を付与する] ボタンを選択します。

      この権限により、実行のたびに権限を求めずにコレクターを実行できます。

    Power BI メタデータ スキャンを構成する

    メタデータスキャンを有効にして、テーブルや列などの詳細なデータソース情報にアクセスします。

    始める前に

    必要なロール:admin

    メタデータ スキャン設定を有効にするには、Power BI 管理者である必要があります。

    このタスクについて

    メタデータ スキャン では、Power BI 読み取り専用の管理 API を使用して、テーブルや列などの詳細なデータ ソース情報にアクセスできます。コレクターは、Power BI スキャナー API を使用して、ソース テーブルと列へのリネージを確立します。コレクターを構成する前に 、スキャナー API の制限 事項を確認してください。

    手順

    認証方法に基づいてメタデータスキャンを有効にします。
    • サービスプリンシパル認証の場合:

      1. Power BI のドキュメントに従って、Power BI 読み取り専用 API のサービスプリンシパル認証を有効にします
      2. メタデータスキャンの次の拡張テナント設定を有効にします。
        • 詳細なメタデータでアドミン API 応答を拡張する
        • DAX とマッシュアップ式を使用して管理 API 応答を拡張する
    • ユーザー名とパスワードの認証の場合は、メタデータスキャンの次の拡張テナント設定を有効にします。

      重要:
      メタデータ スキャンを使用するには、ユーザーに管理者権限 (Microsoft 365 グローバル管理者または Power BI サービス管理者) が必要です。詳細については、 Power BI のドキュメントを参照してください。
      • 詳細なメタデータでアドミン API 応答を拡張する
      • DAX とマッシュアップ式を使用して管理 API 応答を拡張する

    Power BI テナント ID を取得

    Power BI アプリケーションからテナント ID を取得します。

    始める前に

    必要なロール:admin

    このタスクについて

    テナント ID は、Power BI コレクターを構成するときに必要です。Power BI アプリケーションからこの値を取得します。

    手順

    1. Power BI アプリケーションで、疑問符アイコンを選択します。
    2. [ Power BI について] を選択します。
    3. テナント URL の末尾からテナント ID をコピーします。

      この値を保存します。Power BI コレクターを構成するときに使用します。

    Power BI レポートの画像収集を構成する

    レポート画像収集を有効にして、Power BI レポートからプレビュー画像を収集します。

    始める前に

    必要なロール:admin

    注:
    レポート画像の収集は、Power BI アプリではサポートされていません。

    このタスクについて

    レポート画像収集を有効にして、Power BI レポートからプレビュー画像を収集して、データカタログに表示します。

    手順

    1. Power BI アドミン ポータルでエクスポート設定を有効にします。
      1. Power BI 管理者アカウントを使用して Power BI にサインインします。
      2. 移動先 設定 > アドミンポータル.
      3. アドミン設定から [レポートを画像ファイルとしてエクスポートする] 設定を見つけて有効にします。
    2. ワークスペースのキャパシティを確認します。

      エクスポートするレポートが、プレミアム、埋め込み、またはファブリック容量のワークスペースに配置されていることを確認します。詳細については、 Power BI のドキュメントを参照してください。

    Power BI リネージマッピングの構成

    リネージ収集用のデータソースをマッピングする YAML ファイルを作成します。

    始める前に

    必要なロール:admin

    このタスクについて

    これは、リネージ情報を収集するためのオプションのタスクです。YAML ファイルを作成し、コレクターの実行時に [データソース名マッピングファイル] オプションを使用して渡します。

    次のシナリオで YAML ファイルを設定します。

    表 : 5. リネージマッピングのシナリオ
    シナリオ 詳細 アクション
    Power BI の ODBC 接続 ODBC 接続を使用するデータ ソースが Power BI にあります。これらのインスタンスでは、Power BI はソースのホストまたはデータベースの種類を提供しません YAML ファイルで、DSN を特定のデータベースホストとタイプにマップします。Power BI データ ソースにデータベース名がない場合は、YAML ファイルのデータ ソースに defaultDatabaseName オプションを追加します
    複数のサーバー名エイリアス 同じデータベース インスタンス (ホスト) に複数のサーバー名 (エイリアス) があり、データベース コレクターが Power BI 接続で定義されているエイリアスとは異なるエイリアスを使用する YAML ファイルを使用して、データベースホストをユーザー指定のエイリアスにマップします
    カスタム SQL ステートメント カスタム SQL ステートメントは、Power BI テーブル ソース定義で使用されます。Power BI コレクターは現在、SQL ステートメントからリネージを解決するために、Snowflake、SQL Server、PostgreSQL、Redshift、Oracle、Databricks、Denodo、BigQuery のデータベースタイプへの接続をサポートしています。SQL ステートメントを使用するテーブルソースのリネージ解決では、単一の SELECT ステートメントで構成される SQL のみがサポートされます 環境変数を使用して、datasourceKey、ホスト、および安全な認証情報を含めることにより、カスタム SQL ステートメントで指定されたデータベースを構成します
    注:
    ファイル内の環境変数を使用して、パスワードなどの機密情報を得ることができます。

    手順

    1. datasources.yml という名前の YAML ファイルを作成します。
    2. シナリオに基づいて YAML ファイルを構成します。
      • 複数のサーバー名エイリアスの場合:

        ホストエイリアスをマッピングするには、次を追加します。

        datasources:
         - datasourceKey: "<host or data source key in Power BI source>"
          host: <my-datasource-host>

        たとえば、Power BI テーブル ソースが次の場合:

        let Source = Snowflake.Database("host-alias.snowflakecomputing.com", "KOS_TEST"),
        PowerBiTest_Test_Table = Source{[Schema="POWERBI_TEST",Item="TEST_TABLE"]}[Data]
        in PowerBiTest_Test_Table

        次に、datasourceKeyが host-alias.snowflakecomputing.com されます。datasources.ymlファイルは次のようになります。

        datasources:
        - datasourceKey: host-alias.snowflakecomputing.com
        host: host-actual.snowflakecomputing.com
      • カスタム SQL ステートメントの場合:

        カスタム SQL ステートメントで指定されたデータベースに以下を追加します。次の環境変数がサポートされています。

        datasources:
          - datasourceKey: "<host or data source key in Power BI source>"
          OR
         - name: <data source name>
         host: <my-datasource-host>
         databaseUsername: <username> # recommend setting up env variable
         databasePassword: <password> # recommend setting up env variable

        次のオプションを使用して、データソース構成が適用されるデータベースを指定します。指定しない場合、データソース設定は、指定されたホスト上のすべてのデータベースに適用されることが想定されます。

        applicableDatabases:
          - <database_name>

        たとえば、次のようになります:

        datasources:
        - datasourceKey: "example.cpcnqsn422gx.us-east-1.rds.amazonaws.com, 1433"
         host: example.cpcnqsn422gx.us-east-1.rds.amazonaws.com
         databaseUsername: ${DB_USERNAME}
         databasePassword: ${DB_PASSWORD}
         applicableDatabases:
         - 8bank_database
      • ODBC 接続の場合:

        DSN を特定のデータベースホストとタイプにマッピングします。ODBC 接続の場合は、データソースと、対応するホストおよびデータベースタイプを一覧表示します。ODBC 接続で Odbc.Query を使用する場合は、ユーザー名とパスワードを指定します。ODBC 接続でデータベース名を指定する場合は、defaultDatabaseName を含めます。

        datasources:
        - name: "Name-for-datasource"
        host: <my-datasource-host>
        databaseType: <type-of-database>
        databaseUsername: <username> # optional
        databasePassword: <password> # optional
        defaultDatabaseName: <database name> # optional

        可能な databaseType のリストは、postgres、redshift、bigquery、oracle、mysql、netezza、snowflake、sqlanywhere、sqlserver、databricks、denodo です。タイプでは大文字と小文字は区別されませんが、スペースを入れない単一の単語にする必要があります。

        たとえば、次のようになります:

        datasources:
        - name: "SQL Server DSN Production"
        databaseType: sqlserver
        host: 8bank-sqlserver.cpetgx.us-east-1.rds.amazonaws.com
    3. オプション: 必要に応じて、データベース固有の構成オプションを追加します。

      JDBC プロパティのオプション:

      表 : 6. JDBC プロパティ
      オプション 説明
      jdbcProperties YAML リストを使用して、複数の JDBC プロパティを指定できます。想定される形式は、jdbcProperties: key=value です

      例:jdbcProperties: encrypt=true

      複数の値の場合:

      jdbcProperties:
      - encrypt=true
      - readOnly=true

      Snowflakeデータベース認証情報オプション:

      表 : 7. Snowflake オプション
      オプション 説明
      databaseUsername:${DB_USERNAME} Power BI データベースソースでカスタム SQL クエリが使用されている場合は必須です
      databasePassword:${DB_PASSWORD} SQL クエリが使用されている場合、および Snowflake への認証に秘密鍵が使用されていない場合は必須です
      snowflakePrivateKeyFile:privateKeyFile SQL クエリーが使用され、Snowflake への認証に秘密鍵が使用される場合は必須
      snowflakePrivateKeyFilePassword:${privateKeyFilePassword} SQL クエリーが使用され、Snowflake への認証に秘密鍵が使用される場合は必須
      snowflakeRole:ロール SQL クエリを使用する場合は必須です
      snowflakeWarehouse:倉庫 データベース接続の Power BI 式で使用されるウェアハウスをオーバーライドするために使用します

      Databricks データベース資格情報オプション:

      表 : 8. Databricks オプション
      オプション 説明
      databricksHttpPath ソースデータベースが Databricks の場合は必須

      Oracle Autonomous Databaseのオプション:

      表 : 9. Oracle Autonomous Databaseのオプション
      オプション 説明
      oracleAutonomousDbConnectionString ソースが Oracle Autonomous Database の場合は必須です。接続文字列は次の形式である必要があります:
      jdbc:oracle:thin:<host>:<port>/<service_name>, 
      jdbc:oracle:thin:@(address=(protocol=tcps)(port=<port>)(host:<host>))
      (connect_data=(service_name=<service_name>))
      (security=(ssl_server_dn_match=yes)), 
      or jdbc:oracle:thin:@alias_name?TNS_ADMIN=/path/to/wallet
      

      BigQuery のオプション:

      表 : 10. BigQuery オプション
      オプション 説明
      プロジェクト ソースが BigQuery テーブルの場合は必須
      bigQueryCredentialJsonString BigQuery 認証情報の提供に必要です

      BigQuery データベースの例:

      datasources:
       - project: "project-name"
      databaseType: bigquery
      bigQueryCredentialJsonString: '{"key": "value","key": "value"}'
    4. datasources.ymlファイルを保存します。
    5. コレクタを実行するときに、--datasource-mapping-file パラメータを使用して YAML ファイルをコレクタに渡します。

    PowerBI メタデータコレクターの作成

    PowerBI からメタデータをインポートするコレクターを作成します。

    始める前に

    開始する前に、以下を確認してください。

    手順

    1. 移動先 すべて > ワークフローデータファブリック > Workflow Data Fabric ホーム.
    2. 左側のサイドバーで [コネクトハブ] アイコン を選択します。
    3. 選択 作成 > メタデータコレクター.
    4. [システム] リストから [PowerBI] を選択します。
    5. フォームに入力します。
      表 : 11. 新しい PowerBI Gov メタデータ コレクター フォーム
      フィールド 説明
      接続名 接続の一意の識別子。接続が確立されると、このフィールドは変更できません。
      簡単な説明 接続の目的と詳細。
    6. 認証オプションを設定します。
      表 : 12. 認証オプション
      フィールド 説明
      Azure ユーザー名とパスワードを使用した認証 Azure Active Directory のユーザー名とパスワード。ユーザー名とパスワード認証の使用時に Azure テナント ID を指定する場合は、Azure テナント ID を設定します。
      Azure サービスプリンシパルを使用した認証 Power BI アプリの Azure Active Directory アプリケーションテナント ID。テナント ID を見つけるには、Power BI アプリで疑問符を選択し、 [Power BI について] を選択します。テナント ID は、テナント URL の末尾にあります。
    7. クライアント ID とクライアントシークレットの詳細を構成します。
      表 : 13. 構成詳細
      フィールド 説明
      Microsoft Entra クライアント ID PowerBI アプリのアプリケーションクライアント ID。
      Microsoft Entra クライアントシークレット PowerBI アプリのアプリケーションクライアントシークレット。
    8. ワークスペースのスコープとフィルターオプションを構成します。
      表 : 14. ワークスペースのスコープとフィルターのオプション
      フィールド 説明
      リネージ収集を無効にする Power BI ソース式からのリネージメタデータの収集をスキップするオプション。
      ユーザーの [マイワークスペース] のカタログコンテンツ Power BI でユーザーの [マイ ワークスペース] のコンテンツをカタログ化するオプション。

      デフォルト:ユーザーのワークスペースをスキップします。

      テナント内のすべてのワークスペースとアプリをカタログ化 認証情報が明示的にアクセスできるワークスペースとアプリだけでなく、テナント内のすべてのワークスペースとアプリをカタログ化するオプション。使用する認証情報にはアドミン権限が必要です。
      Power BI ワークスペースを含める 収集するワークスペース。一致する正確なワークスペース名または正規表現を入力します。
      注:
      ワークスペース名に特殊文字 [. , + , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \] は、各特殊文字をバックスラッシュ (\) でエスケープします。たとえば、ワークスペース (Dev) の場合は「ワークスペース \(Dev\)」と入力します。
      Power BI ワークスペースを除外 カタログから除外する Power BI ワークスペースとそのコンテンツ。一致する正確なワークスペース名または正規表現を入力します。[ワークスペースを含める] と [ワークスペースを除外] の両方が構成されている場合は、[ワークスペースを含める] が優先されます。
      注:
      ワークスペース名に特殊文字 [. , + , * , ? , ^ , $ , ( , ) , [ , ] , { , } , | , \] は、各特殊文字をバックスラッシュ (\) でエスケープします。たとえば、ワークスペース (Dev) の場合は「ワークスペース \(Dev\)」と入力します。
    9. 接続と信頼性のオプションを構成します。
      表 : 15. 接続と信頼性のオプション
      フィールド 説明
      Power BI 式の最大長 リネージメタデータ用に解析される Power BI 式の最大文字数。この値よりも長い式はスキップされます。

      デフォルト:32000

      データソース名マッピングファイル datasources.ymlファイルで構成された ODBC ソースの詳細をマップするファイル。ODBC ソースの詳細を構成している場合は、ファイルをアップロードします。
      カタログレポートのプレビュー画像 プレビュー画像をカタログ化するオプション。

      デフォルト値:false

      最大要求数待機を無効にする Power BI API による調整制限のリセットの待機を無効にするオプション (エラー コード 429)。選択しない場合、コレクタは最大 1 時間、5 分ごとに再試行します。選択すると、代わりに [最大再試行回数] と [再試行遅延] 設定が使用されます。
      最大再試行回数 失敗した API 呼び出しを再試行する回数。

      デフォルト:5

      再試行の遅延 API 呼び出しの試行失敗を待機する秒数。

      デフォルト:2 秒

    10. [Save (保存)] を選択します。

    タスクの結果

    メタデータコレクターが作成され、[コネクタ] ページに [構成済み] ステータスで表示されます。これで、ソースシステムに接続してメタデータを収集する準備ができました。

    次のタスク

    コレクターを作成した後、次のいずれかのタスクを実行できます。