Összekötő fejlesztése a Power Query SDK használatával
A Power Query SDK olyan eszközök készlete, amelyekkel Power Query-összekötőket hozhat létre. Ezeket az összekötőket gyakran nevezik egyéni összekötőknek vagy Power Query-bővítményeknek.
Az egyéni összekötők segítségével új adatforrásokat hozhat létre, vagy testre szabhat és kibővíthet egy meglévő forrást. Gyakori használati esetek a következők:
- Üzleti elemzőbarát nézet létrehozása REST API-hoz.
- A Power Query által támogatott forrás arculatának biztosítása meglévő összekötővel (például OData szolgáltatással vagy ODBC-illesztővel).
- OAuth v2 hitelesítési folyamat implementálása SaaS-ajánlathoz.
- Korlátozott vagy szűrt nézet megjelenítése az adatforráson a használhatóság javítása érdekében.
- DirectQuery engedélyezése adatforráshoz ODBC-illesztővel.
Telepítse a Visual Studio Code Power Query SDK-t a Visual Studio Marketplace Visual Studio Code szakaszából. Válassza a Telepítés lehetőséget az SDK telepítéséhez.
A következő szakaszok magas szinten ismertetik a Power Query-összekötő SDK használatával történő létrehozásának leggyakoribb folyamatát.
Új munkaterület (Visual Studio Code Power Query SDK) létrehozásakor a következő alapvető fájlokkal kell kezdenie:
- Összekötődefiníciós fájl (<connectorName.pq>)
- Lekérdezésfájl (<connectorName.query.pq>)
- Sztring típusú erőforrásfájl (resources.resx)
- Ikonok létrehozásához használt különböző méretű PNG-fájlok
Az összekötő definíciós fájlja üres adatforrás-leírással kezdődik. Az adatforrásokról a Power Query SDK környezetében az adathozzáférés kezeléséről szóló cikkből tudhat meg többet.
A Power Query SDK alapvető lekérdezés-végrehajtási képességeket biztosít, így anélkül tesztelheti a bővítményt, hogy át kellene váltania egy másik ügyfélalkalmazásra. Az összekötőt tovább tesztelheti egy alkalmazásban, például:
A bővítményfájl mellett a Data Connector-projektek lekérdezésfájllal (name.query.pq) is rendelkezhetnek. Ez a fájl használható teszt lekérdezések futtatására a Visual Studio Code-on belül. A lekérdezés kiértékelése automatikusan tartalmazza a bővítménykódot anélkül, hogy regisztrálnia kellene a.pqx fájlt, így meghívhatja vagy tesztelheti a megosztott függvényeket a bővítménykódban.
A lekérdezésfájl tartalmazhat egyetlen kifejezést (például egy kifejezést), egy let
kifejezést (például azt, HelloWorld.Contents()
amit a Power Query generálna) vagy egy szakaszdokumentumot.
A projekt létrehozása létrehozza a .mez fájlt vagy a bővítményfájlt. A Power Query-bővítmények zip-fájlba vannak csomagolva, és .mez kiterjesztést kapnak.
A bővítmények egy M szakaszdokumentumban vannak definiálva. A szakaszdokumentumok formátuma kissé eltér a Power Queryben létrehozott lekérdezési dokumentum(ok) formátumától. A Power Queryből importált kód általában módosítást igényel, hogy beleférjen egy szakaszdokumentumba, de a módosítások kisebbek. A szakaszdokumentumok eltéréseit érdemes figyelembe vennie a következőkben:
- Szakaszdeklarációval kezdődnek (például
section HelloWorld;
). - Minden kifejezés kettősponttal végződik (például
a = 1;
b = let c = 1 + 2 in c;
). - A szakaszdokumentum minden függvénye és változója helyi, kivéve, ha megosztottként van megjelölve. A megosztott függvények más lekérdezések/függvények számára is láthatóvá válnak, és a bővítmény exportálásaként is felfoghatók (azaz meghívhatók a Power Queryből).
Az M szakaszdokumentumokkal kapcsolatos további információk az M nyelvi specifikációjában találhatók.
Két elérési útja van, amelyekben eloszthatja az összekötőt:
- Öneloszlás
- Összekötő minősítése
Önkiszolgáló mechanizmus, amelyben egyéni Power Query-összekötőket alkalmazhat a vonatkozó termékélményekben
Miután létrehozta az összekötőt, elküldheti ezt a fájlt a felhasználóknak, és használhatják az összekötőt a vonatkozó termékélményekben, például a Microsoft Power BI-ban.
Saját egyéni összekötőt használhat a Microsoft Power BI Desktopban és a Szemantikai modellekhez készült Microsoft Power BI szolgáltatásban a felhőbeli frissítéshez és kapcsolathoz.
A Power Query-összekötők három szolgáltatásba tölthetők be:
- Helyszíni adatátjáró: Az összekötő betölthető az átjárón keresztül a Microsoft Fabricben és a Microsoft Power BI szolgáltatás
- Power Query Online: olyan szolgáltatásokon belül, mint a Power BI Datamarts, a Fabric Dataflow Gen2 és sok más
- Power Query Desktop: olyan szolgáltatásokban, mint a Power BI Desktop.
Az alábbi cikkekből többet is megtudhat arról, hogyan használhatja az egyéni összekötőt önterjesztésre:
- Egyéni Power Query-összekötő betöltése a Power BI Desktopban
- Egyéni összekötők engedélyezése és használata a Power BI szolgáltatásban
A Data Factory összekötőtanúsítványi programja lehetővé teszi, hogy az összekötőt tanúsítványként küldje el a Microsoftnak, ahol a Microsoft gondoskodik az összekötő közzétételéről és terjesztéséről a Microsoft Fabricben és a Microsoft Power BI-ban az alkalmazható termékek és szolgáltatások tekintetében:
- Power Query Desktop: Microsoft Power BI Desktop.
- Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 és mások
- Helyszíni adatátjáró: Mind a Microsoft Fabric, mind a Microsoft Power BI esetében, amely átjárót használ a hitelesített frissítéshez vagy kapcsolathoz.
További információ a Data Factory Connector tanúsítási programjáról.