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

Tipp.

Bővítményprojekt létrehozása előtt javasoljuk, hogy hozzon létre egy új mappát, amelyben tárolni fogja a bővítményprojektet. Új projekt létrehozásakor, ha nincs kijelölve mappa, a Power Query SDK segít megtalálni vagy létrehozni egy új mappát a bővítményprojekt létrehozása előtt.

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

Fontos

Mielőtt kiértékelheti az adatösszekötő lekérdezéseit, először létre kell hoznia egy hitelesítő adatokat a bővítményprojekthez.

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.

Ebben az adott összekötőben, ahol a projekt neve My Csatlakozás or 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.

Feljegyzés

A Power Query SDK nem kezeli a kiértékelések gyorsítótárazási mechanizmusát.

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 data Csatlakozás ors-adattárából elérhető összekötő-projekteket, különösen a 9-Test Csatlakozás ion 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 Test Csatlakozás ion függvény futtatása

A Test Csatlakozás ion függvény 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 Test Csatlakozás ion handler implementációjáról a tesztkapcsolathoz elérhető mintából tudhat meg többet.

A Teszt Csatlakozás ion futtatásával anélkül tesztelheti a kezelőt a Power Query SDK-ban, 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

Van visszajelzése, javaslata vagy hibája, amelyet jelenteni szeretne? 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.