Přehled sady Power Query SDK

Účelem tohoto článku je poskytnout přehled o celkových možnostech a vývojovém prostředí, které najdete v sadě Power Query SDK pro Visual Studio Code.

Vytvoření nového projektu

Tip

Před vytvořením projektu rozšíření doporučujeme vytvořit novou složku, do které budete projekt rozšíření ukládat. Pokud není při vytváření nového projektu vybraná žádná složka, pomůže vám sada Power Query SDK před vytvořením projektu rozšíření najít nebo vytvořit novou složku.

Jakmile v editoru Visual Studio Code v hlavním podokně Průzkumníka editoru Visual Studio Code existuje oddíl s názvem Power Query SDK. Tato část obsahuje jenom jedno tlačítko, které čte projekt rozšíření. Vyberte ho.

Toto tlačítko otevře vstupní pole v horní části rozhraní editoru Visual Studio Code. Zadejte název nového projektu rozšíření a pak vyberte Enter.

Po několika sekundách se v okně editoru Visual Studio Code otevře hlavní soubor *.pq pro váš projekt rozšíření, který obsahuje logiku konektoru. Sada Power Query SDK automaticky spouští některé nezbytné úlohy pro dokončení nastavení pracovního prostoru. Tyto úlohy můžete zkontrolovat ve výstupní konzole v editoru Visual Studio Code.

Sada Power Query SDK automaticky vytvoří následující sadu souborů:

• Soubor settings.json , který určuje konkrétní nastavení pro práci s pracovním prostorem.
• Vytvoří příponu jako soubor .mez a uloží ho do nové složky bin\AnyCPU\Debug.
• Sada ikon konektorů jako .png souborů
• Soubor resources.resx , který slouží jako hlavní úložiště pro řetězce, které se používají v rozšíření.
• Soubor .pq, který obsahuje hlavní logiku vašeho rozšíření nebo konektoru.
• Soubor .query.pq, jehož hlavním účelem je použití jako způsob vytvoření testovacích dotazů, které můžete později vyhodnotit.
• Soubor .proj, který obsahuje informace o projektu přípony.

Jakmile Visual Studio Code rozpozná projekt rozšíření, oddíl sady Power Query SDK změní jeho vzhled a zobrazí seznam úkolů, které můžete spustit v novém projektu rozšíření.

Reference

Důležité

Než budete moct vyhodnotit dotazy datového konektoru, musíte nejprve vytvořit sadu přihlašovacích údajů pro projekt rozšíření.

Sada Power Query SDK nabízí prostřednictvím svého uživatelského rozhraní několik úkolů, které vám umožní nastavit, vypsat a odstranit přihlašovací údaje z projektu rozšíření.

Nastavení přihlašovacích údajů

Sada Power Query SDK je primárně řízena úlohami, které je možné aktivovat prostřednictvím více vstupních bodů. Nastavení přihlašovacích údajů je možné provést dvěma způsoby (ostatní úlohy přihlašovacích údajů je možné provádět stejným způsobem).

• Prostřednictvím položky v části Power Query SDK v podokně průzkumníka.

  

• V terminálu vyberte možnost Spustit úlohu a pak vyberte úlohu Nastavit přihlašovací údaje.

  

Při spuštění této úlohy vás Visual Studio Code provede řadou výzev, které vám umožní nastavit přihlašovací údaje. Tyto řady výzev jsou předvídatelné a vždy se skládají ze stejných fází:

1. Zvolte druh zdroje dat.
2. Zvolte soubor konektoru.
3. Zvolte metodu ověřování.

U existujícího projektu rozšíření je dostupná metoda ověřování anonymní. Po nastavení ověřování se v pravém dolním rohu okna zobrazí zpráva s potvrzením úspěšného vygenerování přihlašovacích údajů.

Výpis přihlašovacích údajů

Podobně jako při nastavení přihlašovacích údajů má úloha výpisu přihlašovacích údajů dva vstupní body na stejných místech: část Power Query SDK v podokně Průzkumník a v nabídce Terminál .

Při spuštění této úlohy předvádí dostupné přihlašovací údaje v výstupním terminálu.

Vymazat všechny přihlašovací údaje

Podobně jako u předchozích dvou úloh má úloha, která vymaže všechny přihlašovací údaje, dva vstupní body na stejných místech: část Sada Power Query SDK v podokně Průzkumník a v nabídce Terminál .

Tato úloha slouží jako způsob, jak vymazat všechny přihlašovací údaje z aktuální relace, když potřebujete nastavit nové přihlašovací údaje pro vyhodnocení dotazů.

Informační zprávy pro tuto úlohu se také zobrazují ve výstupní konzole.

Vyhodnocení dotazu a panelu výsledků

Než budete moct vyhodnotit všechny testovací dotazy, je potřeba nastavit přihlašovací údaje. Pomocí konektoru vytvořeného v předchozí části můžete otevřít *.query.pq soubor, který slouží jako testovací soubor dotazu.

Pro tento konkrétní konektor, kde byl název projektu MyConnector, kód vypadá takto:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents()
in
    result

Před vyhodnocením dotazu změníme kód následujícím způsobem:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents("Hello World")
in
    result

Po změně kódu nezapomeňte soubor uložit.

Pokud chcete tento dotaz vyhodnotit, máte tři možnosti:

• Pravým tlačítkem vyberte soubor, který se používá, a vyberte možnost Vyhodnotit aktuální soubor power query.

• Projděte nabídku Terminál a vyberte úlohu Vyhodnotit aktuální soubor .

• Použijte nativní možnost Spustit a Ladit z editoru Visual Studio Code, vyberte hypertextový odkaz a vytvořte soubor launch.json a pak soubor vyhodnoťte.

Po vyhodnocení dotazu se výsledky zobrazí v konzole v dolní části okna a na novém panelu s názvem panel výsledků vpravo.

Panel výsledků obsahuje tři karty:

• Karta Výstup: Zobrazí náhled dat vyhodnoceného dotazu. Pokud jsou data tabulkou, zobrazí se jako mřížka.

  

• Shrnutí: Zobrazí souhrn aktivity, která spustila vyhodnocení, spolu se statistikami přidruženými k dané aktivitě.

  

• Zdroj dat: Zobrazí obecné informace o zdroji dat použitém pro vyhodnocení.

  

Pokud chcete vyhodnotit jiný dotaz, stačí upravit soubor *.query.pq, uložit ho a potom znovu spustit úlohu vyhodnocení pomocí některé ze tří metod.

Poznámka:

Sada Power Query SDK nespravuje žádný druh mechanismu ukládání do mezipaměti pro vyhodnocení.

Přenesení starší verze projektu rozšíření do nové sady SDK

Tato část pomáhá vývojářům konektorů, kteří mají projekty rozšíření vytvořené pomocí starší sady Visual Studio Power Query SDK.

Pokud chcete postupovat podle pokynů, doporučujeme stáhnout projekty konektoru dostupné z našeho úložiště DataConnectors pro ukázku TripPin, konkrétně ukázku 9-TestConnection.

Pokud chcete přenést starší projekt rozšíření do nové sady SDK, postupujte takto:

1. V editoru Visual Studio Code vyberte Složku Otevřít soubor> a přejděte do složky, ve které se nachází projekt rozšíření.

2. Pomocí jedné z následujících dvou metod nastavte pracovní prostor pomocí existující složky a jejího obsahu:

   • Sada Power Query SDK má mechanismus pro rozpoznávání obsahu vaší složky a navrhuje, abyste povolili převod do nového pracovního prostoru sady Power Query SDK.

     

   • Spusťte pracovní prostor Nastavení a úlohu sestavení z nabídky terminálu. Tyto soubory efektivně vytvoří soubor .mez a settings.json soubory potřebné pro pracovní prostor.

Přidání dvou nových složek a souborů je to, co transformuje aktuální pracovní prostor na nový pracovní prostor sady Power Query SDK.

Nastavení pracovního prostoru

Co dělá úloha Nastavit pracovní prostor, je efektivně vytvořit soubor settings.json pro váš pracovní prostor, který určuje některé proměnné, které se použijí pro váš pracovní prostor, pokud jde o vyhodnocení a obecná nastavení.

Vytvoření souboru s příponou

Úloha sestavení umožňuje vytvořit soubor .mez pro vaši příponu na vyžádání.

Spuštění funkce TestConnection

TestConnection je funkce, která umožňuje aktualizaci vašeho konektoru v Microsoft Cloudu prostřednictvím služeb, jako je Power BI. Jedná se o záznam implementovaný uvnitř záznamu zdroje dat konektoru. Další informace o implementaci obslužné rutiny TestConnection najdete v ukázce dostupné pro testovací připojení.

Úloha, která spustí TestConnection, umožňuje otestovat obslužnou rutinu uvnitř sady Power Query SDK, aniž byste museli tuto obslužnou rutinu vyzkoušet ručně v Microsoft Cloudu.

Pokud chcete tuto úlohu spustit, nejprve nastavte přihlašovací údaje pro váš konektor a pak spusťte úlohu buď z oddílu sady Power Query SDK v Průzkumníku, nebo v seznamu úkolů v nabídce terminálu.

Výsledek tohoto úkolu se zobrazí ve výstupním terminálu v dolní části okna.

Zpětná vazba a chyby

Pokud potřebujete pomoc s vývojem vlastního konektoru nebo zpětnou vazbu, návrhy nebo chyby, které chcete nahlásit, navštivte naše oficiální veřejné úložiště na GitHubu.

Pomocí fóra Komunita Power BI můžete také publikovat obecné otázky týkající se Power Query, jazyka M a vývoje vlastních konektorů.