Power BI Connection
This article describes how to connect to Power BI for data processing and catalog.
If you’re looking to connect Power BI for lineage, see Power BI Lineage Scanner.
Availability
| Data processing & catalog | Edge processing | Lineage | Exceptions |
|---|---|---|---|
✗ |
✗ |
✔ |
Doesn’t support:
|
Prerequisites
-
Review how sources and connections work.
-
Create a source to add this connection to.
-
Configure a service principal for Power BI API access. See Configure Power BI API access.
Configure Power BI API access
To connect ONE to Power BI, you need to configure a service principal with the required permissions.
Follow the Microsoft documentation to complete these steps:
-
Register an application in Microsoft Entra ID and create a client secret.
-
Create a security group and add your application as a member.
-
Enable Power BI service admin settings – In the Power BI Admin portal, enable the following for your security group:
-
Service principals can use Fabric APIs
-
Allow service principals to create and use profiles
-
Allow service principals to use read-only Power BI admin APIs
-
-
Add the service principal to your workspace as a member or admin.
After completing these steps, note the Application (client) ID, Client secret, and Directory (tenant) ID from your app registration. You’ll need these when configuring credentials in ONE.
Add a connection
-
Go to [your source] > Connections and select Add Connection.
-
In Connection type, select Power BI.
-
Fill in the following:
-
Name: A meaningful name for your connection. Used to indicate the location of catalog items.
-
Description (Optional): A short description of the connection.
-
Power BI app URI: The URL of the Power BI portal (for example,
https://app.powerbi.com). -
Power BI integration URI: The URL of the Power BI backend APIs (for example,
https://api.powerbi.com).
-
Add credentials
| Only Entra ID authentication is supported. |
-
Select Add Credentials.
-
Fill in the following:
-
Name: Provide a clear name for this set of credentials.
-
Description (Optional): Explain what the credentials are used for or provide other useful information.
-
Client ID: The Application (client) ID from your app registration in Azure.
-
Client Secret: The client secret value from your app registration.
Use the secret Value, not the Secret ID. Client secrets expire (maximum 24 months). Plan to renew them before expiration to avoid connection failures.
-
-
To use this set of credentials by default when connecting to the data source, select Set as default.
| One set of credentials must be defined as default for each connection. Otherwise, DQ evaluation fails and previewing data in the catalog (including report previews) is not possible. |
Known limitations
Currently, report thumbnails aren’t shown when viewing all reports (Catalog > Report items).
Was this page useful?