Share via

Prehľad súpravy Power Query SDK

  • Článok

Súprava Power Query SDK je množina nástrojov navrhnutých na pomoc pri vytváraní konektorov Power Query. Tieto konektory sa často označujú ako vlastné konektory alebo rozšírenia Power Query.

Vlastné konektory umožňujú vytvárať nové zdroje údajov alebo prispôsobovať a rozširovať existujúci zdroj. K bežným prípadom použitia patria:

  • Vytvorenie prehľadu vhodného pre podnikových analytikov pre rozhranie REST API.
  • Poskytovanie značky pre zdroj, ktorý Power Query podporuje s existujúcim konektorom (ako je napríklad služba OData alebo ovládač ODBC).
  • Implementácia postupu overovania OAuth v2 pre ponuku saaS.
  • Vystavenie obmedzeného alebo filtrovaného zobrazenia nad zdrojom údajov s cieľom zlepšiť použiteľnosť.
  • Povolenie režimu DirectQuery pre zdroj údajov pomocou ovládača ODBC.

Inštalácia súpravy SDK doplnku Power Query

V súčasnosti existujú dve verzie súpravy SDK Power Query:

  • Visual Studio Power Query SDK: Vydané v roku 2017 ako rozšírenie pre Visual Studio 2017 a 2019.
  • Visual Studio Code Power Query SDK (Preview): Vydané v roku 2022 ako nový a odporúčaný spôsob vytvorenia konektorov Power Query.

Odporúčame všetkým vývojárom nainštalovať a používať novovydané súpravy SDK (Preview) Visual Studio Code, pretože táto verzia bude postupne predvolenou súpravou SDK v budúcnosti.

Visual Studio Power Query SDK

Ak chcete nainštalovať súpravu Power Query SDK vo Visual Studiu, postupujte podľa krokov uvedených nižšie:

  1. Nainštalujte súpravu SDK doplnku Power Query zo služby Visual Studio Marketplace.
  2. Vytvorte nový projekt konektora údajov.
  3. Definujte logiku konektora.
  4. Vytvorte projekt a vytvorte súbor s príponou.

Funkcia verzie Preview.

Visual Studio Code Power Query SDK (Preview)

Poznámka

Nová súprava SDK pre Visual Studio Code je momentálne vo verzii Public Preview od septembra 2022.

Nainštalujte novú súpravu SDK programu Visual Studio Code služby Power Query zo sekcie Visual Studio Code v službe Visual Studio Marketplace. Ak chcete nainštalovať súpravu SDK, vyberte položku Inštalovať .

Pripojenie aktor procesu vývoja

Hoci môžete použiť buď Visual Studio Code, alebo Súpravu SDK Visual Studio Power Query, obe používajú podobný proces na vývoj konektora na vysokej úrovni.

Nasledujúce časti popisujú na vysokej úrovni najbežnejší proces vytvorenia konektora Power Query pomocou súpravy SDK.

Vytvorenie nového rozšírenia

Pri vytváraní nového projektu (Visual Studio Power Query SDK) alebo nového pracovného priestoru (Visual Studio Code Power Query SDK) začnete s nasledujúcimi základnými súbormi:

  • Pripojenie alebo súbor definície (<connectorName.pq>)
  • Súbor dotazu (<connectorName.query.pq>)
  • Súbor prostriedkov reťazca (resources.resx)
  • Súbory PNG rôznych veľkostí, ktoré sa používajú na vytvorenie ikon

Súbor definície konektora sa začne prázdnym popisom zdroja údajov. Ďalšie informácie o zdroji údajov v kontexte súpravy Power Query SDK nájdete v článku o spracovaní prístupu k údajom.

Testuje sa

Súprava Power Query SDK poskytuje základné možnosti spúšťania dotazov, ktoré vám umožnia otestovať vaše rozšírenie bez toho, aby ste museli prepínať do aplikácie Power BI Desktop.

Testovací súbor dotazu

Okrem súboru s príponou môžu mať projekty data Pripojenie or súbor dotazu (name.query.pq). Tento súbor možno použiť na spustenie testovacích dotazov v rámci Visual Studia. Vyhodnocovanie dotazu bude automaticky zahŕňať váš kód rozšírenia bez toho, aby ste museli zaregistrovať súbor .pqx, čo vám umožní volať alebo testovať zdieľané funkcie v kóde rozšírenia.

Súbor dotazu môže obsahovať jeden výraz (napríklad ), let výraz (napríklad to, HelloWorld.Contents()čo by vygeneruje Power Query) alebo dokument so sekciami.

Vytváranie a nasadzovanie

Vytvorením projektu sa vytvorí váš súbor .mez alebo súbor s príponou.

Prípony Power Query sa spájajú v súbore ZIP a majú príponu súboru .mez. V čase spustenia načíta aplikácia Power BI Desktop rozšírenia z lokality [Dokumenty]\Microsoft Power BI Desktop\Custom Pripojenie ors.

Poznámka

Projekty Pripojenie údajov nepodporujú vlastné kroky na vytváranie a kopírovanie súboru rozšírenia do adresára [Documents]\Microsoft Power BI Desktop\Custom Pripojenie ors. Ak niečo také chcete urobiť, možno budete chcieť použiť rozšírenie tretej strany.

Rozšírenia sú definované v dokumente sekcie jazyka M. Dokument sekcie má trochu iný formát ako dokument dotazu vygenerovaný v doplnku Power Query. Kód, ktorý importujete z Power Query, zvyčajne vyžaduje úpravu, aby sa zmestil do dokumentu sekcie, ale zmeny sú menšie. Medzi rozdiely medzi dokumentmi v sekciách, o ktorých by ste mali vedieť, patria:

  • Začínajú deklaráciou sekcie (napríklad section HelloWorld;).
  • Každý výraz končí bodkočiarkou (napríklad a = 1; alebo b = let c = 1 + 2 in c;).
  • Všetky funkcie a premenné sú v dokumente sekcií lokálne, pokiaľ nie sú označené ako zdieľané. Zdieľané funkcie sa zobrazia pre iné dotazy alebo funkcie a predstavte si ich ako export pre vaše rozšírenie (to znamená, že sa stanú volajúcimi zo služby Power Query).

Ďalšie informácie o dokumentoch sekcie jazyka M nájdete v špecifikácii jazyka M.

Distribúcia konektorov údajov

Konektory doplnku Power Query možno použiť v aplikácii Power BI Desktop alebo v prostredí Power Query Online, ako sú napríklad toky údajov služby Power BI, dátovémarty služby Power BI a ďalšie možnosti.

Power BI Desktop

Používatelia aplikácie Power BI Desktop môžu použiť vlastný konektor Power Query podľa krokov uvedených nižšie:

  1. Skopírujte súbor prípony (.mez alebo.pqx) do [Dokumenty]/Power BI Desktop/Vlastné Pripojenie ktory.
  2. V aplikácii Power BI Desktop vyberte možnosť (Neodporúča sa) Povoliť načítanie ľubovoľného rozšírenia bez overenia alebo upozornenia v časti Možnosti súboru>a nastavenia>Možnosti>Údajové rozšírenia zabezpečenia.>
  3. Reštartujte aplikáciu Power BI Desktop.

Power BI Desktop automaticky načíta rozšírenia pri reštarte.

Prípadne môžete ako vlastník zdroja údajov a konektora odoslať svoj konektor do programu Pripojenie Power Query alebo certifikácie, aby sa pri každom vydaní dodával s aplikáciou Power BI Desktop.

Power Query Online

Poznámka

Tím Power Query sa usiluje o povolenie všetkých certifikovaných konektorov Power Query v online prostredí Power Query.

V prostredí Power Query Online sa zobrazujú iba certifikované konektory Power Query. Ďalšie informácie o programe certifikácie konektora Power Query nájdete v téme Pripojenie Power Query alebo Certifikácia.