Zdieľať cez


Prehľad súpravy Power Query SDK

Účelom tohto článku je poskytnúť vám prehľad o celkových možnostiach a prostredí vývoja, ktoré sa nachádzajú v súprave Power Query SDK for Visual Studio Code.

Vytvorte nový projekt

Prepitné

Pred vytvorením projektu rozšírenia odporúčame vytvoriť nový priečinok, do ktorého budete ukladať projekt rozšírenia. Ak pri vytváraní nového projektu nie je vybratý žiaden priečinok, súprava Power Query SDK vám pomôže vyhľadať alebo vytvoriť nový priečinok ešte pred vytvorením projektu rozšírenia.

Keď ste v programe Visual Studio Code, na hlavnej table Prieskumníka programu Visual Studio Code sa nachádza časť s názvom Power Query SDK. Táto časť má iba jedno tlačidlo, ktoré prečíta tému Vytvorenie projektu rozšírenia. Vyberte toto tlačidlo.

Vytvorte tlačidlo pre nový projekt rozšírenia v programe Visual Studio Code.

Toto tlačidlo otvorí vstupné pole v hornej časti rozhrania Visual Studio Code. Zadajte názov projektu nového rozšírenia a potom vyberte položku Zadať.

Vytvorenie nového projektu rozšírenia a pomenovanie projektu.

Po niekoľkých sekundách okno programu Visual Studio Code otvorí hlavný súbor *.pq pre projekt rozšírenia, ktorý obsahuje vašu logiku konektora. Súprava Power Query SDK automaticky spustí niektoré potrebné úlohy na dokončenie nastavenia pracovného priestoru. Tieto úlohy môžete skontrolovať vo výstupnej konzole v programe Visual Studio Code.

Projekt rozšírenia vytvorený pomocou šablóny Hello World.

Súprava Power Query SDK automaticky vytvorí nasledujúcu množinu súborov:

  • Súbor settings.json , ktorý diktuje konkrétne nastavenia, s ktorým treba pracovať na úrovni pracovného priestoru.
  • Vytvorí príponu ako súbor .mez a uloží ho do nového priečinka bin\AnyCPU\Debug.
  • Množina ikon konektora ako .png súborov.
  • Súbor resources.resx , ktorý slúži ako hlavný ukladací priestor pre reťazce, ktoré sa používajú v rozšírení.
  • Súbor .pq, ktorý obsahuje hlavnú logiku vášho rozšírenia alebo konektora.
  • Súbor .query.pq, ktorého hlavný účel sa má použiť ako spôsob vytvárania testovacích dotazov, ktoré môžete neskôr vyhodnotiť.
  • Súbor .proj, ktorý obsahuje informácie o projekte rozšírenia.

Zoznam súborov konektora.

Po rozpoznaní projektu rozšírenia v programe Visual Studio Code sa v sekcii súpravy Power Query SDK zmení vzhľad a teraz sa zobrazí zoznam úloh, ktoré môžete spustiť v rámci svojho nového projektu rozšírenia.

Úlohy v rámci sekcie Power Query SDK.

Doklad o absolvovaní

Dôležité

Skôr než budete môcť vyhodnotiť niektorý z dotazov dátového konektora, najprv sa pre projekt rozšírenia musí vytvoriť množina poverení.

Súprava Power Query SDK ponúka prostredníctvom svojho používateľského rozhrania viacero úloh, vďaka čomu môžete nastaviť, uviesť a odstrániť prihlasovacie údaje z projektu rozšírenia.

Nastavenie poverení

Súprava Power Query SDK je primárne riadená úlohami, ktoré možno spustiť prostredníctvom viacerých vstupných bodov. Nastavenie poverenia sa dá vykonať dvoma spôsobmi (ostatné úlohy poverení možno vykonať rovnakým spôsobom).

  • Cez položku v časti Power Query SDK na table prieskumníka.

    Nastavenie poverení prostredníctvom sekcie Power Query SDK v Prieskumníkovi.

  • Cez terminál výberom možnosti Spustiť úlohu a potom výberom položky Nastaviť úlohu poverení.

    Nastavenie prihlasovacích údajov prostredníctvom ponuky Terminal (Terminál).

Keď spustíte túto úlohu, Visual Studio Code vás prevedie radom výziev, ktoré vám umožnia nastaviť prihlasovacie údaje. Tieto rady výziev sú predvídateľné a vždy pozostávajú z rovnakých fáz:

  1. Vyberte typ zdroja údajov.
  2. Vyberte súbor konektora.
  3. Vyberte metódu overovania.

V prípade existujúceho projektu rozšírenia je dostupná metóda overovania anonymná. Po nastavení overovania sa v pravom dolnom rohu okna zobrazí hlásenie potvrdzujúce, že poverenie bolo úspešne generované.

Prihlasovacie údaje sa úspešne vygenerovali.

Poverenia zoznamu

Podobne ako nastavenie prihlasovacích údajov, úloha na zadanie poverení má dva vstupné body na rovnakých miestach: časť Súprava Power Query SDK na table Prieskumník a v ponuke Terminal .

Po spustení tejto úlohy sa vo výstupných termináloch zobrazia dostupné poverenia.

Poverenia sú uvedené v konzole Output (Výstup).

Vymazať všetky poverenia

Podobne ako v predchádzajúcich dvoch úlohách, úloha vymazania všetkých poverení má dva vstupné body na rovnakých miestach: časť Power Query SDK na table Prieskumník a v ponuke Terminal .

Táto úloha slúži ako spôsob, ako vymazať všetky poverenia z aktuálnej relácie, keď potrebujete nastaviť nové prihlasovacie údaje na vyhodnotenie vašich dotazov.

Informačné správy pre túto úlohu sa zobrazujú aj vo výstupnej konzole.

Informačné hlásenie pre úlohu Vymazať VŠETKY poverenia.

Vyhodnotenie dotazu a panela s výsledkami

Pred vyhodnotením testovacích dotazov je potrebné nastaviť prihlasovacie údaje. Pomocou konektora, ktorý bol vytvorený v predchádzajúcej časti, môžete otvoriť *.query.pq súbor, ktorý slúži ako súbor testovacieho dotazu.

V tomto konkrétnom konektore, kde bol názov projektu MyConnector, kód vyzerá takto:

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

Pred vyhodnotením dotazu zmeňme kód nasledovne:

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

Po zmene kódu uložte súbor.

Na vyhodnotenie tohto dotazu máte tri možnosti:

  • Pravým tlačidlom vyberte používaný súbor a vyberte možnosť Vyhodnotiť aktuálny súbor Power Query.

Kliknutím pravým tlačidlom myši na aktuálny súbor ho môžete vyhodnotiť.

  • Prejdite cez ponuku Terminal (Terminál ) a vyberte položku Evaluate current file (Vyhodnotiť aktuálny súbor ).

Výberom vyhodnocujte aktuálnu úlohu súboru z ponuky terminálovej ponuky.

  • Použite natívnu možnosť Spustiť a ladiť v programe Visual Studio Code, vyberte hypertextové prepojenie a vytvorte súbor launch.json a potom vyhodnotíte súbor.

Vytvorte launch.json súbor na vyhodnotenie dotazov prostredníctvom rozšíriteľnosti spustenia a ladenia.

Po vyhodnotení dotazu sa výsledky zobrazia v konzole v dolnej časti okna a na novom paneli s názvom panel výsledkov na pravej strane.

Okno Visual Studio Code po dokončení hodnotenia zobrazujúce výstup v konzole a na paneli výsledkov.

Panel výsledkov obsahuje tri karty:

  • Karta Výstup: Zobrazí ukážku údajov vyhodnoteného dotazu. Ak sú údaje tabuľkou, zobrazia sa ako mriežka.

    Karta Výstup na paneli s výsledkami.

  • Summary (Súhrn): Zobrazí súhrn aktivity, ktorá viedla hodnotenia, spolu so štatistikou súvisiacou s danou aktivitou.

    Karta Summary (Súhrn) na paneli s výsledkami.

  • DataSource: zobrazuje všeobecné informácie o zdroji údajov použitom na vyhodnotenie.

    Karta ZdrojÚdajov na paneli s výsledkami.

Ak chcete vyhodnotiť iný dotaz, stačí upraviť súbor *.query.pq, uložiť ho a potom spustiť úlohu vyhodnotenia pomocou ľubovoľnej z týchto troch metód.

Poznámka

Súprava Power Query SDK nespravuje žiadny druh mechanizmu ukladania do vyrovnávacej pamäte v rámci hodnotení.

Prenos staršieho projektu rozšírenia do novej súpravy SDK

Táto časť pomáha vývojárom konektorov, ktorí majú projekty rozšírenia, ktoré boli vytvorené pomocou staršej súpravy Power Query SDK založenej na Visual Studiu.

Ak chcete pokračovať ďalej, odporúčame stiahnuť projekty konektorov, ktoré sú k dispozícii z nášho odkladacieho priestoru DataConnectors pre ukážku TripPin, konkrétne ukážku 9-TestConnection.

Ak chcete preniesť projekt staršieho rozšírenia do novej súpravy SDK, postupujte podľa týchto krokov:

  1. V programe Visual Studio Code vyberte položky Súbor>Otvoriť priečinok a potom prejdite do priečinka, v ktorom sa nachádza projekt rozšírenia.

  2. Nastavte pracovný priestor pomocou existujúceho priečinka a jeho obsahu pomocou niektorého z nasledujúcich dvoch spôsobov:

    • Súprava Power Query SDK má mechanizmus na rozpoznávanie obsahu vášho priečinka a navrhuje, aby ste povolili konverziu na nový pracovný priestor Power Query SDK.

      Kontextová ponuka v rozhraní Visual Studio Code, ktorá používateľovi navrhuje inováciu na pracovný priestor SDK Power Query.

    • Spustite pracovný priestor Nastavenia a úlohu zostavy z ponuky terminálu. Týmto sa efektívne vytvorí súbor .mez a settings.json súbory potrebné pre pracovný priestor.

Pridanie dvoch nových priečinkov a súborov transformuje aktuálny pracovný priestor do nového pracovného priestoru súpravy Power Query SDK.

Inovácia projektu rozšírenia na novú súpravu SDK doplnku Power Query.

Nastavenie pracovného priestoru

Úloha Nastaviť pracovný priestor účinne vytvorí settings.json súbor pre pracovný priestor, ktorý diktuje niektoré premenné, ktoré sa použijú pre váš pracovný priestor, pokiaľ ide o hodnotenia a všeobecné nastavenia.

Vytvorenie súboru s príponou

Úloha tvorby vám umožňuje vytvoriť súbor .mez pre vaše rozšírenie na požiadanie.

Spustenie funkcie TestConnection

TestConnection je funkcia, ktorá umožňuje obnovenie konektora v microsoft cloude prostredníctvom služieb, ako je napríklad Power BI. Je to záznam implementovaný v rámci záznamu zdroja údajov konektora. Ďalšie informácie o implementácii obslužného programu TestConnection nájdete v ukážke dostupnej pre testovacie pripojenie.

Úloha spustenia riešenia TestConnection vám umožňuje otestovať obslužný program v súprave Power Query SDK bez toho, aby ste museli tento obslužný program manuálne vyskúšať v cloude microsoftu.

Ak chcete spustiť túto úlohu, najskôr nastavte prihlasovacie údaje pre konektor a potom ju spustite buď zo sekcie Súprava SDK Power Query v Prieskumníkovi , alebo prostredníctvom zoznamu úloh v ponuke terminálov.

Výsledok tejto úlohy sa zobrazí vo výstupnom termináli v dolnej časti okna.

Výsledok funkcie Spustiť TestConnection v súprave Power Query SDK.

Pripomienky a chyby

Ak potrebujete pomoc s vývojom vlastného konektora alebo máte nejaké pripomienky, návrhy alebo chyby, ktoré by ste chceli nahlásiť, navštívte náš oficiálny verejný odkladací priestor v službe GitHub.

Môžete tiež použiť fórum Komunita Power BI na uverejňovanie všeobecných otázok o power query, jazyku M a vývoji vlastných konektorov.