Utvikle en kobling ved hjelp av Power Query SDK
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.
Installer Visual Studio Code Power Query SDK fra Visual Studio Code-delen av Visual Studio Marketplace. Velg Installer for å installere SDK.
Avsnittene nedenfor beskriver, på et høyt nivå, den vanligste prosessen for å opprette en Power Query-kobling ved hjelp av SDK.
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.
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:
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.
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;
ellerb = 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.
Du har to baner der du kan distribuere koblingen:
- Selvfordeling
- Koblingssertifisering
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.
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:
- Laste inn en egendefinert Power Query-kobling i Power BI Desktop
- Aktivere og bruke egendefinerte koblinger i Power BI-tjenesten
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.