Certifikace Připojení oru Power Query

  • Článek

Poznámka:

Tento článek popisuje požadavky a proces odeslání vlastního konektoru Power Query k certifikaci. Než začnete s procesem certifikace, přečtěte si celý článek.

Úvod

S využitím sady Power Query SDK je každý zmocněný k vytvoření vlastního konektoru Power Query pro připojení ke zdroji dat z Power Query. V současné době se vlastní konektory podporují jenom v sémantických modelech Power BI (Power BI Desktop a služba Power BI) a vyžadují, aby se místní brána dat aktualizovala prostřednictvím služba Power BI. Vlastní konektory musí být individuálně distribuovány vývojářem.

Vlastníci zdrojů dat, kteří pro svůj zdroj dat vyvíjejí vlastní konektor, můžou chtít distribuovat vlastní konektor uživatelům Power Query 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 vlastního konektoru Power Query zpřístupňuje konektor veřejně a bez použití v rámci sémantických modelů Power BI (Power BI Desktop a služba Power BI), toků dat Power BI a datových diagramů Power BI. Certifikované konektory jsou podporované ve PowerBI.com a ve všech verzích Power BI Premium.

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 budou přesměrovány na vývojáře partnera.

Certifikované konektory a rozdíly mezi vlastními konektory

Certifikované konektory jsou součástí power BI Desktopu a nasazují se do služby Power BI, toků dat Power BI a datových diagramů Power BI. Vlastní konektory jsou podporované jenom v sémantických modelech Power BI a je potřeba je načíst v Power BI Desktopu, jak je popsáno v tématu Načítání rozšíření v Power BI Desktopu. Certifikované i vlastní konektory je možné aktualizovat prostřednictvím Power BI Desktopu nebo služby Power BI prostřednictvím místní brány dat implementací nástroje Test Připojení ion. Pro vlastní konektory se vyžaduje místní brána dat.

Certifikované konektory v Power BI Desktopu TestConnection s implementací také podporují kompletní aktualizaci prostřednictvím cloudu (služby Power BI), aniž by bylo potřeba místní brány dat. Prostředí služba Power BI v podstatě hostuje "cloudovou bránu", která běží podobně jako místní brána. Po certifikaci nasadíme váš konektor do tohoto prostředí, aby byl dostupný všem zákazníkům Power BI.

Vlastní i certifikované konektory s dalšími komponentami (například ovladače ODBC) musí být nainstalované na počítači koncového uživatele a vyžadují místní bránu dat, pokud není další komponenta nasazená do cloudu Power BI. V současné době necertifikujeme a nasazujeme žádné nové další komponenty do cloudu Power BI, takže certifikace konektorů se závislostí na další komponentě neodebere požadavek na místní bránu dat.

Distribuce vlastních konektorů

Vlastní konektory je možné a měly by být distribuovány koncovým uživatelům před certifikací.

Vzhledem k tomu, že M je univerzální jazyk, který má kapacitu pro interakci s uloženými přihlašovacími údaji, jak je vidět při zpracování ověřování, musíme uživatelům poskytnout způsob, jak umožnit spouštění jenom důvěryhodných konektorů.

Z pohledu vývojáře musí vývojáři sami podepsat svůj vlastní konektor a poskytnout uživatelům informace (kryptografický otisk), aby je mohli bezpečně načíst.

Z pohledu uživatele musí uživatelé používat kryptografický otisk od vývojáře, aby mohli bezpečně důvěřovat a načíst vlastní konektor pro použití. Uživatelé se také můžou rozhodnout snížit nastavení zabezpečení, aby umožnili načítání kódu, který není certifikovaný microsoftem nebo jiným vývojářem, ale tato možnost se nedoporučuje.

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. Upozorňujeme, že Microsoft nenabízí technickou pomoc ani konzultace s vývojem vlastních konektorů. Doporučujeme využít 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é můžete chtít zapojit přímo, odděleně od jakéhokoli programu nebo partnerství Microsoftu. Mějte na paměti, že 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 certifikační kontakt Microsoftu.

  • Vývojář musí poskytnout odhad využití. Doporučujeme, aby vývojáři konektorů pro velmi designové produkty používali naše funkce samoobslužného podepisování konektorů k tomu, aby je poskytli přímo zákazníkovi.

  • 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 Private Preview tak, že dokončený konektor distribuujete přímo koncovým uživatelům a organizacím prostřednictvím samoobslužného podepisování. 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 Power BI Ideas musí být vlákno řízené zákazníky, aby bylo možné indikovat poptávku, aby konektor byl veřejně dostupný v Power BI Desktopu. Není nastavená prahová hodnota zapojení. Čím větší zapojení, tím silnější je poptávka po konektoru.

Tyto předpoklady existují, aby konektory procházející certifikací měly významné zákazníky a firmy, které je potřeba použít a podporovat po certifikaci.

Zpracování a časové osy

Certifikované konektory se vydávají s měsíčními verzemi Power BI Desktopu, takže konečné termíny pro každou verzi se vrátí z každého data vydání Power BI Desktopu. Očekávaná doba trvání procesu certifikace od registrace po vydání se liší v závislosti na kvalitě a složitosti odeslání konektoru. Microsoft neposkytuje žádné konkrétní záruky časové osy, pokud jde o kontrolu a schválení konektoru. Pevné termíny pro každou kontrolu konektoru jsou popsané v následujících krocích, ale Microsoft nezaručuje dodržování těchto časových os.

  • Registrace: Oznámení o záměru certifikovat vlastní konektor K této registraci musí dojít do 15. dne měsíce, dva měsíce před cílovou verzí Power BI Desktopu.

    • Například pro dubnovou verzi Power BI Desktopu by konečný termín byl 15. února.

  • Odeslání: odeslání souborů konektorů ke kontrole Microsoftu K tomuto odeslání musí dojít do 1. dne měsíce před cílovou verzí Power BI Desktopu.

    • Například pro dubnovou verzi Power BI Desktopu by konečný termín byl 1. března.

  • Technická kontrola: Dokončení souborů konektoru, předání kontroly a certifikace Microsoftu Tato kontrola musí nastat do 15. dne měsíce před cílovou verzí Power BI Desktopu.

    • Například pro dubnovou verzi Power BI Desktopu by konečný termín byl 15. března.

Vzhledem ke složitosti technických přezkumů a potenciálních zpoždění, změna architektury a problémů s testováním důrazně doporučujeme odeslat včas s dlouhou lhůtou pro počáteční vydání a certifikaci. Pokud máte pocit, že je konektor důležitý k doručování několika zákazníkům s minimální režií, doporučujeme samoobslužné podepisování a poskytování této služby.

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í.

Soubory odeslání (artefakty)

Ujistěte se, že soubory konektoru, které odešlete, obsahují všechny následující:

  • soubor Připojení or (.mez)

    • Soubor .mez by měl odpovídat standardům stylu a měl by být pojmenován podobně jako název produktu nebo služby. Neměla by obsahovat slova jako "Power BI", "Připojení or" nebo "API".
    • Pojmenujte soubor .mez: ProductName.mez

  • Soubor Power BI Desktopu (.pbix) pro testování

    • K otestování konektoru vyžadujeme ukázkovou sestavu Power BI (.pbix).
    • Sestava by měla obsahovat alespoň jeden dotaz, který otestuje každou položku v navigační tabulce.
    • Pokud neexistuje žádné schéma sady (například databáze), musí sestava obsahovat dotaz pro každý "typ" tabulky, kterou konektor může zpracovat.

  • Otestování účtu pro váš zdroj dat

    • K otestování a řešení potíží s vaším konektorem používáme testovací účet.
    • Zadejte testovací účet, který je trvalý, abychom mohli použít stejný účet k certifikaci všech budoucích aktualizací.

  • Pokyny k testování

    • Uveďte veškerou dokumentaci k používání konektoru a otestování jeho funkčnosti.

  • Odkazy na externí závislosti (například ovladače ODBC)

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.
    • Mít obslužnou rutinu testu Připojení ion.
    • Postupujte podle konvencí vytváření názvů (například DataSourceKind.FunctionName). Neměla by obsahovat slova jako "Power BI", "Připojení or" nebo "API".
    • 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í Extension.CurrentCredentials() atd.).
    • Uživatel Expression by neměl být zadaný ani by neměl zadávat vstup uživatele.
    • Hodnota Expression by neměla být dynamická (to znamená načtená z webového volání).

Registrace k certifikaci

Pokud máte zájem o certifikaci vlastního konektoru, ujistěte se, že váš scénář a konektor splňují požadavky a požadavky uvedené v tomto článku. Pokud to neuděláte, dojde ke zpoždění certifikace, protože náš tým bude vyžadovat, abyste před přechodem k certifikaci opravili případné problémy nebo nekonzistence.

Ujistěte se, že je váš konektor dokončený a byl otestován při vytváření v Power BI Desktopu i při aktualizaci a spotřebě ve službě Power BI. Ujistěte se, že jste ve službě Power BI otestovali úplnou kompletní aktualizaci prostřednictvím místní brány dat.

Začněte tím, že dokončíte registrační formulář a kontakt Microsoftu kontakt zahájí proces.

Po certifikaci

Jakmile je konektor certifikovaný a vydaný prostřednictvím Power BI Desktopu a služba Power BI, měli byste 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é by měli používat certifikovanou verzi konektoru, která je součástí Power BI Desktopu, a místní bránu 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.

Po vytvoření konektoru ke zdroji dat zvažte, jak zákazníkům pomoct rychle začít pracovat vytvořením aplikace šablony. Aplikace šablony poskytuje zákazníkům předem připravenou sestavu připojenou ke svým datům, kterou můžou podle potřeby používat nebo přizpůsobit.

Poznámka:

Aplikace šablon nepodporují konektory, které vyžadují bránu.