Læs på engelsk

Del via


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.

Installation af Power Query SDK

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.

Udviklingsproces for connector

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.

Oprettelse af en ny udvidelse

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.

Tester

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.:

Forespørgselstestfil

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.

Opbyg, og installer

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; . eller b = 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.

Distribution af Power Query-connectors

Du har to stier, hvor du kan distribuere din connector:

  • Selvdistribution
  • Connectorcertificering

Selvdistribution

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.

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:

Connectorcertificering

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.