Del via

Oversigt over Power Query SDK

  • Artikel

Formålet med denne artikel er at give dig et overblik over de overordnede funktioner og udviklingsoplevelsen, der findes i Power Query SDK til Visual Studio Code.

Opret et nyt projekt

Tip

Før du opretter et udvidelsesprojekt, anbefaler vi, at du opretter en ny mappe, hvor du skal gemme dit udvidelsesprojekt. Hvis der ikke vælges en mappe under oprettelsen af et nyt projekt, hjælper Power Query SDK dig med at finde eller oprette en ny mappe, før du opretter dit udvidelsesprojekt.

Når du er i Visual Studio Code, er der i hovedruden i Visual Studio Code et afsnit med navnet Power Query SDK. Denne sektion har kun én knap, der læser Opret et udvidelsesprojekt. Vælg denne knap.

Opret en ny udvidelsesprojektknap i Visual Studio Code.

Denne knap åbner et inputfelt øverst i Visual Studio Code-grænsefladen. Angiv navnet på det nye udvidelsesprojekt, og vælg derefter Enter.

Oprettelse af et nyt udvidelsesprojekt og navngivning af projektet.

Efter et par sekunder åbner dit Visual Studio Code-vindue den primære *.pq-fil for dit udvidelsesprojekt, der indeholder din connectorlogik. Power Query SDK kører automatisk nogle nødvendige opgaver for at fuldføre opsætningen af dit arbejdsområde. Du kan kontrollere disse opgaver i outputkonsollen i Visual Studio Code.

Udvidelsesprojekt oprettet ved hjælp af Hello World-skabelonen.

Power Query SDK opretter automatisk følgende sæt filer:

  • En settings.json fil, der bestemmer, at bestemte indstillinger skal arbejde med på arbejdsområdeniveau.
  • Filtypenavnet oprettes som en .mez-fil og gemmes i en ny bin\AnyCPU\Debug-mappe.
  • Et sæt connectorikoner som .png filer.
  • En resources.resx-fil , der fungerer som hovedlager for strenge, der bruges i filtypenavnet.
  • En .pq-fil, der indeholder hovedlogikken for filtypenavnet eller connectoren.
  • En .query.pq-fil, hvis primære formål er at blive brugt som en måde at oprette testforespørgsler på, som du senere kan evaluere.
  • En .proj-fil, der indeholder oplysninger om udvidelsesprojektet.

Liste over connectorfiler.

Når et udvidelsesprojekt genkendes af Visual Studio Code, ændrer sektionen for Power Query SDK udseendet og viser nu en liste over opgaver, du kan køre i forhold til dit nye udvidelsesprojekt.

Opgaver i afsnittet Power Query SDK.

Merit

Vigtigt

Før du kan evaluere forespørgslerne for din dataconnector, skal der først oprettes et sæt legitimationsoplysninger for udvidelsesprojektet.

Power Query SDK tilbyder flere opgaver via brugergrænsefladen, så du kan angive, angive og slette legitimationsoplysninger fra dit udvidelsesprojekt.

Angiv legitimationsoplysninger

Power Query SDK er primært baseret på opgaver, der kan udløses via flere indgangspunkter. Du kan angive legitimationsoplysninger på to måder (de andre opgaver med legitimationsoplysninger kan udføres på samme måde).

  • Via posten i afsnittet Power Query SDK i ruden Stifinder.

    Angivelse af legitimationsoplysninger via afsnittet Power Query SDK i Stifinder.

  • Via Terminal ved at vælge indstillingen Kør opgave og derefter vælge opgaven Angiv legitimationsoplysninger.

    Angivelse af legitimationsoplysninger via terminalmenuen.

Når du kører denne opgave, guider Visual Studio Code dig gennem en række prompter, der giver dig mulighed for at angive legitimationsoplysningerne. Denne række prompter er forudsigelige og består altid af de samme faser:

  1. Vælg datakildetypen.
  2. Vælg connectorfilen.
  3. Vælg godkendelsesmetoden.

Den tilgængelige godkendelsesmetode er anonym for det eksisterende udvidelsesprojekt. Når godkendelsen er angivet, vises en meddelelse, der bekræfter, at der er oprettet legitimationsoplysninger, nederst til højre i vinduet.

Legitimationsoplysningerne er blevet oprettet.

Angiv legitimationsoplysninger

På samme måde som med angivelse af legitimationsoplysninger har opgaven med at angive legitimationsoplysninger to indgangspunkter de samme steder: afsnittet Power Query SDK i ruden Stifinder og i menuen Terminal .

Når denne opgave udføres, vises de tilgængelige legitimationsoplysninger i outputterminalen.

Legitimationsoplysninger angivet i outputkonsollen.

Ryd ALLE legitimationsoplysninger

På samme måde som med de forrige to opgaver har opgaven til at rydde alle legitimationsoplysninger to indgangspunkter på samme sted: afsnittet Power Query SDK i ruden Stifinder og i menuen Terminal .

Denne opgave fungerer som en måde at rydde alle legitimationsoplysninger fra din aktuelle session, når du har brug for at angive en ny legitimationsoplysninger for at evaluere dine forespørgsler.

Oplysningsmeddelelserne for denne opgave vises også i outputkonsollen.

Oplysningsmeddelelse for opgaven Ryd ALLE legitimationsoplysninger.

Evaluer en forespørgsel og resultatpanelet

Før du kan evaluere testforespørgsler, skal der angives en legitimationsoplysninger. Ved hjælp af den connector, der blev oprettet i det forrige afsnit, kan du åbne den *.query.pq fil, der fungerer som din testforespørgselsfil.

For denne specifikke connector, hvor projektnavnet var MyConnector, ser koden ud på følgende måde:

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

Før vi evaluerer forespørgslen, ændrer vi koden på følgende måde:

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

Sørg for at gemme filen, når du har ændret koden.

Hvis du vil evaluere denne forespørgsel, har du tre muligheder:

  • Højreklik på den fil, der er i brug, og vælg indstillingen Evaluer den aktuelle power-forespørgselsfil .

Højreklik på den aktuelle fil for at evaluere den.

  • Gå gennem menuen Terminal , og vælg opgaven Evaluer den aktuelle fil .

Hvis du vælger den aktuelle filopgave, skal du vælge den i terminalmenuoplevelsen.

  • Brug den oprindelige indstilling Kør og foretag fejlfinding fra Visual Studio Code, vælg linket for at oprette en launch.json fil, og evaluer derefter filen.

Opret en launch.json fil for at evaluere forespørgsler via udvidelsesudvidelsen Kør og Fejlfinding.

Når du har evalueret forespørgslen, vises resultaterne i konsollen nederst i vinduet og i et nyt panel kaldet resultatpanelet til højre.

Visual Studio Code-vinduet, efter at evalueringen er afsluttet, og som viser outputtet i konsollen og resultatpanelet.

Resultatpanelet indeholder tre faner:

  • Fanen Output: Viser et dataeksempel på den evaluerede forespørgsel. Hvis dataene er en tabel, vises de som gitter.

    Fanen Output i resultatpanelet.

  • Oversigt: Viser en oversigt over den aktivitet, der kørte evalueringerne, sammen med de statistikker, der er knyttet til den pågældende aktivitet.

    Fanen Oversigt i resultatpanelet.

  • DataSource: Viser generelle oplysninger om den datakilde, der bruges til evalueringen.

    Fanen DataSource i resultatpanelet.

Hvis du vil evaluere en anden forespørgsel, skal du blot redigere *.query.pq-filen, gemme den og derefter køre evalueringsopgaven igen med en af de tre metoder.

Bemærk

Power Query SDK administrerer ikke nogen form for cachelagringsmekanisme for evalueringerne.

Hent et ældre udvidelsesprojekt til det nye SDK

Dette afsnit hjælper connectorudviklere, der har udvidelsesprojekter, der er oprettet med det ældre Visual Studio-baserede Power Query SDK.

For at følge med anbefaler vi, at du downloader de connectorprojekter, der er tilgængelige fra vores DataConnectors-lager for TripPin-eksemplet, især eksemplet 9-TestConnection.

Hvis du vil overføre det ældre udvidelsesprojekt til det nye SDK, skal du følge disse trin:

  1. I Visual Studio Code skal du vælge Åbn filmappe> og derefter navigere til den mappe, hvor dit udvidelsesprojekt er placeret.

  2. Konfigurer et arbejdsområde ved hjælp af den eksisterende mappe og dens indhold ved hjælp af en af følgende to metoder:

    • Power Query SDK har en mekanisme til at genkende indholdet af din mappe og foreslår, at du aktiverer konverteringen til et nyt Power Query SDK-arbejdsområde.

      Pop op-vindue i Visual Studio Code-grænsefladen, der foreslår brugeren en opgradering til Power Query SDK-arbejdsområdet.

    • Kør arbejdsområdet Installation og Opret opgave fra terminalmenuen. Disse vil effektivt oprette .mez-filen og de settings.json filer, der skal bruges til arbejdsområdet.

Tilføjelsen af to nye mapper og filer er det, der transformerer det aktuelle arbejdsområde til et nyt Power Query SDK-arbejdsområde.

Opgradering af udvidelsesprojektet til det nye Power Query SDK.

Konfigurer arbejdsområde

Det, som opgaven Konfigurer arbejdsområde gør, er effektivt at oprette en settings.json fil til dit arbejdsområde, der dikterer nogle variabler, der skal bruges til dit arbejdsområde, når det kommer til evalueringer og generelle indstillinger.

Opret en filtypenavnsfil

Med buildopgaven kan du oprette .mez-filen til dit filtypenavn efter behov.

Kør funktionen TestConnection

TestConnection er en funktion, der gør det muligt at opdatere din connector i Microsoft Cloud via tjenester som f.eks. Power BI. Det er en post, der implementeres i din forbindelsesdatakildepost. Du kan få mere at vide om implementeringen af TestConnection-handleren fra det eksempel, der er tilgængeligt for testforbindelsen.

Opgaven med at køre TestConnection giver dig mulighed for at teste handleren i Power Query SDK uden at skulle prøve denne handler manuelt i Microsoft Cloud.

Hvis du vil køre denne opgave, skal du først angive legitimationsoplysninger for din connector og derefter køre opgaven enten fra afsnittet Power Query SDK i Stifinder eller via listen over opgaver i terminalmenuen.

Resultatet af denne opgave vises i outputterminalen nederst i vinduet.

Resultatet af funktionen Run TestConnection i Power Query SDK.

Feedback og fejl

Hvis du har brug for hjælp til at udvikle din brugerdefinerede connector eller have feedback, forslag eller fejl, som du gerne vil rapportere, kan du besøge vores officielle offentlige lager på GitHub.

Du kan også bruge Power BI Community-forummet til at stille generelle spørgsmål om Power Query, M-sproget og udvikling af brugerdefinerede connectors.