Udvikl en connector ved hjælp af Power Query SDK
Power Query SDK er et sæt værktøjer, der er udviklet til at hjælpe dig med at oprette Power Query-connectors. Disse connectors kaldes ofte brugerdefinerede connectors eller Power Query-udvidelser.
Med brugerdefinerede connectors kan du oprette nye datakilder eller tilpasse og udvide en eksisterende kilde. Almindelige use cases omfatter:
- Oprettelse af en virksomhedsanalytikervenlig visning for en REST-API.
- Angivelse af branding for en kilde, som Power Query understøtter med en eksisterende connector (f.eks. en OData-tjeneste eller ODBC-driver).
- Implementering af OAuth v2-godkendelsesflow for et SaaS-tilbud.
- Eksponering af en begrænset eller filtreret visning over din datakilde for at forbedre anvendeligheden.
- Aktivering af DirectQuery for en datakilde ved hjælp af en ODBC-driver.
Installér Visual Studio Code Power Query SDK fra afsnittet Visual Studio Code på Visual Studio Marketplace. Vælg Installér for at installere SDK'et.
I følgende afsnit beskrives på et højt niveau den mest almindelige proces til oprettelse af en Power Query-connector ved hjælp af SDK'et.
Når du opretter et nyt arbejdsområde (Visual Studio Code Power Query SDK), starter du med følgende kernefiler:
- Connectordefinitionsfil (<connectorName.pq>)
- En forespørgselsfil (<connectorName.query.pq>)
- En strengressourcefil (resources.resx)
- PNG-filer i forskellige størrelser, der bruges til at oprette ikoner
Din connectordefinitionsfil starter med en tom beskrivelse af datakilden. Du kan få mere at vide om en datakilde i forbindelse med Power Query SDK fra artiklen om håndtering af dataadgang.
Power Query SDK indeholder grundlæggende funktioner til udførelse af forespørgsler, så du kan teste din udvidelse uden at skulle skifte til et andet klientprogram. Du kan teste din connector yderligere i et program, f.eks.:
Ud over filtypenavnet kan Data Connector-projekter have en forespørgselsfil (name.query.pq). Denne fil kan bruges til at køre testforespørgsler i Visual Studio Code. Forespørgselsevalueringen inkluderer automatisk din udvidelseskode uden at skulle registrere din.pqx-fil, så du kan kalde eller teste eventuelle delte funktioner i din udvidelseskode.
Forespørgselsfilen kan indeholde et enkelt udtryk (f.eks. HelloWorld.Contents()
), et let
udtryk (f.eks. hvad Power Query ville generere) eller et sektionsdokument.
Når du bygger dit projekt, oprettes .mez-filen eller filtypenavnet. Power Query-udvidelser er samlet i en ZIP-fil og får filtypenavnet .mez.
Udvidelser er defineret i et M-sektionsdokument. Et sektionsdokument har et lidt andet format end det eller de forespørgselsdokument(er), der er oprettet i Power Query. Kode, du importerer fra Power Query, kræver typisk ændringer for at passe til et sektionsdokument, men ændringerne er mindre. Sektionsdokumentforskelle, du skal være opmærksom på, omfatter:
- De starter med en sektionserklæring (f.eks.
section HelloWorld;
). - Hvert udtryk slutter med et semikolon (f.eks
a = 1;
. ellerb = let c = 1 + 2 in c;
). - Alle funktioner og variabler er lokale for sektionsdokumentet, medmindre de er markeret som delt. Delte funktioner bliver synlige for andre forespørgsler/funktioner og kan opfattes som eksporter for din udvidelse (dvs. de kan kaldes fra Power Query).
Du kan finde flere oplysninger om M-sektionsdokumenter i M-sprogspecifikationen.
Du har to stier, hvor du kan distribuere din connector:
- Selvdistribution
- Connectorcertificering
En selvbetjeningsmekanisme, hvor du kan anvende brugerdefinerede Power Query-connectors i relevante produktoplevelser
Når din connector er oprettet, kan du sende denne fil, som du ønsker, til dine brugere, og de kan bruge connectoren i relevante produktoplevelser, f.eks. Microsoft Power BI.
Du kan bruge din egen brugerdefinerede connector i Microsoft Power BI Desktop og Microsoft Power BI-tjenesten til semantiske modeller til opdatering og forbindelse i cloudmiljøet.
Power Query-connectors kan indlæses i tre oplevelser:
- Datagateway i det lokale miljø: Din connector kan indlæses via gatewayen, der skal bruges i Microsoft Fabric og Microsoft Power BI-tjeneste s
- Power Query Online: i oplevelser som Power BI Datamarts, Fabric Dataflow Gen2 og mange andre
- Power Query Desktop: i oplevelser som Power BI Desktop.
Du kan få mere at vide om, hvordan du bruger din brugerdefinerede connector til selvdistribution ved hjælp af artiklerne nedenfor:
- Indlæs en brugerdefineret Power Query-connector i Power BI Desktop
- Aktivér og brug brugerdefinerede connectors i Power BI-tjenesten
Data Factory-connectorcertificeringsprogrammet giver dig mulighed for at indsende din connector til Microsoft til certificering, hvor Microsoft sørger for at publicere og distribuere din connector i både Microsoft Fabric og Microsoft Power BI for relevante produkter og oplevelser:
- Power Query Desktop: Microsoft Power BI Desktop.
- Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 og andre
- Datagateway i det lokale miljø: Til både Microsoft Fabric og Microsoft Power BI, der bruger en gateway til godkendt opdatering eller forbindelse.
Få mere at vide om certificeringsprogrammet til Data Factory Connector.