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.

Csatlakozás or fejlesztési folyamat

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:

  • Csatlakozás or 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 a Power BI Desktopra.

Lekérdezési tesztfájl

A bővítményfájl mellett az Adat Csatlakozás or-projektek lekérdezésfájllal is rendelkezhetnek (name.query.pq). 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. Futásidőben a Power BI Desktop betölti a bővítményeket a [Documents]\Microsoft Power BI Desktop\Custom Csatlakozás ors fájlból.

Feljegyzés

Az adat-Csatlakozás or-projektek nem támogatják a bővítményfájl [Documents]\Microsoft Power BI Desktop\Custom Csatlakozás ors könyvtárba másolásához szükséges egyéni buildelési lépéseket. Ha ezt meg szeretné tenni, érdemes lehet külső bővítményt használnia.

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.

Adatösszekötők elosztása

A Power Query-összekötők a Power BI Desktopban vagy a Power Query Online-ban is használhatók, például Power BI-adatfolyamok, Power BI-adatmartok és egyéb szolgáltatások.

Power BI Desktop

A Power BI Desktop felhasználói az alábbi lépéseket követve használhatnak egyéni Power Query-összekötőt:

  1. Másolja a kiterjesztésfájlt (.mez vagy.pqx) a [Documents]/Power BI Desktop/Custom Csatlakozás ors fájlba.
  2. A Power BI Desktopban válassza a (Nem ajánlott) Bármely bővítmény betöltésének engedélyezése ellenőrzés vagy figyelmeztetés nélkül lehetőséget a Fájlbeállítások>és beállítások>beállítások>biztonsági>adatkiterjesztések területén.
  3. Indítsa újra a Power BI Desktopot.

A Power BI Desktop automatikusan betölti a bővítményeket újraindításra.

Azt is megteheti, hogy az adatforrás és az összekötő tulajdonosaként beküldi az összekötőt a Power Query Csatlakozás or Certification programba, hogy minden kiadásban a Power BI Desktopot használja.

Power Query Online

A Power Query Online felületén csak a Power Query minősített összekötői jelennek meg. A Power Query-összekötő minősítési programjáról a Power Query Csatlakozás or Certification című témakörben olvashat bővebben.