Power BI Delete

Overview

The Power BI Delete Snap deletes the specified data resource from a selected workspace.


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

Output

This Snap has exactly one document output view.

Expected output: A document containing the API response from the server indicating whether the delete operation was a success.

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 Delete

Example: Delete Employee Record

Workspace

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

String
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.

Default value: Dataset

Example: Report

Entity operation

String
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)

Default value: N/A

Example: Delete Dataset

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
Required. Specify the connection timeout duration in seconds.

Default value: 0

Example: 30

Number of retries

Integer
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
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.