This article describes how to deploy and execute the Deliver instance to the Power BI Premium XMLA Read/Write Endpoint.

Configure Power BI

1. Login to app.powerbi.com
2. Select the workspace where the Deliver instance will be deployed to:
   1. Go to Workspace Settings
   2. Click the Premium tab
   3. Select the Premium per user or Premium per capcity License mode (this requires a Premium license)
   4. Copy the workspace connection.

      

       

1. Go to the admin portal

   

2. Under, Premium Per User / Dataset workload settings, Set XMLA to "Read Write". 

Add Power BI Premium Deliver Instance Endpoint

In the Portal, add a Deliver instance, and add a Power BI Premium endpoint

1. Name: Give your endpoint a friendly name that will appear in TimeXtender Data Integration.
2. Server: paste the Workspace Connection URL copied from the Power BI workspace.
3. Dataset: This is the name for the Power BI Dataset,
4. Username & Password: The credentials used to log onto app.powerbi.com (i.e. email and password).  Alternatively, you can Authenticate using a Service Principal.
5. Click Save. 

   

Deploying the endpoint in TimeXtender Data Integration

1. In TimeXtender Data Integration, click Refresh to show the newly created Deliver instance and endpoint.

   

2. Right click on the Deliver instance and select Open instance.

   

3. Drag the tables from the Prepare instance into the Deliver instance. Right click on the instance and select Deploy.

Configure the Power BI Data Source Credential

If you receive an authentication error when you first attempt to execute your model, you may need to update your your data source credentials:

1. Go to the Data Model, click the 3 dots, click Settings

   

2. Under data source credentials, select Edit credentials and enter the credentials for the Prepare instance storage.

   

3. If you are unable to successfully edit the data source credentials, try to take over the dataset settings first and then edit the credentials:

   

4. Go back into TimeXtender Data Integration, right-click on the Deliver Instance and select Execute.

Note: if you are using an on-premise SQL Server storage for the Prepare instance(s), you will have to install the Power BI gateway and choose this gateway in the Power BI service

 

(Optional) Authenticate using a Service Principal 

In order for your Deliver instance executions to not be dependent on the credentials of a single individual you can authenticate to Power BI using an Azure Service Principal or App Registration. Read more about this from Microsoft Docs.

Create an App Registration in Azure

1. In the Azure Portal navigate to Azure Active Directory (Take note, of the Tenant ID, this will be used as part of your username later).
2. Click App Registrations, click New Registration (Take note of the App ID, this will be used as part of your username later).
3. Once App Registration is created, click Certificate & Secrets, New Client Secret (Take note of the client secret, this will be used as your password later).
4. Click API permissions, Add a permission, then add the below permissions.

Allow service principals to use Power BI APIs

1. Navigate to Power BI Admin Portal > Tenant settings
2. Enable the option: Allow service principals to use Power BI APIs 
3. Under Apply to, select The entire organization. Alternatively, Select Specific security groups, and ensure the app registration is added to the defined security group.

Give your App Registration Admin Access

1. In Power BI, Open your Workspace.
2. Click Access
3. Enter the name of the App Registration, Set the role to Admin, then click Add.

Update Credentials in Deliver instance

1. Open your Deliver Instance in the Portal, Click Edit.
2. Edit the Credentials of your Power BI Premium Endpoint:
3. Username: enter app:<appId>@<tenantId>
4. Password: enter the <app client secret>.
5. Click Save