Power BI Update

Overview

The Power BI Update Snap updates datasources in Microsoft Power BI.


Power BI Update Snap overview

Snap views

Type Description Examples of upstream and downstream Snaps
Input

This Snap has exactly one document input view.

Expected input: A document containing the ID of the entity to update along with the data to update.
Output

This Snap has at most one document output view.

Expected output: A document containing details of the updated entity.
Learn more about Error handling.

Snap settings

Note: Learn about the common controls in the Snap settings dialog.
Field/Field set Description

Label

String 		Specify a unique name for the Snap. Modify this to be more appropriate, especially if there are more than one of the same Snap in the pipeline.

Default value: Power BI Update

Example: Update Employee Record

Workspace

String/Expression/ Suggestion 		Required. Enter the workspace in which to update the resource. Alternatively, click the Suggest icon to fetch a list of workspaces associated with the Power BI account and select the workspace.

Default value: My Workspace

Example: Employee Records

Entity type

Dropdown list 		Required. Select the entity type to update.

Available options are:

  • Dataset: Collection of tables from different data sources ready for reporting and visualizations.
  • Report: Visualized interpretations, findings, and insights of a dataset. A report can include many pages.
  • Gateway: Connections between Power BI's cloud-based analysis service and on-premise data sources.
  • Dataflow: Collection of entities (tables) that you create and manage in workspaces.

Default value: Dataset

Example: Report

Entity operation

Dropdown list 		Select the update operation to perform. The available options vary upon your configuration of the Entity type field. Alternatively, you can also enter the operation's name manually.

The available options are:

  • Dataset
    • Update Datasources
    • Update Direct Query Refresh Schedule
    • Update Parameters
    • Update Refresh Schedule
  • Report
    • Update Report Content
  • Gateway
    • Update Datasource

Default value: N/A

Example: Update Datasources
Connection details Use this field set to configure the network connection parameters.

This field set contains the following fields:

  • Connection timeout
  • Number of retries
  • Retry interval (seconds)

Connection timeout

Integer/Expression 		Required. Specify the connection timeout duration in seconds.

Default value: 0

Example: 30

Number of retries

Integer/Expression 		Required. Specify the maximum number of re-connections if the connection fails or is timed-out.

Default value: 10

Example: 4

Retry interval (seconds)

Integer/Expression 		Required. Specify the interval in seconds between reconnections.

Default value: 10

Example: 30

Snap execution

Dropdown list
Choose one of the three modes in which the Snap executes. Available options are:
  • Validate & Execute: Performs limited execution of the Snap and generates a data preview during pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during pipeline runtime.
  • Execute only: Performs full execution of the Snap during pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Default value: Execute only

Troubleshooting

Error Cause Resolution
HTTP Response Exception:400 Invalid OAuth endpoint/token URL. Verify the values of the OAuth2 endpoint or token URLs in the account settings.
HTTP Response Exception:401 Invalid refresh token or access token. Verify the values of the refresh or access tokens in the account settings.
HTTP Response Exception:409 Conflict Verify the network and Snap settings.
Property value is missing. Your input for 'Workspace'/'Entity id' is missing. Required fields cannot be blank. Verify whether you have configured all required fields correctly.