Power Query Csatlakozás or minősítés

  • Cikk

Feljegyzés

Ez a cikk az egyéni Power Query-összekötő minősítéshez való elküldésének követelményeit és folyamatát ismerteti. A minősítési folyamat megkezdése előtt olvassa el a teljes cikket.

Bevezetés

A Power Query SDK-val mindenki létrehozhat egy egyéni Power Query-összekötőt, amely a Power Queryből csatlakozik egy adatforráshoz. Az egyéni összekötők jelenleg csak a Power BI szemantikai modelljeiben (Power BI Desktop és Power BI szolgáltatás) támogatottak, és helyszíni adatátjárót kell használniuk a Power BI szolgáltatás keresztüli frissítéshez. Az egyéni összekötőket a fejlesztőnek külön-külön kell elosztania.

Előfordulhat, hogy azok az adatforrás-tulajdonosok, akik egyéni összekötőt fejlesztenek az adatforrásukhoz, szélesebb körben szeretnék elosztani az egyéni összekötőt a Power Query felhasználói között. Miután a végfelhasználók létrehozták, használták és ellenőrizték az egyéni összekötőt, az adatforrás tulajdonosa elküldheti azt a Microsoft minősítésére.

Az egyéni Power Query-összekötő minősítésével az összekötő nyilvánosan, házon kívül érhető el a Power BI szemantikai modelljeiben (Power BI Desktop és Power BI szolgáltatás), Power BI-adatfolyamokban és Power BI-adatmartákban. A minősített összekötők PowerBI.com és a Power BI Premium összes verziójában támogatottak.

A minősített összekötők a következők:

  • A partnerfejlesztő tartja karban

  • A partnerfejlesztő támogatja

  • A Microsoft minősítése

  • A Microsoft terjeszti

A partnerekkel együttműködve igyekszünk meggyőződni arról, hogy támogatják a karbantartást, de az összekötővel kapcsolatos ügyfélproblémák a partnerfejlesztőhöz lesznek irányítva.

Minősített összekötők és egyéni összekötők közötti különbségek

A minősített összekötők csomagon kívül vannak csomagolva a Power BI Desktopban, és üzembe helyezhetők a Power BI Szolgáltatásban, a Power BI-adatfolyamokban és a Power BI-adatmartokon. Az egyéni összekötők csak a Power BI szemantikai modelljeiben támogatottak, és a Power BI Desktopban kell betölteni a bővítmény Power BI Desktopban való betöltéséről. A hitelesített és az egyéni összekötők is frissíthetők a Power BI Desktopon vagy a Power BI Szolgáltatáson keresztül egy helyszíni adatátjáró használatával egy teszt Csatlakozás ion implementálásával. Az egyéni összekötőkhöz a helyszíni adatátjáró szükséges.

A Power BI Desktopban implementációval rendelkező TestConnection minősített összekötők a felhőben (Power BI Szolgáltatás) a helyszíni adatátjáró nélkül is támogatják a végpontok közötti frissítést. A Power BI szolgáltatás környezet lényegében a helyszíni átjáróhoz hasonló "felhőátjárót" üzemeltet. A minősítés után üzembe helyezzük az összekötőt ebben a környezetben, hogy az minden Power BI-ügyfél számára elérhető legyen.

Az extra összetevőkkel (például ODBC-illesztővel) rendelkező egyéni és minősített összekötőknek is telepíteniük kell a további összetevőt a végfelhasználói gépre, és a helyszíni adatátjárót kell igényelniük, kivéve, ha a további összetevőt a Power BI-felhőben helyezik üzembe. Jelenleg nem minősítünk és helyezünk üzembe új extra összetevőket a Power BI-felhőben, így a további összetevőktől függő összekötők minősítése nem fogja megszüntetni a helyszíni adatátjáróra vonatkozó követelményt.

Egyéni összekötő-elosztás

Az egyéni összekötők a hitelesítés előtt terjeszthetők és terjeszthetők a végfelhasználók számára.

Mivel az M egy sokoldalú nyelv, amely a hitelesítés kezelése során látható, képes a tárolt hitelesítő adatok kezelésére, lehetővé kell tenni a felhasználóknak, hogy csak megbízható összekötők fussanak.

A fejlesztők szempontjából a fejlesztőknek önalá kell írniuk az egyéni összekötőjüket, és meg kell adniuk a felhasználóiknak az adatokat (ujjlenyomatot), hogy biztonságosan betölthessék azt.

A felhasználók szempontjából a felhasználóknak a fejlesztő ujjlenyomatát kell használniuk az egyéni összekötő biztonságos megbízhatóságához és betöltéséhez. A felhasználók dönthetnek úgy is, hogy csökkentik a biztonsági beállításokat, hogy engedélyezzék a Microsoft vagy egy másik fejlesztő által nem hitelesített kód betöltését, de ez a beállítás nem ajánlott.

Minősítés áttekintése

Előfeltételek

A legjobb felhasználói élmény biztosítása érdekében csak olyan összekötőket veszünk figyelembe, amelyek megfelelnek a minősítés előfeltételeinek:

  • Az összekötőnek nyilvános termékhez kell lennie.

  • Az összekötőt kóddal kiegészítettnek kell tekinteni egy kezdeti kiadási verzióhoz. A program lehetővé teszi a gyakori iterációkat és frissítéseket. Vegye figyelembe, hogy a Microsoft nem nyújt műszaki segítséget vagy egyéni összekötőfejlesztési tanácsadást. Javasoljuk, hogy használja ki az olyan nyilvános erőforrásokat, mint az SDK dokumentációja és a mintaadattár. Ha további segítségre van szüksége, megoszthatjuk az ismert, harmadik féltől származó egyéni összekötő-fejlesztési tanácsadók listáját, amelyeket közvetlenül szeretne bevonni, függetlenül a Microsoft-programoktól vagy partnerségektől. Vegye figyelembe, hogy a Microsoft egyik tanácsadóval sem áll kapcsolatban, és nem felelős a szolgáltatásaik ön általi használatáért. A Microsoft biztosítja a listát az Ön kényelme érdekében, garanciák, javaslatok és garanciák nélkül. További információért forduljon a Microsoft minősítési kapcsolattartójához.

  • A fejlesztőnek meg kell adnia a használat becslését. Javasoljuk, hogy a nagyon butik termékek összekötőinek fejlesztői az összekötő önaláírási képességeivel közvetlenül az ügyfél számára biztosítsák őket.

  • Az összekötőt már elérhetővé kell tenni közvetlenül az ügyfelek számára a felhasználói igények vagy üzleti forgatókönyvek teljesítéséhez. Ez a feltétel egy Privát előzetes verziós program használatával teljesíthető úgy, hogy a kész összekötőt önaláírással közvetlenül a végfelhasználóknak és szervezeteknek osztja el. Minden felhasználónak vagy szervezetnek képesnek kell lennie arra, hogy visszajelzést és ellenőrzést küldjön arról, hogy üzleti igény van az összekötőre, és hogy az összekötő sikeresen dolgozik az üzleti követelmények teljesítésén.

  • Az összekötőnek sikeresnek kell lennie az ügyfelek által várt használati szinten.

  • A Power BI Ideas fórumában egy olyan szálnak kell lennie, amelyet az ügyfelek hajtanak, hogy jelezzék az összekötő nyilvánosan elérhetővé tétele iránti igényt a Power BI Desktopban. Nincs meghatározott előjegyzési küszöbérték. Minél nagyobb az előjegyzés, annál erősebb az összekötő iránti kereslet.

Ezek az előfeltételek biztosítják, hogy a minősítésen átesett összekötők jelentős ügyfél- és üzleti igényekkel rendelkezzenek, és a minősítést követően támogatottak legyenek.

Folyamat és idősorok

A hitelesített összekötők havi Power BI Desktop-kiadásokkal jelennek meg, így az egyes kiadásokra vonatkozó határidők minden Power BI Desktop-kiadási dátumtól visszaváltanak. A minősítési folyamat várható időtartama a regisztrációtól a kiadásig az összekötő beküldésének minőségétől és összetettségétől függően változik. A Microsoft nem biztosít konkrét ütemtervgaranciát az összekötők áttekintésére és jóváhagyására vonatkozóan. Az egyes összekötő-felülvizsgálatok kemény határidőit az alábbi lépések ismertetik, de a Microsoft nem garantálja ezeknek az ütemterveknek a betartását.

  • Regisztráció: értesítés az egyéni összekötő minősítési szándékáról. Ennek a regisztrációnak a hónap 15-éig kell történnie, két hónappal a célzott Power BI asztali kiadás előtt.

    • Az áprilisi Power BI Desktop-kiadás esetében például a határidő február 15.

  • Beküldés: összekötőfájlok beküldése Microsoft-felülvizsgálathoz. Ezt a beküldést a célként megadott Power BI desktop kiadás előtti hónap 1. hónapjának kell elvégeznie.

    • Az áprilisi Power BI Desktop-kiadás esetében például a határidő március 1.

  • Technikai felülvizsgálat: az összekötőfájlok véglegesítése, a Microsoft-felülvizsgálat és a minősítés átadása. A felülvizsgálatnak a célzott Power BI Desktop-kiadás előtti hónap 15-éig kell történnie.

    • Az áprilisi Power BI Desktop-kiadás esetében például a határidő március 15.

A műszaki felülvizsgálatok és a lehetséges késések, az újratervezés és a tesztelési problémák összetettsége miatt javasoljuk, hogy a kezdeti kiadáshoz és minősítéshez hosszú átfutási idővel küldje be a korai szakaszt. Ha úgy érzi, hogy az összekötő fontos, hogy minimális többletterheléssel lásson el néhány ügyfelet, javasoljuk az önaláírást és annak biztosítását.

Tanúsítási követelmények

Bizonyos követelményekkel rendelkezünk a minősítéshez. Tisztában vagyunk azzal, hogy nem minden fejlesztő felel meg ezeknek a követelményeknek, és reméljük, hogy bevezetünk egy olyan funkciókészletet, amely rövid időn belül kezeli a fejlesztői igényeket.

Beküldési fájlok (összetevők)

Győződjön meg arról, hogy a beküldött összekötőfájlok a következők mindegyikét tartalmazzák:

  • Csatlakozás or (.mez) fájl

    • A .mez fájlnak stílusszabványokat kell követnie, és a termék vagy szolgáltatás nevéhez hasonlóan kell elneveznie. Nem tartalmazhat olyan szavakat, mint a "Power BI", a "Csatlakozás or" vagy az "API".
    • Nevezze el a .mez fájlt: ProductName.mez

  • Power BI Desktop -fájl (.pbix) teszteléshez

    • Az összekötő teszteléséhez power BI-mintajelentésre (.pbix) van szükség.
    • A jelentésnek tartalmaznia kell legalább egy lekérdezést a navigációs tábla egyes elemeinek teszteléséhez.
    • Ha nincs beállított séma (például adatbázisok), a jelentésnek tartalmaznia kell egy lekérdezést az összekötő által kezelt táblák minden egyes "típusához".

  • Fiók tesztelése az adatforrásban

    • A tesztfiók használatával teszteljük és elhárítjuk az összekötőt.
    • Adjon meg egy állandó tesztfiókot, hogy ugyanazzal a fiókkal hitelesíteni tudjuk a jövőbeli frissítéseket.

  • Tesztelési utasítások

    • Adja meg az összekötő használatáról és működésének teszteléséről szóló dokumentációt.

  • Külső függőségekre mutató hivatkozások (például ODBC-illesztőprogramok)

Funkciók és stílus

Az összekötőnek olyan funkció- és stílusszabályokat kell követnie, hogy megfeleljenek a más minősített összekötőkkel összhangban lévő használhatósági szabványoknak.

  • Az összekötőNEK:

    • Szakaszdokumentum formátumának használata.
    • Tartalmaz egy verziófejlécet/ékesítést a szakaszdokumentum felett.
    • Adja meg a függvénydokumentáció metaadatait.
    • A Test Csatlakozás ion kezelője.
    • Kövesse az elnevezési konvenciók (például DataSourceKind.FunctionName). Nem tartalmazhat olyan szavakat, mint a "Power BI", a "Csatlakozás or" vagy az "API".
    • Állítsa a béta jelölőt True (Igaz) értékre a kezdeti kiadáskor.

  • A FunctionName tartománynak (például "Tartalom", "Táblák", "Dokumentum", "Adatbázisok" stb.) van értelme.

  • Az összekötőNEK:

    • Ikonok.
    • Adjon meg egy navigációs táblát.
    • Sztringek elhelyezése fájlban resources.resx . Az URL-címeket és az értékeket az összekötő kódjában kell kódolni, és nem szabad a resources.resx fájlba helyezni.

Biztonság

Az összekötőnek bizonyos biztonsági szempontokat kell figyelembe vennie.

  • Ha Extension.CurrentCredentials() a rendszer a következőt használja:

    • Szükség van a használatra? Ha igen, hová küldik a hitelesítő adatokat?
    • A kérések biztosan HTTPS-kapcsolaton keresztül adhatók meg?
    • Ha a hitelesítő adatokat a GET használatával Web.Contents() küldi el:
      • Lehet postává alakítani?
      • Ha GET szükséges, az összekötőnek a CredentialQueryString beállításrekord rekordját Web.Contents() kell használnia a bizalmas hitelesítő adatok átadásához.

  • A Diagnostics.* függvények használata esetén:

    • A nyomon követendő adatok ellenőrzése; az adatok nem tartalmazhatnak PII-t vagy nagy mennyiségű szükségtelen adatot.
    • Ha jelentős nyomkövetést hajtott végre a fejlesztés során, olyan változót vagy funkciójelzőt kell implementálnia, amely meghatározza, hogy a nyomkövetés be legyen-e kapcsolva. Ezt a nyomkövetést ki kell kapcsolni a minősítésre való küldés előtt.

  • Ha Expression.Evaluate() a rendszer a következőt használja:

    • Ellenőrizze, hogy a kifejezés honnan származik, és mi az (azaz dinamikusan képes hívásokat Extension.CurrentCredentials() létrehozni stb.).
    • A Expression felhasználónak nem szabad megadnia, és nem szabad felhasználói adatokat megadnia.
    • A Expression rendszer nem lehet dinamikus (vagyis webes hívásból kéri le).

Regisztrálás minősítésre

Ha szeretné folytatni az egyéni összekötő minősítését, győződjön meg arról, hogy a forgatókönyv és az összekötő megfelel a cikkben ismertetett előfeltételeknek és követelményeknek . Ennek elmulasztása késlelteti a minősítést, mivel csapatunk megköveteli, hogy a minősítéssel való továbblépés előtt kijavítsa az esetleges problémákat vagy inkonzisztenciákat.

Győződjön meg arról, hogy az összekötő teljes kóddal rendelkezik, és a Power BI Desktopban végzett szerkesztésben, valamint a Power BI szolgáltatásban való frissítésben és használatban is tesztelve van. Győződjön meg arról, hogy a Power BI szolgáltatás teljes körű frissítését tesztelte egy helyszíni adatátjáró használatával.

Első lépésként töltse ki a regisztrációs űrlapot, és egy Microsoft-kapcsolattartó kapcsolatba lép a folyamat megkezdéséhez.

Minősítés után

Az összekötő Power BI Desktopon és Power BI szolgáltatás keresztül történő minősítése és kiadása után néhány dolgot meg kell tennie annak érdekében, hogy megfelelően tudja használni az éles környezetben üzembe helyezett nyilvánosan elérhető hitelesített összekötőt.

  • Önnek és a végfelhasználóknak a Power BI Desktopban és a helyszíni adatátjáróban található hitelesített összekötő-verziót kell használniuk, és el kell távolítaniuk a minősítés előtt használt meglévő .mez- vagy .pqx-fájlokat (egyéni összekötőket). Ennek elmulasztása azt eredményezheti, hogy a Power Query véletlenül használja az egyéni összekötőt az újonnan minősített összekötő helyett.
  • Az egyéni összekötők csak az összekötő új verzióinak tesztelésére használhatók.
  • Amikor végfelhasználókkal és ügyfelekkel dolgozik, győződjön meg arról, hogy tisztában van azzal, hogy a hitelesítés előtti tesztelés során használt egyéni összekötő-verziót el kell távolítani a tesztelés befejezése után, és elérhető az új hitelesített összekötő verziója.

Miután kifejlesztett egy összekötőt egy adatforráshoz, fontolja meg, hogy sablonalkalmazás létrehozásával segítse az ügyfeleket a gyors üzembe helyezésben. A sablonalkalmazások előre összeállított jelentést biztosítanak az ügyfeleknek az adataikhoz, amelyeket igény szerint használhatnak, vagy testre szabhatnak.

Feljegyzés

A sablonalkalmazások nem támogatják az átjárót igénylő összekötőket.