Přehled 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

Aktuálně jsou k dispozici dvě verze sady Power Query SDK:

  • Visual Studio Power Query SDK: Vydáno v roce 2017 jako rozšíření pro Visual Studio 2017 a 2019.
  • Visual Studio Code Power Query SDK (Preview): Vydáno v roce 2022 jako nový a doporučený způsob vytváření konektorů Power Query.

Doporučujeme všem vývojářům nainstalovat a používat nově vydané sady Visual Studio Code Power Query SDK (Preview), protože tato verze bude nakonec výchozí sadou SDK.

Visual Studio Power Query SDK

Pokud chcete nainstalovat sadu Visual Studio Power Query SDK, postupujte následovně:

  1. Nainstalujte sadu Power Query SDK z webu Visual Studio Marketplace.
  2. Vytvořte nový projekt datového konektoru.
  3. Definujte logiku konektoru.
  4. Sestavte projekt tak, aby vytvořil soubor s příponou.

Funkce Preview

Visual Studio Code Power Query SDK (Preview)

Poznámka:

Nová sada Visual Studio Code Power Query SDK je aktuálně ve verzi Public Preview od září 2022.

Nainstalujte novou 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

I když můžete použít Visual Studio Code nebo sadu Visual Studio Power Query SDK, oba používají podobný proces pro vývoj konektoru na vysoké úrovni.

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 projektu (Visual Studio Power Query SDK) nebo 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 sadě Visual Studio. 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

Poznámka:

Tým Power Query tvrdě pracuje na povolení všech certifikovaných konektorů Power Query v prostředí 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.