A Power Query SDK áttekintése

A cikk célja, hogy áttekintést nyújtson a Visual Studio Code Power Query SDK-jában található általános képességekről és fejlesztési élményről.

Új projekt létrehozása

Egyszer a Visual Studio Code-ban, a Visual Studio Code fő Explorer paneljén van egy Power Query SDK nevű szakasz. Ebben a szakaszban csak egy gomb található, amely a Bővítményprojekt létrehozása parancsot olvassa fel. Válassza ezt a gombot.

Ez a gomb megnyit egy beviteli mezőt a Visual Studio Code felületének tetején. Adja meg az új bővítményprojekt nevét, majd kattintson az Enter gombra.

Néhány másodperc elteltével a Visual Studio Code ablak megnyitja az összekötő logikáját tartalmazó bővítményprojekt fő *.pq fájlját. A Power Query SDK automatikusan futtat néhány szükséges feladatot a munkaterület beállításának elvégzéséhez. Ezeket a feladatokat a Visual Studio Code kimeneti konzolján ellenőrizheti.

A Power Query SDK automatikusan létrehozza a következő fájlkészletet:

• Egy settings.json fájl, amely meghatározott beállításokat diktál a munkaterület szintjén való munkavégzéshez.
• A bővítményt .mez fájlként hozza létre, és egy új bin\AnyCPU\Debug mappában tárolja.
• Összekötőikonok készlete .png fájlokként.
• Egy resources.resx fájl, amely a bővítményben használt sztringek fő tárolójaként szolgál.
• A bővítmény vagy összekötő fő logikáját tartalmazó .pq fájl.
• .query.pq fájl, amelynek fő célja, hogy a később kiértékelhető tesztlekérdezések létrehozására szolgáljon.
• .proj fájl, amely a bővítményprojekt adatait tartalmazza.

Ha a Visual Studio Code felismer egy bővítményprojektet, a Power Query SDK szakasza megváltoztatja a megjelenését, és megjeleníti az új bővítményprojekten futtatható feladatok listáját.

Igazolás

A Power Query SDK a felhasználói felületén keresztül több feladatot is kínál, így beállíthatja, listázhatja és törölheti a hitelesítő adatokat a bővítményprojektből.

Hitelesítő adatok beállítása

A Power Query SDK-t elsősorban olyan feladatok vezérlik, amelyek több belépési ponton keresztül aktiválhatók. A hitelesítő adatok beállítása kétféleképpen végezhető el (a többi hitelesítő feladat ugyanúgy végezhető el).

• Az Explorer panel Power Query SDK szakaszában található bejegyzésen keresztül.

  

• A Terminálon keresztül válassza a Feladat futtatása lehetőséget, majd válassza a Hitelesítő adatok beállítása feladatot.

  

A feladat futtatásakor a Visual Studio Code végigvezeti a hitelesítő adatok beállításának engedélyezésére vonatkozó kérések sorozatán. Ezek a kérések sorozata kiszámítható, és mindig ugyanazokból a szakaszokból áll:

1. Válassza ki az adatforrás típusát.
2. Válassza ki az összekötőfájlt.
3. Válassza ki a hitelesítési módszert.

A meglévő bővítményprojekt esetében az elérhető hitelesítési módszer névtelen. A hitelesítés beállítása után az ablak jobb alsó sarkában megjelenik egy üzenet, amely megerősíti, hogy a hitelesítő adatok sikeresen létrejöttek.

Hitelesítő adatok listázása

A hitelesítő adatok beállításához hasonlóan a hitelesítő adatokat listázó feladatnak két belépési pontja van ugyanazon a helyen: a Power Query SDK szakasza az Explorer panelen és a Terminál menüben.

A feladat végrehajtásakor a kimeneti terminálban elérhető hitelesítő adatokat mutatja be.

AZ ÖSSZES hitelesítő adat törlése

Az előző két tevékenységhez hasonlóan az összes hitelesítő adat törlésére szolgáló feladat két belépési ponttal rendelkezik ugyanazon a helyen: a Power Query SDK szakaszában az Explorer panelen és a Terminál menüben.

Ez a feladat lehetővé teszi az összes hitelesítő adat törlését az aktuális munkamenetből, amikor új hitelesítő adatokat kell beállítania a lekérdezések kiértékeléséhez.

A feladat információs üzenetei a kimeneti konzolon is megjelennek.

Lekérdezés és eredménypanel kiértékelése

A teszt lekérdezések kiértékelése előtt be kell állítani egy hitelesítő adatot. Az előző szakaszban létrehozott összekötő használatával megnyithatja a *.query.pq teszt lekérdezésfájlként szolgáló fájlt.

Az adott összekötő esetében, ahol a projekt neve MyConnector volt, a kód a következőképpen néz ki:

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

A lekérdezés kiértékelése előtt módosítsa a kódot az alábbiak szerint:

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

A kód módosítása után mindenképpen mentse a fájlt.

A lekérdezés kiértékeléséhez három lehetősége van:

• Válassza ki a jobb gombbal a használt fájlt, és válassza az Aktuális Power Query-fájl kiértékelése lehetőséget .

• Nyissa meg a Terminál menüt, és válassza az Aktuális fájlfeladat kiértékelése lehetőséget.

• Használja a Visual Studio Code natív futtatási és hibakeresési beállítását, jelölje ki a hivatkozást egy launch.json fájl létrehozásához, majd értékelje ki a fájlt.

A lekérdezés kiértékelése után az eredmények megjelennek a konzolon az ablak alján, és egy új panelen, a jobb oldalon az eredménypanelen .

Az eredménypanel három lapot tartalmaz:

• Kimenet lap: Megjeleníti a kiértékelt lekérdezés adatelőnézetét. Ha az adatok táblázatként jelennek meg, rácsként jelennek meg.

  

• Összegzés: Megjeleníti az értékeléseket futtató tevékenység összegzését, valamint az adott tevékenységhez kapcsolódó statisztikákat.

  

• Adatforrás: Általános információkat jelenít meg a kiértékeléshez használt adatforrásról.

  

Egy másik lekérdezés kiértékeléséhez módosítsa a *.query.pq fájlt, mentse, majd futtassa újra a kiértékelési feladatot a három módszer bármelyikével.

Régi bővítményprojekt létrehozása az új SDK-hoz

Ez a szakasz segít az összekötő fejlesztőknek, akik az örökölt Visual Studio-alapú Power Query SDK-val létrehozott bővítményprojektekkel rendelkeznek.

Ennek követéséhez javasoljuk, hogy töltse le a TripPin-minta DataConnectors-adattárából elérhető összekötőprojekteket, különösen a 9-TestConnection mintát.

Ha az örökölt bővítményprojektet az új SDK-ra szeretné vinni, kövesse az alábbi lépéseket:

1. A Visual Studio Code-ban válassza a Fájl>megnyitása mappát, majd lépjen arra a mappára, ahol a bővítményprojekt található.

2. Állítson be egy munkaterületet a meglévő mappával és annak tartalmával az alábbi két módszer egyikével:

   • A Power Query SDK rendelkezik egy mechanizmussal, amely felismeri a mappa tartalmát, és azt javasolja, hogy engedélyezze az új Power Query SDK-munkaterületre való átalakítást.

     

   • Futtassa a beállítási munkaterületet és a buildelési feladatot a terminál menüjéből. Ezek gyakorlatilag létrehozzák a .mez fájlt és a munkaterülethez szükséges settings.json fájlokat.

Két új mappa és fájl hozzáadása az aktuális munkaterületet egy új Power Query SDK-munkaterületté alakítja.

Munkaterület beállítása

A Munkaterület beállítása feladat tulajdonképpen egy settings.json fájlt hoz létre a munkaterülethez, amely meghatározza a munkaterülethez az értékelések és az általános beállítások során használt változókat.

Bővítményfájl létrehozása

A buildelési feladat segítségével igény szerint létrehozhatja a .mez fájlt a bővítményhez.

A TestConnection függvény futtatása

A TestConnection egy olyan függvény, amely lehetővé teszi az összekötő frissítését a Microsoft Cloudban olyan szolgáltatásokon keresztül, mint a Power BI. Ez az összekötő adatforrásrekordjában implementált rekord. A TestConnection kezelő implementációjáról a Tesztkapcsolathoz elérhető mintából tudhat meg többet.

A TestConnection futtatására szolgáló feladat lehetővé teszi a kezelő tesztelését a Power Query SDK-ban anélkül, hogy manuálisan kellene kipróbálnia ezt a kezelőt a Microsoft Cloudban.

A feladat futtatásához először állítson be egy hitelesítő adatot az összekötőhöz, majd futtassa a feladatot az Explorer Power Query SDK szakaszából vagy a terminálmenüben található feladatok listájából.

A feladat eredménye az ablak alján lévő kimeneti terminálban jelenik meg.

Visszajelzés és hibák

Ha segítségre van szüksége az egyéni összekötő fejlesztéséhez, vagy bármilyen visszajelzést, javaslatot vagy hibát szeretne jelenteni, látogasson el hivatalos nyilvános adattárunkba a GitHubon.

A Power BI-közösség fórum segítségével általános kérdéseket tehet fel a Power Query, az M nyelv és az egyéni összekötők fejlesztésével kapcsolatban.