Zdieľať cez

Vývoj konektora pomocou súpravy SDK doplnku Power Query

  • Č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

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

Proces vývoja konektora

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 pracovného priestoru (Visual Studio Code Power Query SDK) začínate s nasledujúcimi základnými súbormi:

  • Súbor definície konektora (<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 začína 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 vykonávania dotazov, ktoré vám umožnia otestovať vaše rozšírenie bez toho, aby ste museli prepínať na inú klientsku aplikáciu. Konektor môžete ďalej otestovať v aplikácii, ako napríklad:

Testovací súbor dotazu

Okrem súboru s príponou môžu mať projekty konektora Data Connector aj súbor dotazu (name.query.pq). Tento súbor možno použiť na spustenie testovacích dotazov v programe Visual Studio Code. 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.

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 Power Query

Konektor môžete distribuovať dvoma cestami:

  • Samoobslužná distribúcia
  • Certifikácia konektora

Samoobslužná distribúcia

Samoobslužný mechanizmus, kde môžete použiť vlastné konektory Power Query v príslušných prostrediach produktov.

Po vytvorení konektora môžete tento súbor odoslať svojim používateľom, ktorí ho môžu použiť v príslušných produktoch, ako je napríklad Microsoft Power BI.

Microsoft Power BI

Na obnovenie a pripojenie v cloude môžete použiť vlastný konektor v aplikácii Microsoft Power BI Desktop a službe Microsoft Power BI pre sémantické modely.

Konektory Power Query možno načítať do troch prostredí:

  • Lokálna brána údajov: Konektor možno načítať cez bránu, ktorá sa má použiť v službách Microsoft Fabric a Microsoft služba Power BI
  • Power Query Online: v rámci skúseností, ako sú napríklad Power BI Datamarts, Fabric Dataflow Gen2 a mnoho ďalších
  • Power Query Desktop: v rámci prostredia, ako je napríklad Power BI Desktop.

Ďalšie informácie o používaní vlastného konektora na samoobslužnú distribúciu nájdete v článkoch nižšie:

Certifikácia konektora

Program certifikácie konektora Data Factory umožňuje odoslať konektor do spoločnosti Microsoft na certifikáciu, v rámci ktorej sa Microsoft stará o publikovanie a distribúciu konektora v rámci služby Microsoft Fabric aj služby Microsoft Power BI pre príslušné produkty a možnosti:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Tok údajov služby Microsoft Fabric Gen2, Microsoft Fabric Warehouse, Microsoft Power BI Datamarts, Microsoft Power BI Dataflow Gen1 a ďalšie
  • Lokálna brána údajov: Pre službu Microsoft Fabric aj pre službu Microsoft Power BI, ktoré používajú bránu na overené obnovenie alebo pripojenie.

Ďalšie informácie o programe certifikácie konektora Data Factory Connector.