Installation af Power Query SDK

Hurtig start

1. Installér Power Query SDK'et Visual Studio Marketplace.
2. Opret et nyt dataforbindelsesprojekt.
3. Definer din connectorlogik.
4. Byg projektet for at oprette en udvidelsesfil.
5. Kopiér udvidelsesfilen til [Dokumenter]/Power BI Desktop/Brugerdefinerede connectors.
6. Markér indstillingen (Anbefales ikke) Tillad indlæsning af en hvilken som helst udvidelse uden validering eller advarsel i Power BI Desktop (under | Indstillinger for | Indstillinger | Sikkerhedsindstillinger | Dataudvidelser).
7. Genstart Power BI Desktop.

Distribution af dataforbindelser

Power BI Desktop brugere kan downloade udvidelsesfiler og placere dem i en kendt mappe (trin som beskrevet ovenfor). Power BI Desktop indlæser automatisk udvidelserne ved genstart.

Yderligere links og ressourcer

• Funktioner i M-bibliotek
• M-sprogspecifikation
• Power BI Developer Center
• Selvstudium med dataforbindelse

Trin for trin

Oprettelse af en ny udvidelse i Visual Studio

Hvis du installerer Power Query SDK til Visual Studio oprettes der en ny dataforbindelsesprojektskabelon i Visual Studio.

Dette opretter et nyt projekt, der indeholder følgende filer:

• Connectordefinitionsfil <connectorName> (.pq)
• En testfil til forespørgsler <connectorName> (.query.pq)
• En strengressourcefil (resources.resx)
• PNG-filer af forskellig størrelse, der bruges til at oprette ikoner

Connectordefinitionsfilen starter med en tom beskrivelse af datakilden. Se afsnittet Datakilde slags senere i dette dokument for at få flere oplysninger.

Test i Visual Studio

Sdk'Power Query leverer grundlæggende egenskaber til udførelse af forespørgsler, så du kan teste din udvidelse uden at skulle skifte til Power BI Desktop. Se Forespørgselsfil for at få flere oplysninger.

Byg og udrul fra Visual Studio

Når du bygger dit projekt, produceres din .pqx-fil.

Data Connector-projekter understøtter ikke brugerdefinerede trin til efter build, hvor du kan kopiere udvidelsesfilen til mappen [Documents]\Microsoft Power BI Desktop\Custom Connectors. Hvis det er noget, du vil gøre, kan du bruge en tredjepartsudvidelse Visual Studio, f.eks. Installér automatisk.

Udvidelsesfiler

Power Query er samlet i en ZIP-fil og har fået et .mez-filtypenavn. På kørselstidspunktet indlæser Power BI Desktop udvidelser fra [Documents]\Microsoft Power BI Desktop\Custom Connectors.

Udvidelsesfilformat

Udvidelser defineres i et dokument til M-afsnittet. Et afsnitsdokument har et lidt andet format end det eller de forespørgselsdokumenter, der er oprettet Power Query. Kode, du importerer fra Power Query kræver typisk ændringer, der passer til et afsnitsdokument, men ændringerne er mindre. Forskelle i afsnitsdokument, som du skal være opmærksom på skal du være opmærksom på:

• De starter med en afsnitserklæring (f.eks. section HelloWorld; ).
• Hvert udtryk slutter med et semikolon (f.eks. a = 1; eller b = let c = 1 + 2 in c; ).
• Alle funktioner og variabler er lokale for afsnitsdokumentet, medmindre de er markeret som delte. Delte funktioner bliver synlige for andre forespørgsler/funktioner og kan tænkes på, når eksporten for din udvidelse (hvilket vil sige, at de kan kaldes fra Power Query).

Du kan finde flere oplysninger om dokumenter i M-afsnittet i M-sprogspecifikationen.

Forespørgselsfil

Ud over udvidelsesfilen kan Data Connector-projekter have en forespørgselsfil (name.query.pq). Denne fil kan bruges til at køre testforespørgsler inden for Visual Studio. Evalueringen af forespørgslen inkluderer automatisk din udvidelseskode, uden at du skal registrere din PQX-fil, så du kan kalde/teste alle delte funktioner i din udvidelseskode.

Forespørgselsfilen kan indeholde et enkelt udtryk (f.eks. ), et udtryk (f.eks hvad HelloWorld.Contents() let Power Query genererer) eller et afsnitsdokument.