Del via

Utvikle en kobling ved hjelp av Power Query SDK

  • Artikkel

Power Query SDK er et sett med verktøy som er utformet for å hjelpe deg med å opprette Power Query-koblinger. Disse koblingene kalles ofte egendefinerte koblinger eller Power Query-utvidelser.

Egendefinerte koblinger lar deg opprette nye datakilder eller tilpasse og utvide en eksisterende kilde. Vanlige brukstilfeller omfatter:

  • Opprette en forretningsanalytikervennlig visning for en REST-API.
  • Gir varemerking for en kilde som Power Query støtter med en eksisterende kobling (for eksempel en OData-tjeneste eller ODBC-driver).
  • ImplementereR OAuth v2-godkjenningsflyt for et SaaS-tilbud.
  • Utsette en begrenset eller filtrert visning over datakilden for å forbedre brukervennligheten.
  • Aktivere DirectQuery for en datakilde ved hjelp av en ODBC-driver.

Installere Power Query SDK

Installer Visual Studio Code Power Query SDK fra Visual Studio Code-delen av Visual Studio Marketplace. Velg Installer for å installere SDK.

Koblingsutviklingsprosess

Avsnittene nedenfor beskriver, på et høyt nivå, den vanligste prosessen for å opprette en Power Query-kobling ved hjelp av SDK.

Opprette en ny utvidelse

Når du oppretter et nytt arbeidsområde (Visual Studio Code Power Query SDK), begynner du med følgende kjernefiler:

  • Koblingsdefinisjonsfil (<connectorName.pq>)
  • En spørringsfil (<connectorName.query.pq>)
  • En strengressursfil (resources.resx)
  • PNG-filer av forskjellige størrelser som brukes til å opprette ikoner

Koblingsdefinisjonsfilen starter med en tom datakildebeskrivelse. Du kan lære mer om en datakilde i konteksten til Power Query SDK fra artikkelen om håndtering av datatilgang.

Tester

Power Query SDK har grunnleggende funksjoner for kjøring av spørringer, slik at du kan teste utvidelsen uten å måtte bytte til et annet klientprogram. Du kan teste koblingen ytterligere i et program, for eksempel:

Testfil for spørring

I tillegg til filtypen kan Data Connector-prosjekter ha en spørringsfil (name.query.pq). Denne filen kan brukes til å kjøre testspørringer i Visual Studio Code. Spørringsevalueringen inkluderer automatisk utvidelseskoden, uten å måtte registrere PQX-filen, slik at du kan ringe eller teste eventuelle delte funksjoner i utvidelseskoden.

Spørringsfilen kan inneholde ett enkelt uttrykk (for eksempel HelloWorld.Contents()), et let uttrykk (for eksempel hva Power Query ville generert) eller et inndelingsdokument.

Bygg og distribuer

Hvis du bygger prosjektet, produseres .mez-filen eller filtypen. Power Query-filtyper er samlet i en ZIP-fil og får filtypen MEZ.

Utvidelser er definert i et M-inndelingsdokument. Et inndelingsdokument har et litt annet format enn spørringsdokumentet(e) som genereres i Power Query. Kode du importerer fra Power Query krever vanligvis endring for å passe inn i et inndelingsdokument, men endringene er mindre. Inndelingsdokumentforskjeller du bør være oppmerksom på inkluderer:

  • De begynner med en inndelingsdeklarasjon (for eksempel section HelloWorld;).
  • Hvert uttrykk slutter med semikolon (for eksempel a = 1; eller b = let c = 1 + 2 in c;).
  • Alle funksjoner og variabler er lokale for inndelingsdokumentet, med mindre de er merket som delt. Delte funksjoner blir synlige for andre spørringer/funksjoner, og kan betraktes som eksporter for utvidelsen (det vil se ut som om de kan ringe fra Power Query).

Du finner mer informasjon om M-inndelingsdokumenter i M-språkspesifikasjonen.

Distribusjon av Power Query-koblinger

Du har to baner der du kan distribuere koblingen:

  • Selvfordeling
  • Koblingssertifisering

Selvfordeling

En selvbetjent mekanisme der du kan bruke egendefinerte Power Query-koblinger i gjeldende produktopplevelser

Når koblingen er opprettet, kan du sende denne filen som du ønsker til brukerne, og de kan bruke koblingen i gjeldende produktopplevelser, for eksempel Microsoft Power BI.

Microsoft Power BI

Du kan bruke din egen egendefinerte kobling i Microsoft Power BI Desktop og Microsoft Power BI-tjenesten for semantiske modeller for oppdatering og tilkobling i skyen.

Power Query-koblinger kan lastes inn i tre opplevelser:

  • Lokal datagateway: Koblingen kan lastes inn gjennom gatewayen som skal brukes i Microsoft Fabric og Microsoft Power Bi-tjeneste s
  • Power Query Online: i opplevelser som Power BI Datamarts, Fabric Dataflow Gen2 og mange andre
  • Power Query Desktop: i opplevelser som Power BI Desktop.

Du kan lære mer om hvordan du bruker den egendefinerte koblingen for selvdistribusjon ved hjelp av artiklene nedenfor:

Koblingssertifisering

Med sertifiseringsprogrammet for Data Factory-koblinger kan du sende koblingen til Microsoft for sertifisering der Microsoft tar seg av publisering og distribusjon av koblingen i både Microsoft Fabric og Microsoft Power BI for aktuelle produkter og opplevelser:

  • 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
  • Lokal datagateway: For både Microsoft Fabric og Microsoft Power BI som bruker en gateway for godkjent oppdatering eller tilkobling.

Mer informasjon om Sertifiseringsprogram for Data Factory Connector.