Data Factory-összekötő minősítése

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 Data Factory felhasználói között. Ha a végfelhasználók létrehoznak, használnak és érvényesítenek egy egyéni összekötőt, az adatforrás tulajdonosa elküldheti azt a Microsoft minősítésére.

A Data Factory-összekötő minősítésével az összekötő nyilvánosan, beépített módon, a Microsoft Fabric Data Factoryben és a Microsoft Power BI-ban érhető el az alábbi szolgáltatásokban:

• Microsoft Fabric Dataflow Gen2
• Microsoft Power BI Adatfolyam Gen1
• Microsoft Power BI Datamart
• Microsoft Power BI szemantikai modell (a Power BI szolgáltatásban)
• Microsoft Power BI Desktop
• Helyszíni adatátjáró a Microsoft Fabrichez és a Microsoft Power BI-hoz

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 kerülnek.

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. A Microsoft nem nyújt műszaki segítséget vagy egyéni összekötőfejlesztési tanácsadást. Javasoljuk, hogy olyan nyilvános erőforrásokat használjunk, 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. 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 jelenlegi és jövőbeli használat becslését.

• 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 előzetes verziójú program használatával teljesíthető úgy, hogy a kész összekötőt közvetlenül a végfelhasználóknak és szervezeteknek osztja el. Javasoljuk, hogy az összekötők fejlesztői önelosztó mechanizmust használjanak, és futtasson belső tesztelést saját összekötőiken, hogy egy ellenőrzött csoport alatt iterálják át az összekötőket. 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 Fabric Ideas fórumban egy szálnak kell lennie, amelyet az ügyfelek vezérelnek, hogy jelezzék az összekötő nyilvánosan elérhetővé tétele iránti igényt a Data Factoryben és/ vagy a Power BI-ban. 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 feltételeket használjanak és támogassanak a minősítést követően.

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.

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 TestConnection kezelője.
  • Kövesse az elnevezési konvenciók (például DataSourceKind.FunctionName). Nem tartalmazhat olyan szavakat, mint a "Fabric", a "Power BI", az "Connector" vagy az "API".
  • Táblázatos formátumú adatokat ad vissza oszlopokkal rendelkező táblákba rendezve, mint egy relációs adatforrás esetében. A kockákon, dimenziókon és mértékeken alapuló többdimenziós formátumok nem támogatottak.
  • Ugyanúgy viselkedjen Importálás és DirectQuery módban, és azonos eredményeket ad vissza.
  • Á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?
    • Használhatja a HTTPS-kényszerítési segédfüggvényt.
  • 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 kell felhasználói adatokat megadnia.
  • A Expression rendszer nem lehet dinamikus (vagyis webes hívásból kéri le).

Minősítés után

Miután az összekötőt a Microsoft Fabric és a Microsoft Power BI szolgáltatással hitelesítette és kiadta, 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 minősítés előtt a környezetekben (például a Power BI Desktopban és az Adatátjáróban) szereplő 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.