Skip to main content

About the Power BI Service collector

Use this collector to harvest metadata from Power BI. Users can then:

  • Discover Power BI reports and dashboards across your enterprise’s Power BI workspaces.

  • Perform impact analysis to understand how changes to upstream data sources impact Power BI reports.

Important things to note:

  • This collector only harvests from the Power BI Service. It does not harvest Power BI desktop (pbix) files unless these files are uploaded to Power BI cloud service.

  • This collector does not harvest from Power BI Report Server. There is a separate collector available for Power BI Report Server.

Important

The Power BI Service collector can be run in the Cloud or on-premise using Docker or Jar files.

Note

The latest version of the Collector is 2.206. To view the release notes for this version and all previous versions, please go here.

What is cataloged

The collector catalogs the following information.

Table 1.

Object

Information collected

Workspaces

Title

Apps

Title

Reports

Title, External URL, Embed URL

Report Pages

Title

Dashboards

Title, External URL, Embed URL

Dashboard tiles

Title, Embed URL

Data Sources

Title, Data source type

Datasets

Title, External URL

Dataflows

Title, Last modified, Description

Power BI Tables (Datasets and Dataflows)

Title, Is hidden, Description

Power BI Columns

Title, Data type, Column type, Is hidden, Expression

Tabular file

File path, File name

File directory

Directory path

Database

Title, Type, Identifier, Server, Port

Database Schema

Title

Database Table

Title

Database Column

Title, Type

Table

Title

Column

Title, Type



Relationships between objects

By default, the data.world catalog will include catalog pages for the resource types below. Each catalog page will have a relationship to other related resource types. Note that the catalog presentation and relationships are fully configurable, so these will list the default configuration.

Table 2.

Resource page

Relationship

App

Report, Dashboard, Workspace

Power BI Column

Power BI Table

Data source

Dataset, Dataflow, Connection Details (kind and path), Tabular Data source (Database, Tabular File)

Tile

Dashboard, Report

Dashboard

Tile, Workspace

Report

Tile, Workspace, Report pages, Dataset

Report Pages

Report

Dataset

Tile, Workspace, Report, Table, Data source, Dataset

Workspace

Report, Dataset, Dataflow, Dashboard, App

Dataflow

Workspace, Table, Data source, Dataflow

Power BI Table

Dataset, Dataflow, Power BI Column

Tabular Data source (Database, Tabular File)

Data source



Lineage for Power BI

The following lineage information is collected by the Power BI collector.

Table 3.

Object

Lineage available

Report

Associated Dataset

Dashboard Tile

Associated Dataset

Dataset

Associated Dataflow, Dashboard Tile, Report, and Dataset

Dataflow

Associated Column, Dataset, and Dataflow

Note: The collector is able to harvest lineage from Power BI expressions which use parameters in place of database server name, schema name, database table, or database name.

Column

Associated columns that the column sources its data from or calculates its values from.

Notes:

  • The collector is able to harvest lineage from Power BI expressions which use parameters in place of database server name, schema name, database table, or database name.

  • Column level lineage and catalog relationships are not available between columns (fields) and reports/report pages through the Power BI API.



Version supported

  • The collector supports Power BI Cloud API v 1.0.

Authentication supported

There are two separate ways to authenticate to Power BI:

  • Service principal

  • User and password

The collector will harvest metadata for all Power BI apps and workspaces to which the supplied account has access.