Megosztás a következőn keresztül:

Összekötő fejlesztése a Power Query SDK használatával

  • Cikk

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.

A Power Query SDK telepítése

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.

Összekötők fejlesztési folyamata

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 bővítmény létrehozása

Ú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.

Tesztelés

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:

Lekérdezési tesztfájl

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.

Létrehozás és üzembe helyezés

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.

Power Query-összekötők elosztása

Két elérési útja van, amelyekben eloszthatja az összekötőt:

  • Öneloszlás
  • Összekötő minősítése

Öneloszlás

Ö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.

Microsoft Power BI

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:

Összekötő minősítése

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.