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.
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ť.
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.
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.
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.
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.
Cez terminál výberom možnosti Spustiť úlohu a potom výberom položky Nastaviť úlohu poverení.
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:
- Vyberte typ zdroja údajov.
- Vyberte súbor konektora.
- 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é.
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.
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.
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.
- Prejdite cez ponuku Terminal (Terminál ) a vyberte položku Evaluate current file (Vyhodnotiť aktuálny súbor ).
- 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.
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.
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.
Summary (Súhrn): Zobrazí súhrn aktivity, ktorá viedla hodnotenia, spolu so štatistikou súvisiacou s danou aktivitou.
DataSource: zobrazuje všeobecné informácie o zdroji údajov použitom na vyhodnotenie.
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:
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.
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.
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.
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.
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.