Skip to Content
SourcesPower BI

Power BI

Power BI

Scan Power BI workspaces, datasets, reports, and dashboards.

Category
Analytics & BI
Source type
POWERBI
Produces
item

A BI platform is where warehouse data becomes visible — and where a table with restricted columns turns into a dashboard shared with three hundred people. Scanning Power BI answers a question the warehouse can’t: who is actually looking at this.

What you need to connect

Either a service principal (tenant ID, client ID and secret) or a short-lived access token. For the service principal route, enable service-principal API access in the Power BI admin portal and add the principal to the workspaces you want scanned.

What Classifyre reads

Workspaces, and inside them datasets, reports and dashboards — each a switchable extraction option. Dataset table schemas and owner metadata can be captured too.

Scope by workspace name or id, and choose whether personal workspaces are included.

Metadata on every asset

Asset kind · item

FieldTypeAlways presentWhat it is
workspace_idstringYesPower BI workspace id
workspace_namestringYesWorkspace name
report_typestringYesAsset kind (report/dataset/dashboard)
dataset_idstringNoDataset id
authorstringNoAuthor display name or email

Lineage

Lineage

Power BI is one of the sources that produces genuine lineage:

  • A report or dashboard over its dataset is recorded as lineage — change the dataset and you know exactly which reports are affected.
  • A dataset over its upstream databases is recorded too, named the way the database platform names itself. So a dataset pulling from a Snowflake or SQL Server database links to the real table once that system is scanned — even if it’s scanned months later.
  • A workspace holding a report is containment, not lineage: structural, and used to collapse the graph rather than to add a hop to it.

See Lineage & Relationships.

Worth knowing

  • Personal workspaces are off by default. They’re frequently where ungoverned copies of production data end up.
  • Sovereign clouds are supported by overriding the API and authority URLs.

Configuration

Beyond the fields below, every source also has the settings shared by all of them: the sampling strategy, the detectors to run, the scan schedule, and the compute limits for its scan jobs.

Required

Without these, the source will not save.

This section depends on which authentication method you pick — one of the following applies.

Power BI Service Principal

FieldTypeRequiredWhat it doesDefault
auth_mode"SERVICE_PRINCIPAL"Yes
tenant_idstringYesAzure tenant identifier
client_idstringYesAzure app client identifier

Power BI Access Token

FieldTypeRequiredWhat it doesDefault
auth_mode"ACCESS_TOKEN"Yes

Secrets

Stored encrypted and never shown again after you save them. See Configuration & Fields.

This section depends on which authentication method you pick — one of the following applies.

Power BI Client Secret

FieldTypeRequiredWhat it doesDefault
client_secretstringYesAzure app client secret for service principal auth

Power BI Access Token

FieldTypeRequiredWhat it doesDefault
access_tokenstringYesBearer token for PowerBI API access

Optional

Everything you can tune. Sensible defaults apply when you leave them alone.

FieldTypeRequiredWhat it doesDefault
optionalobjectNono extra properties
connectionobjectNoPowerBI API endpoint and timeout controls.no extra properties
connection.api_base_urlstringNoPowerBI REST API base URLformat urihttps://api.powerbi.com/v1.0/myorg
connection.authority_urlstringNoAuthority base URL for Microsoft Entra token issuanceformat urihttps://login.microsoftonline.com
connection.timeout_secondsintegerNoHTTP timeout for PowerBI API callsmin 5, max 30030
extractionobjectNoFeature flags that control PowerBI entities to extract.no extra properties
extraction.extract_dashboardsbooleanNoExtract PowerBI dashboardstrue
extraction.extract_dataset_schemabooleanNoAttempt to extract PowerBI dataset table schema metadatatrue
extraction.extract_datasets_to_containersbooleanNoEmit dataset metadata suitable for container groupingfalse
extraction.extract_ownershipbooleanNoExtract workspace/report/dataset owner metadatafalse
extraction.extract_reportsbooleanNoExtract PowerBI reportstrue
extraction.extract_workspaces_to_containersbooleanNoEmit workspace metadata suitable for container groupingtrue
scopeobjectNoWorkspace scope controls for PowerBI ingestion.no extra properties
scope.include_personal_workspacesbooleanNoInclude personal workspaces when truefalse
scope.workspace_idsarrayNoOptional allowlist of workspace IDs to scan
scope.workspace_ids[]stringNo
scope.workspace_namesarrayNoOptional allowlist of workspace names to scan
scope.workspace_names[]stringNo
Last updated on