Parametre pre službu Data Factory v službe Microsoft Fabric

Tento dokument popisuje, ako používať parametre v kanáloch služby Data Factory v službe Fabric.

Používanie parametrov, výrazov a funkcií v kanáloch služby Data Factory v službe Fabric

V tomto dokumente sa zameriavame na základné koncepty s rôznymi príkladmi, aby sme preskúmali možnosť vytvorenia parametrizovaných údajových kanálov v rámci služby Data Factory v službe Fabric. Parametrizácia a dynamické výrazy môžu ušetriť obrovské množstvo času a umožniť oveľa flexibilnejšie riešenie typu Extract, Transform, Load (ETL) alebo Extract, Load, Transform (ELT), čo výrazne znižuje náklady na údržbu riešení a urýchli implementáciu nových funkcií do existujúcich kanálov. Sú to preto, že parametrizácia minimalizuje množstvo pevného kódovania a zvyšuje počet opätovne použiteľných objektov a procesov v riešení.

Koncepty parametrov a výrazov

Pomocou parametrov môžete do kanálov odovzdať externé hodnoty. Keď je parameter odovzdaný do zdroja, nedá sa zmeniť. Parametrizovaním zdrojov ich môžete zakaždým znova použiť s rôznymi hodnotami. Parametre možno použiť jednotlivo alebo ako súčasť výrazov. Hodnoty parametrov v definícii môžu byť literál alebo výrazy, ktoré sa vyhodnocujú v režime runtime.

Výrazy sa môžu zobrazovať kdekoľvek v hodnote reťazca a vždy vygenerovať inú hodnotu reťazca. Tu je heslo parameter kanála vo výraze. Ak je hodnota parametra výrazom, telo výrazu sa extrahuje odstránením znaku @. Ak je potrebný reťazec literálu, ktorý sa začína reťazcom @, musí byť vytvorený pomocou @@. V nasledujúcich príkladoch je uvedené, ako sa vyhodnocujú výrazy.

Výrazy sa môžu zobraziť aj v reťazcoch pomocou funkcie s názvom interpolácie reťazca, kde sú výrazy zabalené do @{ ... }. Nasledujúci reťazec napríklad obsahuje hodnoty parametrov a hodnoty literálového reťazca:

"Meno: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Výsledkom interpolácie reťazca je vždy reťazec. Ak ste napríklad definovali myNumber ako 42 a myString ako foo:

Príklady použitia parametrov vo výrazoch

Vytváranie a používanie parametrov

Ak chcete vytvoriť parametre, vyberte pozadie plátna editora kanála a potom kartu Parametre karty okna Vlastnosti v dolnej časti. Vyberte tlačidlo + Nový a pridajte doň nový parameter, pomenujte ho, typ údajov a predvolenú hodnotu:

Potom môžete parameter použiť kdekoľvek vo svojom kanáli, kde je podporovaný dynamický obsah. V tomto príklade sa parameter používa na dynamické zadanie názvu ukladacieho priestoru údajov Lakehouse na karte zdroja stránok vlastností aktivity kopírovania.

Zobrazí sa okno Pridať dynamický obsah, ktoré vám umožní zadať akýkoľvek druh dynamického obsahu vrátane parametrov, systémových premenných, funkciíalebo premenných kanálov. V tomto príklade je vybratý predtým definovaný parameter a v okne s dynamickým obsahom sa automaticky vyplní správny výraz, ktorý odkazuje na parameter.

Príklad komplexného výrazu

Nasledujúci príklad ukazuje zložitý príklad, ktorý odkazuje na hlboké podpolo výstupu aktivity. Ak chcete odkazovať na parameter kanála, ktorý sa vyhodnotí ako podpolo, použite syntax [] namiesto operátora dot(.) (ako pri podpole1 a subfield2).

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Editor dynamického obsahu

Keď dokončíte úpravu, editor dynamického obsahu automaticky odstráni znaky vo vašom obsahu. Napríklad nasledujúci obsah v editore obsahu je interpolácia reťazca s funkciou výrazu:

@{toUpper('myData')}

Editor dynamického obsahu skonvertuje predchádzajúci obsah na nasledujúci výraz:

MYDATA

Používanie funkcií a premenných vo výrazoch

Môžete volať funkcie a používať premenné v rámci výrazov. Nasledujúce časti poskytujú informácie o funkciách, ktoré možno použiť vo výraze.

Premenné rozsahu kanála

Na tieto systémové premenné možno odkazovať kdekoľvek v kanáli JSON.

Funkcie reťazcov

Ak chcete pracovať s reťazcami, môžete použiť tieto funkcie reťazcov a tiež niektoré funkcie kolekcie . Funkcie reťazcov fungujú iba s reťazcami.

Funkcie kolekcie

Ak chcete pracovať s kolekciami, všeobecne poľami, reťazcami a niekedy slovníkmi, môžete použiť tieto funkcie kolekcie.

Logické funkcie

Tieto funkcie sú užitočné v rámci podmienok, možno ich použiť na vyhodnotenie akéhokoľvek typu logiky.

Funkcie konverzie

Tieto funkcie sa používajú na konvertovanie medzi jednotlivými natívnymi typmi v jazyku:

• povrázok
• celé číslo
• plávať
• Boolean
• Polia
• Slovníky

Matematické funkcie

Tieto funkcie možno použiť pre oba typy čísel: celé čísla a plávajú.

Dátumové funkcie

Súvisiaci obsah

• Expression language