Použitie verejných parametrov v Dataflow Gen2

Prepitné

Pre viac informácií o tom, ako využiť túto schopnosť v scenároch kontinuálnej integrácie / kontinuálneho nasadenia (CI/CD), prečítajte si článok o architektúrach riešení CI/CD a ALM pre Dataflow Gen2 a komplexný tutoriál o parametrizovanom Dataflow Gen2.

Parametre v toku údajov Gen2 umožňujú dynamicky ovládať a prispôsobovať toky údajov, vďaka čomu sú flexibilnejšie a opätovne použiteľné tým, že povolíte rôzne vstupy a scenáre bez toho, aby sa upravil samotný tok údajov. Pomáha udržiavať všetko usporiadané tak, že znižuje potrebu viacerých tokov údajov a centralizuje kontrolu v rámci jedného parametrizovaného toku údajov.

Verejné parametre v Dataflow Gen2 sú novým režimom, v ktorom môžete povoliť spustenie toku údajov odovzdaním hodnôt parametrov mimo editora Power Query prostredníctvom rozhrania REST API služby Fabric alebo prostredníctvom natívnych prostredí služby Fabric. Umožňuje vám dynamickejšie prostredie s tokom údajov, kde je možné vyvolať každé spustenie s rôznymi parametrami, ktoré ovplyvňujú spôsob spustenia toku údajov.

Prerequisites

• Tok údajov Gen2 s podporou CI/CD
• Parametre musia byť nastavené v rámci toku údajov.Získajte ďalšie informácie o tom, ako nastaviť parametre dotazu v toku údajov.

Povolenie režimu verejného parametra

Ako vlastník toku údajov otvorte tok údajov. Na karte Domov na páse s nástrojmi vyberte tlačidlo Možnosti .

Výberom tlačidla sa otvorí nové dialógové okno Možnosti . Vo zvislej ponuke vyberte možnosť s označením Parametre vo vnútri skupiny toku údajov . V časti Parametre môžete povoliť možnosť s textom "Povoliť zistenie parametrov a ich prepísanie na vykonanie" , čím povolíte režim verejných parametrov.

Výberom tlačidla OK potvrďte tieto zmeny.

Keď je tento režim povolený, v dialógovom okne Spravovať parametre sa zobrazí upozornenie "Režim verejného parametra je povolený" v hornej časti dialógového okna.

Po povolení režimu verejného parametra môžete svoj tok údajov uložiť.

Odovzdávanie hodnôt vlastných parametrov pre spustenia toku údajov

Režim verejného parametra sleduje definíciu parametrov v toku údajov, kde existuje rozdiel medzi požadovanými a nevykonanými parametrami.

• Povinné parametre: ak je parameter nastavený ako požadovaný, na spustenie toku údajov je potrebné odovzdať hodnotu úlohe spustenia. Spustenie zlyhá, ak nie je odovzdaná žiadna hodnota pre parameter, ktorý je nastavený na povinné.
• Nepovinné parametre: nazývajú sa aj voliteľné parametre a na spustenie spustenia nie je potrebné odovzdať žiadnu hodnotu. Ak nie je odovzdaná žiadna hodnota, na spustenie sa použije aktuálna hodnota definovaná v parametri.

Použitie aktivity toku údajov v kanáloch

Note

Odporúčame vám prečítať si viac o aktivite toku údajov z kanálov služby Fabric , aby ste pochopili všetky jej možnosti.

Keď vytvoríte kanál v infraštruktúre, môžete použiť aktivitu toku údajov na spustenie toku údajov Gen2 s podporou CI/CD, ktorý má povolený režim verejných parametrov.

Môžete vybrať tok údajov, ktorý chcete použiť, a nastaviť parametre, ktoré chcete použiť, v časti Parametre toku údajov .

V časti Parametre toku údajov môžete vidieť všetky parametre dostupné v toku údajov a predvolenú hodnotu z každého z nich v sekcii hodnoty.

Povinné parametre majú vedľa názvu hviezdičku, zatiaľ čo voliteľné parametre nie. Zároveň je možné z mriežky odstrániť voliteľné parametre, zatiaľ čo požadované parametre nie je možné odstrániť a na spustenie toku údajov je potrebné odovzdať hodnotu.

Výberom tlačidla obnovenia môžete požiadať o najnovšie informácie o parametroch z toku údajov.

Podporované typy parametrov

Prepitné

Prečítajte si a použite parameter REST API pre zisťovanie toku údajov. Dokumentácia poskytuje všetky dostupné typy parametrov a ich očakávané hodnoty a rozhranie REST API poskytuje spôsob, ako získať informácie o parametroch z toku údajov.

V nasledujúcej tabuľke sú uvedené aktuálne podporované typy parametrov a prepojenie na definíciu rozhrania REST API, aby ste pochopili, aké hodnoty očakáva rozhranie REST API.

Typ parametra toku údajov	Definícia rozhrania REST API
SMS správa	DataflowStringParameter
Celé číslo (int64)	DataflowIntegerParameter
Desatinné číslo	DataflowNumberParameter
Date (Dátum)	DataflowDateParameter
Dátum a čas	DataflowDateTimeParameter
Time	DataflowTimeParameter
DateTimeZone (Dátum a časové pásmo)	DataflowDateTimeZoneParameter
Duration	DataflowDurationParameter
Pravda/Nepravda	DataflowBooleanParameter

Dôležité informácie a obmedzenia

Nasleduje zoznam všetkých aspektov a obmedzení pri používaní režimu verejných parametrov v Dataflow Gen2 s CI/CD:

• Plánovanie a manuálne spúšťanie: Toky údajov s verejnými parametrami nie je možné naplánovať ani manuálne spustiť prostredníctvom služby Fabric, pokiaľ nie sú nastavené žiadne požadované parametre.
• Nepodporovaná parametrizácia: Parametre, ktoré menia cesty zdrojov alebo cieľov, nie sú podporované. Pripojenia sú pevne nastavené na vytvorenú cestu.
• Prírastkové obnovenie: Nie je kompatibilné s režimom verejných parametrov.
• Úprava logiky: Verejné parametre umožňujú používateľom prístup k prepísaniu hodnôt, čo môže zmeniť výstup toku údajov.
• Centrum monitorovania: Centrum monitorovania nezobrazuje hodnoty parametrov použité počas vykonávania.
• Správanie stagingu: Iba najnovší beh sa ukladá v Dataflow Staging Lakehouse a vracia ho Dataflow Connector. Zvážte použitie dátového cieľa na uchovávanie údajov pre každý beh.
• Duplicitné žiadosti: Ak sú rovnaké hodnoty parametrov odoslané viackrát, akceptuje sa iba prvá žiadosť, kým sa nedokončí.
• Priradenie schémy: Parametre nemôžu upravovať priradenia cieľovej schémy. Všetky priradenia sa riadia vytvorenou konfiguráciou. Pozrite si článok, kde nájdete ďalšie informácie o cieľových umiestneniach údajov a spravovaných nastaveniach v službe Dataflow Gen2.