Oversikt over Power Query SDK

Formålet med denne artikkelen er å gi deg en oversikt over de generelle funksjonene og utviklingsopplevelsen som finnes i Power Query SDK for Visual Studio Code.

Opprette et nytt prosjekt

Tips

Før du oppretter et utvidelsesprosjekt, anbefaler vi at du oppretter en ny mappe der du lagrer utvidelsesprosjektet. Hvis ingen mappe er valgt under oppretting av et nytt prosjekt, hjelper Power Query SDK deg med å finne eller opprette en ny mappe før du oppretter utvidelsesprosjektet.

En gang i Visual Studio Code, i hovedutforskerruten i Visual Studio Code, er det en inndeling med navnet Power Query SDK. Denne inndelingen har bare én knapp som leser Opprett et utvidelsesprosjekt. Velg denne knappen.

Denne knappen åpner et inndatafelt øverst i Visual Studio Code-grensesnittet. Skriv inn navnet på det nye utvidelsesprosjektet, og velg deretter Enter.

Etter noen sekunder åpner Visual Studio Code-vinduet hovedfilen *.pq for utvidelsesprosjektet som inneholder koblingslogikken. Power Query SDK kjører automatisk noen nødvendige oppgaver for å fullføre oppsettet av arbeidsområdet. Du kan kontrollere disse oppgavene i utdatakonsollen i Visual Studio Code.

Power Query SDK oppretter automatisk følgende sett med filer:

• En settings.json fil som dikterer bestemte innstillinger for arbeid med på arbeidsområdenivå.
• Den bygger filtypen som en MEZ-fil og lagrer den i en ny bin\AnyCPU\Debug-mappe.
• Et sett med koblingsikoner som .png filer.
• En resources.resx-fil som fungerer som den viktigste lagringsplassen for strenger som brukes i utvidelsen.
• En PQ-fil som inneholder hovedlogikken i filtypen eller koblingen.
• En .query.pq-fil med hovedformål som skal brukes som en måte å opprette testspørringer som du senere kan evaluere.
• En PROJ-fil som inneholder informasjon om utvidelsesprosjektet.

Når et utvidelsesprosjekt gjenkjennes av Visual Studio Code, endrer inndelingen for Power Query SDK utseendet, og viser nå en liste over aktiviteter du kan kjøre mot det nye utvidelsesprosjektet.

Kvalifikasjonsbevis

Viktig

Før du kan evaluere noen av spørringene i datakoblingen, må det først opprettes et sett med legitimasjon for utvidelsesprosjektet.

Power Query SDK tilbyr flere oppgaver gjennom brukergrensesnittet, slik at du kan angi, liste opp og slette legitimasjon fra utvidelsesprosjektet.

Angi legitimasjon

Power Query SDK er hovedsakelig drevet av oppgaver som kan utløses gjennom flere inngangspunkter. Du kan angi legitimasjon på to måter (andre legitimasjonsoppgaver kan utføres på samme måte).

• Gjennom oppføringen i Power Query SDK-delen i utforskerruten.

  

• Gjennom terminalen ved å velge alternativet Kjør oppgave og deretter velge angi legitimasjonsoppgaven.

  

Når du kjører denne oppgaven, veileder Visual Studio Code deg gjennom en rekke ledetekster, slik at du kan angi legitimasjonen. Disse ledetekstseriene er forutsigbare og består alltid av de samme fasene:

1. Velg datakildetypen.
2. Velg koblingsfilen.
3. Velg godkjenningsmetoden.

Godkjenningsmetoden som er tilgjengelig for det eksisterende utvidelsesprosjektet, er anonym. Når godkjenningen er angitt, vises en melding som bekrefter at legitimasjonen er generert, nederst til høyre i vinduet.

Listelegitimasjon

På samme måte som når du angir en legitimasjon, har oppgaven med å liste legitimasjon to inngangspunkter på de samme stedene: Power Query SDK-inndelingen i Utforsker-ruten og i Terminal-menyen .

Når denne oppgaven utføres, viser den tilgjengelige legitimasjonen i utdataterminalen.

Fjern ALL legitimasjon

På samme måte som de to foregående oppgavene, har oppgaven for å fjerne all legitimasjon to inngangspunkter på de samme stedene: Power Query SDK-inndelingen i Utforsker-ruten og i Terminal-menyen .

Denne oppgaven fungerer som en metode for å fjerne all legitimasjon fra gjeldende økt når du må angi en ny legitimasjon for å evaluere spørringene.

Informasjonsmeldingene for denne oppgaven vises også i utdatakonsollen.

Evaluere en spørring og resultatpanelet

Før du kan evaluere testspørringer, må det angis en legitimasjon. Ved hjelp av koblingen som ble opprettet i forrige del, kan du åpne *.query.pq filen som fungerer som testspørringsfil.

For denne bestemte koblingen der prosjektnavnet var MyConnector, ser koden slik ut:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents()
in
    result

Før du evaluerer spørringen, kan vi endre koden på følgende måte:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents("Hello World")
in
    result

Pass på at du lagrer filen etter at du har endret koden.

Hvis du vil evaluere denne spørringen, har du tre alternativer:

• Høyreklikk filen som er i bruk, og velg alternativet Evaluer gjeldende power query-fil .

• Gå gjennom Terminal-menyen , og velg Evaluer gjeldende filoppgave .

• Bruk det opprinnelige alternativet Kjør og Feilsøking fra Visual Studio Code, velg hyperkoblingen for å opprette en launch.json fil, og evaluer deretter filen.

Når du har evaluert spørringen, vises resultatene i konsollen nederst i vinduet og i et nytt panel kalt resultatpanelet til høyre.

Resultatpanelet inneholder tre faner:

• Utdatafane: Viser en dataforhåndsvisning av spørringen evaluert. Hvis dataene er en tabell, vises de som rutenett.

  

• Sammendrag: Viser et sammendrag av aktiviteten som kjørte evalueringene, sammen med statistikken som er knyttet til denne aktiviteten.

  

• Datakilde: Viser generell informasjon om datakilden som brukes til evalueringen.

  

Hvis du vil evaluere en annen spørring, endrer du bare *.query.pq-filen, lagrer den og kjører deretter evalueringsoppgaven på nytt med en av de tre metodene.

Merk

Power Query SDK administrerer ikke noen form for hurtigbufringsmekanisme for evalueringene.

Hent et eldre utvidelsesprosjekt til den nye SDK-en

Denne delen hjelper koblingsutviklere som har utvidelsesprosjekter som ble opprettet med den eldre Visual Studio-baserte Power Query SDK.

For å følge med anbefaler vi at du laster ned koblingsprosjektene som er tilgjengelige fra DataConnectors-repositoriet for TripPin-eksemplet, spesielt eksemplet på 9-TestConnection.

Følg disse trinnene for å hente det eldre utvidelsesprosjektet til den nye SDK-en:

1. Velg Åpne fil-mappen> i Visual Studio Code, og gå deretter til mappen der utvidelsesprosjektet er plassert.

2. Konfigurere et arbeidsområde ved hjelp av den eksisterende mappen og innholdet ved hjelp av én av følgende to metoder:

   • Power Query SDK har en mekanisme for å gjenkjenne innholdet i mappen, og foreslår at du aktiverer konverteringen til et nytt SDK-arbeidsområde for Power Query.

     

   • Kjør installasjonsarbeidsområdet og bygg oppgave fra terminalmenyen. Disse vil effektivt opprette .mez-filen og settings.json filene som kreves for arbeidsområdet.

Tillegg av to nye mapper og filer er det som transformerer gjeldende arbeidsområde til et nytt Power Query SDK-arbeidsområde.

Konfigurere arbeidsområde

Det oppgaven konfigurerer arbeidsområde gjør, er effektivt å opprette en settings.json fil for arbeidsområdet som dikterer noen variabler som skal brukes for arbeidsområdet når det gjelder evalueringer og generelle innstillinger.

Bygge en filtypefil

Med kompileringsoppgaven kan du opprette .mez-filen for filtypen ved behov.

Kjør TestConnection (funksjon)

TestConnection er en funksjon som gjør at koblingen kan oppdateres i Microsoft Cloud gjennom tjenester som Power BI. Det er en post implementert i koblingsdatakildeposten. Du kan lære mer om implementeringen av TestConnection-behandlingsprogrammet fra eksemplet som er tilgjengelig for testtilkobling.

Oppgaven med å kjøre TestConnection gjør det mulig å teste behandleren i Power Query SDK uten å måtte prøve denne behandlingsbehandlingen manuelt i Microsoft Cloud.

Hvis du vil kjøre denne oppgaven, må du først angi en legitimasjon for koblingen og deretter kjøre oppgaven enten fra Power Query SDK-delen i Utforsker eller gjennom listen over oppgaver i terminalmenyen.

Resultatet av denne oppgaven vises i utdataterminalen nederst i vinduet.

Tilbakemeldinger og feil

Hvis du trenger hjelp til å utvikle den egendefinerte koblingen eller ha tilbakemeldinger, forslag eller feil som du vil rapportere, kan du gå til vårt offisielle offentlige repositorium på GitHub.

Du kan også bruke Power BI-fellesskap-forumet til å legge inn generelle spørsmål rundt Power Query, M-språket og utvikling av egendefinerte koblinger.