Sdílet prostřednictvím

Vývoj konektoru pomocí sady Power Query SDK

  • Článek

Sada Power Query SDK je sada nástrojů, které vám pomůžou vytvářet konektory Power Query. Tyto konektory se často označují jako vlastní konektory nebo rozšíření Power Query.

Vlastní konektory umožňují vytvářet nové zdroje dat nebo přizpůsobovat a rozšiřovat stávající zdroj. Mezi běžné případy použití patří:

  • Vytvoření zobrazení vhodné pro obchodní analytiky pro rozhraní REST API
  • Poskytnutí brandingu pro zdroj, který Power Query podporuje s existujícím konektorem (například službou OData nebo ovladačem ODBC).
  • Implementace toku ověřování OAuth v2 pro nabídku SaaS
  • Zveřejnění omezeného nebo filtrovaného zobrazení ve zdroji dat za účelem zlepšení použitelnosti
  • Povolení DirectQuery pro zdroj dat pomocí ovladače ODBC

Instalace sady Power Query SDK

Nainstalujte sadu Visual Studio Code Power Query SDK z části Visual Studio Code na webu Visual Studio Marketplace. Vyberte Nainstalovat a nainstalujte sadu SDK.

Proces vývoje konektorů

Následující části popisují nejběžnější proces vytvoření konektoru Power Query pomocí sady SDK na vysoké úrovni.

Vytvoření nového rozšíření

Při vytváření nového pracovního prostoru (Visual Studio Code Power Query SDK) začnete s následujícími základními soubory:

  • Definiční soubor konektoru (<connectorName.pq>)
  • Soubor dotazu (<connectorName.query.pq>)
  • Soubor prostředků řetězce (resources.resx)
  • Soubory PNG s různými velikostmi používanými k vytváření ikon

Definiční soubor konektoru začíná prázdným popisem zdroje dat. Další informace o zdroji dat najdete v kontextu sady Power Query SDK v článku o zpracování přístupu k datům.

Testování

Sada Power Query SDK poskytuje základní možnosti spouštění dotazů, které umožňují otestovat rozšíření, aniž byste museli přecházet na jinou klientskou aplikaci. Konektor můžete dále otestovat v aplikaci, například:

Testovací soubor dotazu

Kromě souboru s příponou můžou mít projekty datového konektoru soubor dotazu (name.query.pq). Tento soubor lze použít ke spouštění testovacích dotazů v editoru Visual Studio Code. Vyhodnocení dotazu bude automaticky obsahovat váš kód rozšíření, aniž byste museli zaregistrovat soubor .pqx, což vám umožní volat nebo testovat všechny sdílené funkce v kódu rozšíření.

Soubor dotazu může obsahovat jeden výraz (například HelloWorld.Contents()), let výraz (například to, co by Power Query vygeneroval) nebo dokument oddílu.

Sestavení a nasazení

Sestavení projektu vytvoří váš soubor .mez nebo příponu souboru. Rozšíření Power Query jsou součástí souboru ZIP a mají příponu souboru .mez.

Rozšíření jsou definována v dokumentu oddílu M. Dokument oddílu má trochu jiný formát než dokumenty dotazů vygenerované v Power Query. Kód, který importujete z Power Query, obvykle vyžaduje úpravy, aby se vešly do dokumentu oddílu, ale změny jsou menší. Rozdíly v dokumentu oddílu, o které byste měli vědět, patří:

  • Začínají deklarací oddílu (například section HelloWorld;).
  • Každý výraz končí středníkem (například a = 1; nebo b = let c = 1 + 2 in c;).
  • Všechny funkce a proměnné jsou v dokumentu oddílu místní, pokud nejsou označené jako sdílené. Sdílené funkce se stanou viditelnými jinými dotazy nebo funkcemi a dají se považovat za exporty pro vaše rozšíření (to znamená, že se dají volat z Power Query).

Další informace o dokumentech oddílu M najdete ve specifikaci jazyka M.

Distribuce konektorů Power Query

Máte dvě cesty, ve kterých můžete konektor distribuovat:

  • Vlastní distribuce
  • Certifikace konektoru

Vlastní distribuce

Samoobslužný mechanismus, kde můžete použít vlastní konektory Power Query v příslušných produktových prostředích

S vytvořeným konektorem můžete tento soubor odeslat, jak chcete uživatelům, a můžou ho používat v příslušných produktových prostředích, jako je Microsoft Power BI.

Microsoft Power BI

K aktualizaci a připojení v cloudu můžete použít vlastní konektor v Microsoft Power BI Desktopu a službě Microsoft Power BI pro sémantické modely.

Konektory Power Query je možné načíst do tří prostředí:

  • Místní brána dat: Konektor se dá načíst přes bránu, která se použije v Microsoft Fabric a Microsoft služba Power BI s.
  • Power Query Online: v rámci prostředí, jako jsou power BI Datamarts, Fabric Dataflow Gen2 a mnoho dalších
  • Power Query Desktop: v rámci prostředí, jako je Power BI Desktop.

Další informace o používání vlastního konektoru pro samoobslužnou distribuci najdete v následujících článcích:

Certifikace konektoru

Certifikační program konektoru Data Factory umožňuje odeslat konektor microsoftu k certifikaci, kde se Microsoft stará o publikování a distribuci konektoru v rámci Microsoft Fabric i Microsoft Power BI pro příslušné produkty a prostředí:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric Dataflow Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 a další
  • Místní brána dat: Pro Microsoft Fabric i Microsoft Power BI, které používají bránu k ověření aktualizace nebo připojení.

Přečtěte si další informace o programu Certifikace konektoru služby Data Factory.