Čítať v angličtine

Zdieľať cez


Certifikácia konektora Data Factory

Dôležité

Program certifikácie konektora momentálne prechádza zmenami a registrácia certifikácií nových konektorov je momentálne zapnutá. Tento článok sa aktualizuje po opätovnom otvorení programu certifikácie konektora pre nových partnerov. Ak máte certifikovaný konektor, ktorý chcete aktualizovať, spojte sa s naším tímom, kde dataconnectors@microsoft.com nájdete pokyny, ako odoslať novú verziu. Odosielanie sa spracúva každý mesiac a dátum odrezania pre odoslania je prvý utorok každého mesiaca.

Vlastníci zdroja údajov, ktorí vyvíjajú vlastný konektor pre svoj zdroj údajov, môžu chcieť distribuovať svoj vlastný konektor širšie používateľom služby Data Factory. Po vytvorení, použití a overení vlastného konektora koncovými používateľmi ho môže vlastník zdroja údajov odoslať na certifikáciu spoločnosti Microsoft.

Certifikáciou konektora Data Factory sa konektor verejne, predpripravené, Microsoft Fabric Data Factory a Microsoft Power BI sprístupní v týchto prostrediach:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Sémantický model služby Microsoft Power BI (v službe Power BI)
  • Microsoft Power BI Desktop
  • Lokálna brána údajov pre služby Microsoft Fabric a Microsoft Power BI

Certifikované konektory sú:

  • Udržiava ho partnerský vývojár

  • Podporované partnerským vývojárom

  • Certifikované spoločnosťou Microsoft

  • Distribuované spoločnosťou Microsoft

Spolupracujeme s partnermi a snažíme sa uistiť, že majú podporu v údržbe, ale problémy zákazníkov so samotným konektorom sú určené partnerskou vývojárkou.

Poznámka

V súčasnosti môžete využiť súpravu SDK doplnku Power Query na vytvorenie konektora, ktorý možno certifikovať prostredníctvom programu certifikácie konektora Data Factory. Prejdite na prehľad súpravy SDK doplnku Power Query, kde získate ďalšie informácie o tomto nástroji.

Prehľad certifikácií

Požiadavky

Na zabezpečenie najlepšieho prostredia pre našich zákazníkov sa budeme zaoberať len konektormi, ktoré spĺňajú súbor predpokladov certifikácie:

  • Konektor musí byť určený pre verejný produkt.

  • Konektor sa musí v počiatočnej verzii vydania považovať za hotový. Program umožňuje časté iterácie a aktualizácie. Spoločnosť Microsoft neponúka technickú pomoc ani poradenstvo vo vývoji vlastných konektorov. Odporúčame používať verejné zdroje, ako je naša dokumentácia k súprave SDK a odkladací priestor vzoriek. Ak potrebujete ďalšiu pomoc, môžeme zdieľať zoznam známych konzultantov pre vývoj vlastných konektorov tretej strany, ktorých môžete zapojiť priamo, oddelene od akéhokoľvek programu alebo partnerstva spoločnosti Microsoft. Spoločnosť Microsoft nie je spojená so žiadnou z týchto konzultantov a nie je zodpovedná za používanie ich služieb. Spoločnosť Microsoft poskytuje zoznam pre vaše pohodlie a bez akýchkoľvek uistení, odporúčaní alebo záruk. Ak sa chcete dozvedieť viac, obráťte sa na kontakt na certifikáciu spoločnosti Microsoft.

  • Vývojár musí poskytnúť odhad aktuálneho a budúceho používania.

  • Konektor musí byť už priamo k dispozícii zákazníkom na splnenie užívateľskej potreby alebo obchodného scenára. Tieto kritériá môžu byť splnené použitím programu ukážky distribúciou dokončeného konektora priamo koncovým používateľom a organizáciám. Odporúčame, aby vývojári konektorov používali mechanizmus vlastnej distribúcie a spustili interné testovanie vlastných konektorov, aby iterovali svoje konektory v riadenej skupine. Každý používateľ alebo organizácia by mali mať možnosť poskytnúť pripomienky a overenie, že konektor potrebuje podnik a že konektor úspešne funguje na plnenie svojich obchodných požiadaviek.

  • Konektor musí úspešne fungovať na očakávanej úrovni používania zo strany zákazníkov.

  • Na fóre Fabric Ideas, ktoré riadia zákazníci, musí byť postupnosť, ktorá bude označovať požiadavku na verejné sprístupnenie konektora v službe Data Factory a/alebo Power BI. Nie je nastavená žiadna prahová hodnota záväzkov. Avšak čím viac zapojenia, tým silnejší dôkazom dopytu po konektore.

Existujú tieto predpoklady na zabezpečenie toho, aby konektory podstupujúce certifikáciu mali významné množstvo zákazníkov a podnikov, ktoré je potrebné po certifikácii použiť a podporovať.

Požiadavky na certifikáciu

Na certifikáciu je k dispozícii určitý súbor požiadaviek. Uvedomujeme si, že nie každý vývojár môže spĺňať tieto požiadavky, a my dúfame, že predstavíme množinu funkcií, ktorá v krátkom čase spracuje potreby vývojárov.

Funkcie a štýl

Konektor musí spĺňať množinu pravidiel funkcií a štýlu, aby spĺňal štandard použiteľnosti konzistentný s ostatnými certifikovanými konektormi.

  • Konektor MUSÍ:

    • Použiť formát dokumentu sekcie.
    • Obsahujú hlavičku alebo ozdobu verzie nad dokumentom sekcie.
    • Zadajte metaúdaje dokumentácie k funkcii.
    • Mať obslužný program TestConnection.
    • Postupujte podľa konvencií pomenovania (napríklad DataSourceKind.FunctionName). Nemal by obsahovať slová ako "Fabric", "Power BI", "Connector" alebo "API".
    • Vrátiť údaje v tabuľkovom formáte, usporiadané do tabuliek so stĺpcami, ako pre relačný zdroj údajov. Multidimenzionálne formáty založené na kockách, dimenziách a mierkach nie sú podporované.
    • Správajte sa rovnako v režime Import a DirectQuery a vraciajte identické výsledky.
    • Nastavte príznak Beta na hodnotu True v počiatočnom vydaní.
  • Vlastnosť FunctionName má mať pre doménu zmysel (napríklad "Obsah", "Tabuľky", "Dokument", "Databázy" a tak ďalej).

  • Konektor BY MAL:

    • Majú ikony.
    • Zadajte tabuľku navigácie.
    • Umiestnite reťazce do resources.resx súboru. URL adresy a hodnoty by mali byť pevne zakódované v kóde konektora a nemali by byť umiestnené v súbore resources.resx .

Zabezpečenie

Existujú konkrétne informácie o zabezpečení, ktoré musí váš konektor spracovať.

  • Ak Extension.CurrentCredentials() sa používa:

    • Vyžaduje sa používanie? Ak áno, kam sa poverenia odosielajú?
    • Je zaručené, že sa žiadosti uskutočnia prostredníctvom protokolu HTTPS?
      • Môžete použiť funkciu pomocníka pri uplatňovaní protokolu HTTPS.
    • Ak sa poverenia odosielajú pomocou funkcie Web.Contents() GET:
      • Môže byť premenená na POST?
      • Ak sa vyžaduje funkcia GET, konektor musí použiť CredentialQueryString záznam v zázname Web.Contents() možností na odovzdanie citlivých poverení.
  • Ak sa používajú funkcie Diagnostics.*:

    • Overte, čo sa sleduje. údaje nesmú obsahovať PII ani veľké množstvo nepotrebných údajov.
    • Ak ste implementovali významné sledovanie vo vývoji, mali by ste implementovať premennú alebo príznak funkcie, ktorý určí, či má byť zapnuté sledovanie. Toto sledovanie musí byť vypnuté pred odoslaním na certifikáciu.
  • Ak Expression.Evaluate() sa používa:

    • Overte, odkiaľ výraz pochádza a čo to je (to znamená, môže dynamicky vytvárať volania na Extension.CurrentCredentials(), a tak ďalej).
    • Používateľ Expression by nemal byť zadaný a používateľ by nemal prijímať vstup od používateľa.
    • Hodnota Expression by nemala byť dynamická (t. j. načítaná z webového volania).

Po certifikácii

Keď je váš konektor certifikovaný a vydaný prostredníctvom služieb Microsoft Fabric a Microsoft Power BI, existuje niekoľko vecí, ktoré by ste mali urobiť, aby ste mali istotu, že môžete správne používať verejne dostupný verejne certifikovaný konektor nasadený v produkčnom prostredí.

  • Vy a koncoví používatelia by ste mali používať verziu certifikovaného konektora, ktorá je súčasťou prostredí ešte pred certifikáciou (ako napríklad Power BI Desktop a Brána údajov), a odstrániť všetky existujúce súbory .mez alebo .pqx (vlastné konektory) používané pred certifikáciou. V opačnom môže dôjsť k neúmyselnému použitiu vášho testovacieho vlastného konektora power query namiesto novo certifikovaného konektora.
  • Vlastné konektory by sa mali použiť iba na testovanie nových verzií konektora.
  • Pri práci s koncovými používateľmi a zákazníkmi sa ubezpečte, že po dokončení testovania by mali byť odstránené informácie o verzii vlastného konektora, ktorá sa používa pri testovaní pred certifikáciou, a aby bola k dispozícii nová verzia certifikovaného konektora.