Zdieľať cez


TripPin časť 9 - Test Pripojenie ion

Tento kurz s viacerými časťami sa zaoberá vytváraním nového rozšírenia zdroja údajov pre Power Query. Tento kurz sa má uskutočniť postupne – každá lekcia vychádza z konektora vytvoreného v predchádzajúcich lekciách a postupne pridáva nové možnosti do konektora.

V tejto lekcii:

  • Pridanie obslužného programu test Pripojenie ion
  • Konfigurácia lokálnej brány údajov (osobný režim)
  • Testovanie plánovaného obnovenia prostredníctvom služba Power BI

Podpora vlastných konektorov bola pridaná do vydania osobnej lokálnej brány údajov z apríla 2018. Táto nová funkcia (preview) umožňuje plánované obnovenie zostáv, ktoré využívajú váš vlastný konektor.

Tento kurz sa zaoberá procesom povolenia konektora na obnovenie a poskytuje rýchly návod na postup konfigurácie brány. Konkrétne:

  1. Pridajte obslužný program Pripojenie ukážky do konektora.
  2. Nainštalujte lokálnu bránu údajov v osobnom režime.
  3. Povoľte vlastnú Pripojenie alebo podporu v bráne.
  4. Publikujte zošit, ktorý používa váš konektor na PowerBI.com.
  5. Nakonfigurujte plánované obnovenie na otestovanie konektora.

Ďalšie informácie o obslužnom programe test Pripojenie ion nájdete v časti Spracovanie podpory brány.

Pozadie

Na konfiguráciu zdroja údajov na plánované obnovenie pomocou PowerBI.com existujú tri predpoklady:

  • Zdroj údajov je podporovaný: Znamená to, že prostredie cieľovej brány si je vedomé všetkých funkcií obsiahnutých v dotaze, ktorý chcete obnoviť.
  • Poskytujú sa poverenia: Ak chcete prezentovať správne dialógové okno zadávania poverení, Power BI potrebuje poznať mechanizmus overenia podpory pre daný zdroj údajov.
  • Poverenia sú platné: Keď používateľ poskytne poverenia, overí sa zavolaním obslužného programu zdroja TestConnection údajov.

Prvé dve položky sa spracovávajú registráciou konektora v bráne. Keď sa používateľ pokúsi nakonfigurovať plánované obnovenie v PowerBI.com, informácie o dotaze sa odošlú do vašej osobnej brány a určia, či tam sú zdroje údajov, ktoré služba Power BI rozpoznané (teda vlastné, ktoré ste vytvorili). Tretia položka sa spracováva vyvolaním obslužného Pripojenie programu testovania definovaného pre váš zdroj údajov.

Pridanie obslužného programu test Pripojenie ion

Obslužný program Pripojenie údajov sa pridá do záznamu deklarácie Druh údajov (to isté miesto, kde deklarujete podporované typy overovania). Obslužný program je function s jedným parametrom typu any, ktorý vráti list. Prvou hodnotou v zozname je funkcia, ktorá sa zavolá na testovanie pripojenia. Je to vo všeobecnosti rovnaké ako funkcia hlavného zdroja údajov. V niektorých prípadoch možno budete musieť sprístupniť samostatnú shared funkciu, aby ste mohli poskytnúť efektívny test pripojenia. Toto by sa však malo vo všeobecnosti vyhnúť.

Keďže funkcia zdroja údajov TripPin nemá žiadne povinné argumenty, implementácia pre Pripojenie Test je pomerne jednoduchá:

// Data Source Kind description
TripPin = [
    // TestConnection is required to enable the connector through the Gateway
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin Part 9 - TestConnection"
];

Poznámka

Implementáciu test Pripojenie ion môžete overiť v rámci súpravy SDK Power Query pomocou príkazu spustiť test Pripojenie ion.

Povolenie vlastných konektorov v osobnej bráne

Stiahnite a nainštalujte lokálnu bránu údajov. Keď spustíte inštalátor, vyberte osobný režim.

Po dokončení inštalácie spustite bránu a prihláste sa do služby Power BI. Proces prihlásenia automaticky zaregistruje bránu v služba Power BI. Po prihlásení vykonajte nasledujúce kroky:

  1. Vyberte kartu Pripojenie or.
  2. Výberom prepínača povolíte podporu vlastných konektorov údajov.
  3. Vyberte adresár, z ktorému chcete načítať vlastné konektory. Zvyčajne ide o rovnaký adresár, aký by ste použili v aplikácii Power BI Desktop, ale hodnota je konfigurovateľná.
  4. Stránka by teraz mala zobrazovať zoznam všetkých súborov prípon v cieľovom adresári.

Konfigurácia konektora brány.

Ďalšie informácie o bráne nájdete v online dokumentácii .

Testovanie plánovaného obnovenia

Otvorte aplikáciu Power BI Desktop a vytvorte zostavu, ktorá importuje údaje pomocou konektora TripPin.

TripPin Navigator.

Pridajte jeden alebo viac vizuálov na stranu zostavy (voliteľné) a potom zostavu publikujte do PowerBI.com.

Po publikovaní prejdite na PowerBI.com a vyhľadajte sémantický model pre zostavu, ktorú ste publikovali. Vyberte tri bodky a potom vyberte položku Naplánovať obnovenie. Rozbaľte časti Pripojenie k bráne a Poverenia zdroja údajov.

Nastavenia zdroja údajov.

Poznámka

Ak stránka konfigurácie sémantického modelu uvádza, že zostava obsahuje neznáme zdroje údajov, brána alebo vlastný konektor nemusí byť nakonfigurovaný správne. Prejdite do používateľského rozhrania konfigurácie osobnej brány a skontrolujte, či sa vedľa konektora TripPin nenachádzajú žiadne chyby. Možno budete musieť reštartovať bránu (na karte Služby Nastavenia), aby ste mohli pokračovať v najnovšej konfigurácii.

Vyberte prepojenie Upraviť poverenia, čím zobrazíte dialógové okno overenia, a potom vyberte položku Prihlásenie.

Poznámka

Ak sa zobrazí chybové hlásenie podobné tej nasledujúcej ("Nepodarilo sa aktualizovať poverenia zdroja údajov"), pravdepodobne sa vyskytol problém s obslužným programom test Pripojenie ion.

Chyba Pripojenie otestovania.

Po úspešnom volaní funkcie Test Pripojenie ion sa poverenia prijmú. Teraz môžete naplánovať obnovenie alebo vybrať tri bodky v sémantickom modeli a potom vybrať položku Obnoviť. Môžete vybrať prepojenie História obnovení a zobraziť tak stav obnovenia (čo vo všeobecnosti trvá niekoľko minút, kým sa spustí).

Úspešná konfigurácia.

Záver

Blahoželáme! Teraz máte k dispozícii vlastný konektor pripravený na produkciu, ktorý podporuje automatizované obnovenie prostredníctvom služba Power BI.

Ďalšie kroky

TripPin Part 10 – Postupné posúvanie dotazov