Skip to content
Power BI Custom Connector for loading tables directly from Tabular Data Packages (Frictionless Data) into Power BI
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
DataPackage
distributable
examples
images
.gitattributes
.gitignore
LICENSE.txt
README.md

README.md

Data Package Connector (datapackage-connector)

A Power BI Custom Connector based on the Data Package M (datapackage-m) functions. Data Package Connector enables you to load one or more tables from Tabular Data Packages directly into Power BI through the familiar 'Get Data' experience.

Not familiar with Power BI? You can learn about it here.

What is Frictionless Data?

Frictionless Data

A Tabular Data Package is a simple format for publishing and sharing tabular data. Tabular Data Packages extend and specialise the Data Package specification, and both come under the umbrella of Frictionless Data.

Below is the vision statement taken from the Frictionless Data website:

Frictionless Data shortens the path from data to insight with a collection of specifications and software for the publication, transport, and consumption of data. At the heart of our approach is a deep understanding of the multi-faceted nature of data work, and an emphasis on platform-agnostic interoperability. From consumer spreadsheet software, through to cloud-based services for data analysis, the future of data is frictionless.

Visit https://frictionlessdata.io to learn more.

Data Package Connector in Power BI Desktop

Microsoft Power BI UI: Data Package Connector in Action in Power BI

Microsoft Power BI UI: Get Data UI
Easily load Data Packages through the 'Get Data' UI

Microsoft Power BI UI: Resource Navigation
Data Package Connector is stable but it's still under development

Microsoft Power BI UI: GDP Tabular Data Package Resource Data
Specify a valid Data Package identifier and whether to respect the Table Schema

Microsoft Power BI UI: GDP Tabular Data Package Visualisation
Connects using anonymous authentication

Microsoft Power BI UI: GDP Tabular Data Package Visualisation
Select the tables (i.e. Data Resources) that you want to load/edit and the rest is history

Data Package Connector Functions

Function Name Description
DataPackage.Load Returns a Navigation Table (i.e. table) that lists the Data Resources contained within a Data Package. This function wraps DataPackage.Tables but expects the ignoreTableSchemaTypes parameter to be a text representation of a logical instead of an actual logical value. The text value is casted to a logical value before calling DataPackage.Tables. See Data Package M (datapackage-m) to learn more about DataPackage.Tables function.

DataPackage.Load

Parameter Type Description
dataPackageIdentifier text A valid Data Package Identifier
ignoreTableSchemaTypes text Controls whether the Table Schema is applied to the data. This must have a value that can be casted to a logical value using the Logical.From function in the standard Power Query M library e.g. 'true' or 'false'.

Only data resources that are detected as being tabular (i.e. contain a table value in their 'Data' column) are returned by this function.

Setup

  1. Download the latest release release.
  2. Extract the 'DataPackage.mez' Power BI extension file from the 'distributable' folder.
  3. Follow these instructions on how to use Power BI Custom Connectors with Power BI Desktop.
  4. Follow these instructions on how to use Power BI Custom Connectors with the Power BI On-premises Data Gateway.

Try Data Package Connector with the Core Datasets

Licensing

This work was created by Nimble Learn and has been published with the MIT License. The full license can be viewed in plain text.

Notes

  • When prompted for the 'Privacy Level' choose either 'Public' or 'Organizational'.

  • If the field values in a CSV file do not match the expected field type, as defined in the Table Schema, the invalid values in the column will return an error (Expression.Error). You can get around this by setting the ignoreTableSchemaTypes parameter to true.

Known Issues

There are no currently known issues.

You can’t perform that action at this time.