Power BI Delete

In this article

Overview

Use this Snap to delete the specified data resource from a selected workspace.

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 details of the data resource to delete. 
Output

Document

  • Min: 1
  • Max: 1
  • Mapper Snap
  • Copy Snap
A document containing the API response from the server indicating whether the delete operation was a success.

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 DeleteDelete Employee Record
WorkspaceString

Required. Enter the workspace from which to delete 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 delete.

Available options are:

  • Dataset: Collection of tables from different data sources ready for reporting and visualizations.
  • Report: Interprets findings and insights of a dataset into visuals from varied perspectives.
  • Gateway: Connects Power BI cloud-based analysis service to on-premise data sources.
  • Dataflow: Collection of entities (tables) that you create and manage in workspaces.
DatasetReport
Entity operationString

Select the delete 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.

Available options are:

  • Delete Dataset (Entity type: Dataset)
  • Delete Report (Entity type: Report)
  • Delete Datasource User (Entity type: Gateway)
  • Delete Datasource (Entity type: Gateway)
N/ADelete Dataset
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.

Examples

Deleting Dataset from a Workspace

We want to delete the dataset named SalesMarketing from the workspace My Workspace. This Pipeline demonstrates how we can use the Power BI Read and Power BI Delete Snaps to accomplish this task:

 

We must first pass the target entity's ID to the Power BI Delete Snap. To do so, we use the Power BI Read Snap and configure it to read the SalesMarketing dataset in the My Workspace workspace as shown below:

We configure a Mapper Snap to pass the Entity id from the Power BI Read Snap's output to the Power BI Delete Snap as shown below:

Finally, we configure the Power BI Delete Snap to delete the Dataset entity type from the My Workspace workspace.

Upon successful execution, the Power BI Snap deletes the specified entity from the workspace and displays a confirmation as shown below:

We then write the above confirmation into a local file using a combination of the JSON Formatter and File Writer Snaps. This step is optional and you may choose to omit it.

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.

  File Modified

File Example_PowerBI_Delete_Dataset_.slp

Mar 02, 2022 by Subhajit Sengupta

Snap Pack History

 Click here to expand...

Release

Snap Pack Version 

Date

Type

Updates

November 2024main182 StableUpdated and certified against the current SnapLogic Platform release.

August 2024

main180

 


Stable

Updated and certified against the current SnapLogic Platform release.

May 2024main172 StableUpdated and certified against the current SnapLogic Platform release.
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