Overzicht van Power Query SDK

  • Artikel

De Power Query SDK is een set hulpprogramma's die zijn ontworpen om u te helpen bij het maken van Power Query-connectors. Deze connectors worden vaak aangepaste connectors of Power Query-extensies genoemd.

Met aangepaste connectors kunt u nieuwe gegevensbronnen maken of een bestaande bron aanpassen en uitbreiden. Veelvoorkomende gebruiksvoorbeelden zijn:

  • Een bedrijfsanalistvriendelijke weergave maken voor een REST API.
  • Huisstijl bieden voor een bron die door Power Query wordt ondersteund met een bestaande connector (zoals een OData-service of ODBC-stuurprogramma).
  • OAuth v2-verificatiestroom implementeren voor een SaaS-aanbieding.
  • Het weergeven van een beperkte of gefilterde weergave over uw gegevensbron om de bruikbaarheid te verbeteren.
  • DirectQuery inschakelen voor een gegevensbron met behulp van een ODBC-stuurprogramma.

De Power Query SDK installeren

Er zijn momenteel twee versies van de Power Query SDK beschikbaar:

  • Visual Studio Power Query SDK: uitgebracht in 2017 als een extensie voor Visual Studio 2017 en 2019.
  • Visual Studio Code Power Query SDK (preview): uitgebracht in 2022 als de nieuwe en aanbevolen manier om Power Query-connectors te maken.

We raden alle ontwikkelaars aan om de zojuist uitgebrachte Visual Studio Code Power Query SDK (preview) te installeren en te gebruiken, omdat deze versie uiteindelijk de standaard-SDK is.

Visual Studio Power Query SDK

Volg de onderstaande stappen om de Visual Studio Power Query SDK te installeren:

  1. Installeer de Power Query SDK vanuit Visual Studio Marketplace.
  2. Maak een nieuw gegevensconnectorproject.
  3. Definieer de connectorlogica.
  4. Bouw het project om een extensiebestand te produceren.

Preview-functie.

Visual Studio Code Power Query SDK (preview)

Notitie

De nieuwe Visual Studio Code Power Query SDK is momenteel beschikbaar als openbare preview vanaf september 2022.

Installeer de nieuwe Visual Studio Code Power Query SDK vanuit de sectie Visual Studio Code van Visual Studio Marketplace. Selecteer Installeren om de SDK te installeren.

Verbinding maken or ontwikkelingsproces

Hoewel u de Visual Studio Code of de Visual Studio Power Query SDK kunt gebruiken, gebruiken beide een vergelijkbaar proces voor de ontwikkeling van een connector op hoog niveau.

In de volgende secties wordt op hoog niveau het meest voorkomende proces beschreven voor het maken van een Power Query-connector met behulp van de SDK.

Een nieuwe extensie maken

Wanneer u een nieuw project maakt (Visual Studio Power Query SDK) of een nieuwe werkruimte (Visual Studio Code Power Query SDK), begint u met de volgende kernbestanden:

  • Verbinding maken of definitiebestand (<connectorName.pq>)
  • Een querybestand (<connectorName.query.pq>)
  • Een tekenreeksresourcebestand (resources.resx)
  • PNG-bestanden van verschillende grootten die worden gebruikt om pictogrammen te maken

Het definitiebestand van de connector begint met een lege beschrijving van de gegevensbron. Meer informatie over een gegevensbron vindt u in de context van de Power Query SDK in het artikel over het verwerken van gegevenstoegang.

Testen

De Power Query SDK biedt eenvoudige mogelijkheden voor het uitvoeren van query's, zodat u uw extensie kunt testen zonder over te schakelen naar Power BI Desktop.

Querytestbestand

Naast het extensiebestand kunnen Data Verbinding maken or-projecten een querybestand (name.query.pq) hebben. Dit bestand kan worden gebruikt om testquery's uit te voeren in Visual Studio. De queryevaluatie bevat automatisch uw extensiecode, zonder dat u uw.pqx-bestand hoeft te registreren, zodat u gedeelde functies in uw extensiecode kunt aanroepen of testen.

Het querybestand kan één expressie bevatten (bijvoorbeeld HelloWorld.Contents()), een let expressie (zoals wat Power Query zou genereren) of een sectiedocument.

Bouwen en implementeren

Het bouwen van uw project produceert uw .mez-bestand of extensiebestand.

Power Query-extensies worden gebundeld in een ZIP-bestand en krijgen een mez-bestandsextensie. Tijdens runtime laadt Power BI Desktop extensies van [Documenten]\Microsoft Power BI Desktop\Aangepaste Verbinding maken ors.

Notitie

Gegevens Verbinding maken orprojecten bieden geen ondersteuning voor aangepaste stappen na het bouwen om het extensiebestand te kopiëren naar de map [Documents]\Microsoft Power BI Desktop\Custom Verbinding maken ors. Als dit iets is wat u wilt doen, kunt u een extensie van derden gebruiken.

Extensies worden gedefinieerd in een M-sectiedocument. Een sectiedocument heeft een iets andere indeling dan de querydocument(en) die zijn gegenereerd in Power Query. Code die u importeert vanuit Power Query, moet doorgaans worden aangepast aan een sectiedocument, maar de wijzigingen zijn minder groot. Verschillen in sectiedocument die u moet kennen, zijn onder andere:

  • Ze beginnen met een sectiedeclaratie (bijvoorbeeld section HelloWorld;).
  • Elke expressie eindigt met een puntkomma (bijvoorbeeld a = 1; of b = let c = 1 + 2 in c;).
  • Alle functies en variabelen zijn lokaal in het sectiedocument, tenzij ze zijn gemarkeerd als gedeeld. Gedeelde functies worden zichtbaar voor andere query's/functies en kunnen worden beschouwd als de exports voor uw extensie (dat wil gezegd, ze kunnen worden aangeroepen vanuit Power Query).

Meer informatie over M-sectiedocumenten vindt u in de M-taalspecificatie.

Distributie van gegevensconnectors

Power Query-connectors kunnen worden gebruikt in Power BI Desktop of de Power Query Online-ervaring, zoals Power BI-gegevensstromen, Power BI-gegevensmarts en andere ervaringen.

Power BI Desktop

Power BI Desktop-gebruikers kunnen de onderstaande stappen volgen om een aangepaste Power Query-connector te gebruiken:

  1. Kopieer het extensiebestand (.mez or.pqx) naar [Documents]/Power BI Desktop/Custom Verbinding maken ors.
  2. Selecteer in Power BI Desktop de optie (Niet aanbevolen) Toestaan dat een extensie wordt geladen zonder validatie of waarschuwing onder Bestandsopties>en instellingen>Opties>voor beveiligingsgegevensextensies.>
  3. Start Power BI Desktop opnieuw.

In Power BI Desktop worden de extensies automatisch geladen bij het opnieuw opstarten.

Als eigenaar van de gegevensbron en connector kunt u uw connector ook indienen bij het Power Query Verbinding maken or-certificeringsprogramma, zodat deze bij elke release wordt geleverd met Power BI Desktop.

Power Query Online

Notitie

Het Power Query-team werkt hard aan het inschakelen van alle gecertificeerde Power Query-connectors in de Power Query Online-ervaring.

Alleen gecertificeerde Power Query-connectors worden weergegeven in de Power Query Online-ervaring. Ga naar Power Query Verbinding maken or Certification voor meer informatie over het certificeringsprogramma van de Power Query-connector.