Power BI Update

In this article

Overview

Use this Snap to update datasources. 

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines

Limitations

None.

Known Issues

None.

Snap Input and Output

Input/OutputType of ViewNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input 

Document

  • Min: 1
  • Max: 1
  • Mapper Snap
  • Copy Snap
A document containing the ID of the entity to update along with the data to update.
Output

Document

  • Min: 0
  • Max: 1
  • Mapper Snap
  • Copy Snap
A document containing details of the updated entity. 

Snap Settings

Parameter NameData TypeDescriptionDefault ValueExample 
LabelString
Specify a name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.
Power BI UpdateUpdate Employee Record
WorkspaceString

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

My WorkspaceEmployee Records
Entity typeString

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.
DatasetReport
Entity operationString

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
N/AUpdate Datasources
Connection details

Use this field set to configure the network connection parameters.

This field set consists of the following fields:

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

Connection timeout

IntegerRequired. Specify the connection timeout duration in seconds.030

Number of retries

IntegerRequired. Specify the maximum number of re-connections if the connection fails or is timed-out.104

Retry interval (seconds)

IntegerRequired. Specify the interval in seconds between reconnections.1030
Snap ExecutionString

Specifies the execution type:

  • Validate & Execute: Performs limited execution of the Snap (up to 50 records) during Pipeline validation; performs full execution of the Snap (unlimited records) during Pipeline execution.

  • Execute only: Performs full execution of the Snap during Pipeline execution; does not execute the Snap during Pipeline validation.

  • Disabled: Disables the Snap and, by extension, its downstream Snaps.

Execute onlyValidate & Execute

Troubleshooting

ErrorReasonResolution
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:401Invalid refresh token or access token.Verify the values of the refresh or access tokens in the account settings.
HTTP Response Exception:409ConflictVerify 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. 

Examples

Updating a Dataset's Refresh Schedule

We want to update a specific dataset's refresh schedule. This Pipeline demonstrates how we can use the Power BI Update Snap to accomplish this task.

To update any resource, we need:

  • The resource's identifier, or entity ID, and
  • The data to update, in this case, the refresh schedule

Since we do not have the entity ID, we use the Power BI Read Snap to first retrieve the entity's details. Otherwise, we can just include the entity's ID along with the data to update.

We configure the JSON Generator Snap to output the latest refresh schedule that we want to update. The screenshot below shows this data:

The outputs from the Power BI Read and JSON Generator Snaps are joined using the Join Snap. The Join Snap's output, which is the entity ID from the Power BI Read Snap and the updated refresh schedule from the JSON Generator Snap, are sent to the Mapper Snap.

We need the Mapper Snap to map the data to its corresponding fields in the dataset's schema. Accordingly, we configure the Mapper Snap as shown below:

Lastly, we add the Power BI Update Snap to the Mapper Snap's output. We configure the Power BI Update Snap based on our requirements as shown in the screenshot below:

Upon successful execution, the Power BI Update Snap updates the target dataset with the updated data.

Download this Pipeline.

Downloads

Important steps to successfully reuse Pipelines

  1. Download and import the Pipeline into SnapLogic.
  2. Configure Snap accounts as applicable.
  3. Provide Pipeline parameters as applicable.

Snap Pack History

 Click here to expand...

Release

Snap Pack Version 

Date

Type

Updates

February 2024main168 StableUpdated and certified against the current SnapLogic Platform release.
November 2023main155StableUpdated and certified against the current SnapLogic Platform release.

August 2023

main138

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023

main130 

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023main114 StableUpgraded with the latest SnapLogic Platform release.
November 2022main113 StableUpgraded with the latest SnapLogic Platform release.
August 2022

main111

 StableUpgraded with the latest SnapLogic Platform release.
4.29main108 StableUpgraded with the latest SnapLogic Platform release.
4.28main100  StableUpgraded with the latest SnapLogic Platform release.
4.27main93 

Stable

Upgraded with the latest SnapLogic Platform release.
4.26main88StableUpgraded with the latest SnapLogic Platform release.
4.25main80 StableNo updates made.
4.24patchesmain80 LatestEnhanced the following Snaps in the Microsoft Power BI Snap Pack by supporting data flows with two options, Dataflow and Dataflow Storage Accounts.
4.23main76 LatestUpdated the dependencies and documentation links for all the Microsoft Power BI Snaps.

4.23

main73


Latest

Introduced the Microsoft Power BI Snap Pack that enables you to access and control entities such as datasets, reports, gateways, and dashboards in the workspace. The Microsoft Power BI Snap Pack contains the following Snaps:


See Also