Sdílet prostřednictvím

Certifikace konektoru Data Factory

  • Článek

Důležité

V současné době probíhá změny v programu certifikace konektorů a registrace nových certifikací konektorů je aktuálně blokována. Tento článek se aktualizuje, jakmile se znovu otevře certifikační program konektoru pro nové partnery. Pokud máte certifikovaný konektor, který chcete aktualizovat, spojte se s naším týmem dataconnectors@microsoft.com s pokyny, jak odeslat novou verzi. Přihlášky se zpracovávají každý měsíc a uzávěrka pro podání je první úterý každého měsíce.

Vlastníci zdrojů dat, kteří pro svůj zdroj dat vyvíjejí vlastní konektor, můžou chtít distribuovat vlastní konektor uživatelům služby Data Factory obecněji. Po vytvoření, použití a ověření vlastního konektoru koncovými uživateli ho vlastník zdroje dat může odeslat k certifikaci Microsoftu.

Certifikace konektoru Data Factory zpřístupňuje konektor veřejně, předem dostupný, Microsoft Fabric Data Factory a Microsoft Power BI v následujících prostředích:

  • Microsoft Fabric Dataflow Gen2
  • Microsoft Power BI Dataflow Gen1
  • Microsoft Power BI Datamart
  • Sémantický model Microsoft Power BI (ve službě Power BI)
  • Microsoft Power BI Desktop
  • Místní brána dat pro Microsoft Fabric a Microsoft Power BI

Certifikované konektory jsou:

  • Spravuje ho partnerský vývojář.

  • Podporuje ho partnerský vývojář.

  • Certifikováno microsoftem

  • Distribuuje microsoft

Spolupracujeme s partnery a snažíme se zajistit, aby měli podporu při údržbě, ale problémy zákazníků se samotným konektorem jsou směrovány na vývojáře partnera.

Poznámka:

V současné chvíli můžete využít sadu Power Query SDK k vytvoření konektoru, který je možné certifikovat prostřednictvím certifikačního programu konektoru Data Factory. Přejděte na přehled sady Power Query SDK, kde najdete další informace o tomto nástroji.

Přehled certifikace

Požadavky

Abychom zajistili co nejlepší prostředí pro naše zákazníky, zvažujeme pouze konektory, které splňují sadu požadavků pro certifikaci:

  • Konektor musí být určený pro veřejný produkt.

  • Konektor musí být pro počáteční verzi verze považován za dokončený kód. Program umožňuje časté iterace a aktualizace. Microsoft nenabízí technickou pomoc ani konzultace s vývojem vlastních konektorů. Doporučujeme používat veřejné prostředky, jako je naše dokumentace k sadě SDK a úložiště ukázek. Pokud potřebujete další pomoc, můžeme sdílet seznam známých konzultantů pro vývoj vlastních konektorů třetích stran, které byste mohli chtít zapojit přímo, odděleně od jakéhokoli programu nebo partnerství Microsoftu. Společnost Microsoft není přidružená k žádnému z těchto konzultantů a není zodpovědná za vaše používání jejich služeb. Microsoft poskytuje seznam pro usnadnění práce a bez jakýchkoli záruk, doporučení nebo záruk. Pokud se chcete dozvědět víc, obraťte se na svůj kontaktní kontakt na certifikaci Microsoftu.

  • Vývojář musí poskytnout odhad aktuálního a budoucího využití.

  • Konektor musí být již zpřístupněn zákazníkům přímo kvůli splnění potřeb uživatele nebo obchodního scénáře. Tato kritéria je možné splnit pomocí programu ve verzi Preview tak, že dokončený konektor distribuuje přímo koncovým uživatelům a organizacím. Doporučujeme, aby vývojáři konektorů používali mechanismus samoobslužné distribuce a spustili interní testování vlastních konektorů, aby iterovali své konektory pod kontrolovanou skupinou. Každý uživatel nebo organizace by měl mít možnost poskytnout zpětnou vazbu a ověření, že konektor potřebuje obchodní potřebu a že konektor úspěšně pracuje na splnění svých obchodních požadavků.

  • Konektor musí úspěšně fungovat na očekávané úrovni využití zákazníky.

  • Ve fóru Nápady k prostředkům infrastruktury musí existovat vlákno řízené zákazníky, které indikuje poptávku, aby byl konektor veřejně dostupný ve službě Data Factory nebo Power BI. Není nastavená prahová hodnota zapojení. Čím větší zapojení, tím silnější je poptávka po konektoru.

Tyto požadavky existují, aby se zajistilo, že konektory procházející certifikací mají významné zákazníky a firmy, které je potřeba použít k a podpoře po certifikaci.

Požadavky na certifikaci

Máme určitou sadu požadavků na certifikaci. Uvědomujeme si, že ne každý vývojář může tyto požadavky splnit, a doufáme, že zavedeme sadu funkcí, která bude zpracovávat potřeby vývojářů v krátkém pořadí.

Funkce a styl

Konektor musí dodržovat sadu pravidel pro funkce a styl, aby splňoval standard použitelnosti konzistentní s ostatními certifikovanými konektory.

  • Konektor MUSÍ:

    • Použijte formát dokumentu oddílu.
    • Obsahují hlavičku nebo doplněk verze nad dokumentem oddílu.
    • Zadejte metadata dokumentace funkce.
    • Mají obslužnou rutinu TestConnection.
    • Postupujte podle konvencí vytváření názvů (například DataSourceKind.FunctionName). Neměla by obsahovat slova jako "Fabric", "Power BI", "Connector" nebo "API".
    • Vrátí data v tabulkovém formátu uspořádaná do tabulek se sloupci, jako je relační zdroj dat. Multidimenzionální formáty založené na datových krychlích, dimenzích a mírách se nepodporují.
    • Chová se stejně v režimu Import a DirectQuery a vrací identické výsledky.
    • V počáteční verzi nastavte příznak Beta na Hodnotu True.

  • Měl FunctionName by dávat smysl pro doménu (například Obsah, Tabulky, Dokument, Databáze atd.).

  • Konektor BY MĚL:

    • Máte ikony.
    • Zadejte navigační tabulku.
    • Umístěte řetězce do resources.resx souboru. Adresy URL a hodnoty by měly být pevně zakódované v kódu konektoru resources.resx a neměly by být umístěny do souboru.

Zabezpečení

Je potřeba zvážit konkrétní aspekty zabezpečení, které musí váš konektor zpracovat.

  • Pokud Extension.CurrentCredentials() se používá:

    • Vyžaduje se využití? Pokud ano, kam se přihlašovací údaje odesílají?
    • Je zaručeno, že se požadavky provádějí prostřednictvím protokolu HTTPS?
    • Pokud se přihlašovací údaje odesílají přes Web.Contents() GET:
      • Je možné ho převést na POST?
      • Pokud se vyžaduje get, musí konektor použít CredentialQueryString záznam v záznamu Web.Contents() možností k předání citlivých přihlašovacích údajů.

  • Pokud se používají funkce Diagnostics.*:

    • Ověřte, co se sleduje; data nesmí obsahovat PII ani velké objemy nepotřebných dat.
    • Pokud jste implementovali významné trasování ve vývoji, měli byste implementovat příznak proměnné nebo funkce, který určuje, jestli má být trasování zapnuté. Toto trasování musí být před odesláním k certifikaci vypnuté .

  • Pokud Expression.Evaluate() se používá:

    • Ověřte, odkud výraz pochází a z čeho pochází (to znamená, že může dynamicky vytvářet volání atd Extension.CurrentCredentials().).
    • Neměl Expression by být poskytnutý uživatelem ani nezadávat vstup uživatele.
    • Nemělo Expression by být dynamické (to znamená načtené z webového volání).

Po certifikaci

Po certifikaci a vydání konektoru prostřednictvím prostředí Microsoft Fabric a Microsoft Power BI je potřeba udělat několik věcí, které byste měli udělat, abyste měli jistotu, že můžete správně používat veřejně dostupný certifikovaný konektor nasazený v produkčním prostředí.

  • Vy a koncoví uživatelé byste měli použít certifikovanou verzi konektoru, která je součástí prostředí před certifikací (jako je Power BI Desktop a brána dat), a před certifikací odebrat všechny existující soubory .mez nebo .pqx (vlastní konektory). Pokud to neuděláte, může to vést k tomu, že váš testovací vlastní konektor používá Power Query neúmyslně místo nově certifikovaného konektoru.
  • Vlastní konektory by se měly používat jenom k otestování nových verzí konektoru.
  • Při práci s koncovými uživateli a zákazníky se ujistěte, že po dokončení testování by se měla odebrat verze vlastního konektoru, která se používá při testování před certifikací, a že je k dispozici nová certifikovaná verze konektoru.