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.

utviklingsprosess for Koble til or

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:

  • Koble til or-definisjonsfil (<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 gir grunnleggende funksjoner for kjøring av spørringer, slik at du kan teste utvidelsen uten å måtte bytte til Power BI Desktop.

Testfil for spørring

I tillegg til filtypen kan Data Koble til or-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. Ved kjøring laster Power BI Desktop inn utvidelser fra [Dokumenter]\Microsoft Power BI Desktop\Egendefinerte Koble til orer.

Merk

Data Koble til or-prosjekter støtter ikke egendefinerte trinn for bygg etter bygg for å kopiere filtypen til [Dokumenter]\Microsoft Power BI Desktop\Custom Koble til ors-katalogen. Hvis dette er noe du vil gjøre, kan det være lurt å bruke en tredjepartsutvidelse.

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 datakoblinger

Power Query-koblinger kan brukes i Power BI Desktop eller Power Query Online-opplevelsen, for eksempel Power BI-dataflyter, Power BI-datamarts og andre opplevelser.

Power BI Desktop

Power BI Desktop-brukere kan følge trinnene nedenfor for å bruke en egendefinert Power Query-kobling:

  1. Kopier filtypen (.mez eller.pqx) til [Dokumenter]/Power BI Desktop/Egendefinerte Koble til orer.
  2. I Power BI Desktop velger du alternativet (Anbefales ikke) Tillat at filtyper lastes inn uten validering eller advarsel under Filalternativer>og innstillinger>Alternativer for>sikkerhetsdatautvidelser.>
  3. Start Power BI Desktop på nytt.

Power BI Desktop laster automatisk inn utvidelsene ved omstart.

Du kan også, som eier av datakilden og koblingen, sende koblingen til sertifiseringsprogrammet for Power Query Koble til or, slik at den leveres med Power BI Desktop på hver utgivelse.

Power Query Online

Bare Power Query-sertifiserte koblinger vises i Power Query Online-opplevelsen. Hvis du vil lære mer om sertifiseringsprogrammet for Power Query-kobling, kan du gå til Sertifisering av Power Query-Koble til eller.