Power BI Push Dataset

Power BI Push Dataset

In this article

Overview

Use this Snap to create a new dataset, update the metadata and schema for the specified table within the specified dataset , and add new data rows to the specified table within the specified dataset in the workspace.

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines

Limitations

None.

Known Issues

None.

Snap Input and Output

Input/Output

Type of View

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input/Output

Type of View

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Copy Snap

A document containing details of the entity and/or table to create or update.

Output

Document

  • Min: 1

  • Max: 1

  • Mapper Snap

  • Copy Snap

A document containing the success/failure confirmation of the push operation along with details of the impacted dataset/table.

Snap Settings

Parameter Name

Data Type

Description

Default Value

Example 

Parameter Name

Data Type

Description

Default Value

Example 

Label

String

Power BI Push Dataset

Update Dataset

Workspace

String

Required. Enter the workspace from which to read the resource. Alternatively, click the 

 icon to fetch a list of workspaces associated with the Power BI account and select the workspace. 

N/A

Employee Records

Entity type

String

Required. Select the entity type to read.

Available options are:

  • Post Dataset: Creates a dataset in the workspace.

  • Post Rows: Alters the metadata of a specific table under a designated dataset.

  • Put Tables: Adds rows to a specific table under a designated dataset.

Post Dataset

Post Rows

Entity id

String

Required if you select the Post Rows or Put Tables option in the Entity type field.

Enter the ID of the dataset to modify the table's metadata or to add rows to the tables. Alternatively, click the 

 icon to fetch the IDs of all datasets available in the workspace. 

This field is shown dynamically according to different entity types from the suggestions. Users are allowed to choose an entity id from the suggestion or type an entity manually. The entity is shown as "[dataset name]  ([dataset id])" in the suggestions. But it is also allowed to type only [dataset id] in this field.

In order to get table name suggestions, you have to select the dataset id. 

N/A

SalesMarketingDataset (XXXXXXXXXXXXX) or XXXXXXXXXXXXX

Table name

String

Required if you select the Post Rows or Put Tables option in the Entity type field.

Enter the name of the target table. Alternatively, click the 

 icon to fetch the IDs of all tables available in the workspace. 

N/A

Designations

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

Integer

Required. Specify the connection timeout duration in seconds.

0

30

Number of retries

Integer

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

10

4

Retry interval (seconds)

Integer

Required. Specify the interval in seconds between reconnections.

10

30

Snap Execution

String

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 only

Validate & Execute

Troubleshooting

Error

Reason

Resolution

Error

Reason

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. 

Invalid input.

Your input in the Get object field is invalid.

Verify whether you have entered it correctly. Alternatively, select it from the drop-down list to avoid any human errors.

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.