Share via

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 Připojení or

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 Připojení oru (<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čne popisem prázdného 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 Power BI Desktop.

Testovací soubor dotazu

Kromě příponového souboru můžou mít projekty Data Připojení or 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. Power BI Desktop za běhu načte rozšíření z [Documents]\Microsoft Power BI Desktop\Custom Připojení ors.

Poznámka:

Projekty Připojení or dat nepodporují vlastní kroky po sestavení pro zkopírování souboru přípony do adresáře [Documents]\Microsoft Power BI Desktop\Custom Připojení or. Pokud chcete něco udělat, můžete použít rozšíření třetí strany.

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 datových konektorů

Konektory Power Query je možné použít v Power BI Desktopu nebo v prostředí Power Query Online, jako jsou toky dat Power BI, datové diagramy Power BI a další prostředí.

Power BI Desktop

Uživatelé Power BI Desktopu můžou pomocí následujícího postupu využívat vlastní konektor Power Query:

  1. Zkopírujte soubor s příponou (.mez or.pqx) do složky [Documents]/Power BI Desktop/Custom Připojení ors.
  2. V Power BI Desktopu vyberte možnost Povolit načtení libovolného rozšíření bez ověření nebo upozornění v části Možnosti souborů>a nastavení>Možnosti>zabezpečení>dat.
  3. Restartujte Power BI Desktop.

Power BI Desktop automaticky načte rozšíření při restartování.

Případně jako vlastník zdroje dat a konektoru můžete konektor odeslat do Připojení orového certifikačního programu Power Query, aby se v každé verzi dodává s Power BI Desktopem.

Power Query Online

V prostředí Power Query Online se zobrazují jenom certifikované konektory Power Query. Další informace o certifikačním programu konektoru Power Query najdete v Připojení o certifikaci Power Query.