Vytvorenie položky funkcií údajov používateľa štruktúry v editore Visual Studio Code

Údajové funkcie používateľa služby Fabric sú bezserverovým riešením, ktoré vám umožňuje rýchlo a jednoducho vyvíjať aplikácie z natívnych zdrojov údajov služby Fabric. Výhodami sú zvýšená flexibilita a nákladová účinnosť bezserverových výpočtov v službe Fabric. Údajové funkcie používateľa sa vyvolajú ako požiadavky HTTP na koncový bod poskytnutý službou a pracujú s vašimi natívnymi zdrojmi údajov služby Fabric.

V tomto rýchlom štarte sa dozviete, ako vytvoriť položku údajových funkcií používateľa v programe Visual Studio (VS) Code.

Požiadavky

• Pracovný priestor služby Fabric
• Visual Studio Code
• jazyka Python
• Azure Functions Core Tools v4
• rozšírenia služby Microsoft Fabric
• rozšírenie údajových funkcií používateľa

Vyberte pracovný priestor

1. Otvorte VS Code a sa prihláste do služby Fabric.

2. V službe Fabric otvoriť pracovný priestor služby Fabric alebo vytvoriť nový pracovný priestor.

3. Výberom položky + Nová položka otvorte tablu Nová položka.

4. Na table Nová položka v časti Vytvoriťúdajov vyberte typ položky funkcie údajov Používateľ.

5. Zadajte názov položky nových údajových funkcií používateľa a vyberte položky Vytvoriť. Vytvorí sa nová položka údajových funkcií používateľa.

6. Na páse s nástrojmi vyberte položku jazyk Python ako jazyk runtime.

7. Vytvorte virtuálne prostredie pre túto položku údajových funkcií používateľa.

8. Vyberte verziu režimu runtime jazyka Python. Funkcie údajov používateľov vyžadujú verziu 3.11 jazyka Python.

9. Nastavte virtuálne prostredie priečinka výberom položky Áno.

10. Otvorte function_app.py a pridajte viac ako jednu funkciu.

    

Napíšte svoju prvú funkciu

Napíšte položku údajových funkcií používateľa pomocou dekorátora @udf.function() na definovanie začiatku funkcie. Vstup môžete odovzdať funkcii, ako sú napríklad primitívne typy údajov, ako str, int, float atď. V rámci funkcie môžete napísať vlastnú obchodnú logiku.

Tu je príklad funkcie hello_fabric.

@udf.function()
def hello_fabric(name: str) -> str:
    # Use logging to write custom logs to help trace and debug issues 
    logging.info('Python UDF trigger function processed a request.')
    logging.info('Executing hello fabric function.')
    
    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!" 

Správa používateľských údajových funkcií v nástroji VS Code

Položku používateľských údajových funkcií môžete zobraziť v prieskumníkovi služby Fabric v nástroji VS Code v aktuálne otvorenom pracovnom priestore.

Všetky funkcie v pracovnom priestore služby Fabric je možné otvoriť v Prieskumníkovi v programe VS Code a začať s úpravami. Vyberte funkciu, ktorú chcete otvoriť, a potom vyberte položky Otvoriť v Prieskumníkovi. Môžete vidieť pripojenia, knižnice a všetky funkcie napísané v položke údajových funkcií používateľa.

Správa pripojení a knižníc

• Pripojenia: Všetky údajové pripojenia pridané pre funkciu používateľských údajov je možné zobraziť z prieskumníka služby Fabric. Kliknite pravým tlačidlom myši na položku Spravovať pripojenia v službe Fabric pre položky používateľských údajových funkcií.

• knižnice: Všetky knižnice pridané pre položku údajových funkcií používateľa môžete zobraziť v prieskumníkovi služby Fabric. Kliknite pravým tlačidlom myši a vyberte Spravovať knižnice v službe Fabric, čím pridáte nové knižnice pre položky používateľských údajových funkcií.

• Functions: Všetky publikované funkcie nájdete tu. Vyberte funkciu a vykonajte tieto akcie:

  • spustiť a testovať na otestovanie funkcie v nástroji VS Code bez toho, aby ste museli používať testovacie nástroje rozhrania API.
  • Skopírujte verejnú URL adresu, ak je táto funkcia verejne dostupná a vyvoláva z externej aplikácie.

Lokálny priečinok na spravovanie používateľských údajových funkcií

Položka používateľských údajových funkcií otvorená v prieskumníkovi programu VS Code je viditeľná v zobrazení lokálnych priečinkov. Lokálny priečinok vám umožňuje testovať a zobrazovať miestne zmeny vykonané v položke údajovej funkcie používateľa.

• Functions: Môžete zobraziť všetky funkcie, ktoré sa nachádzajú v lokálnom súbore function_app.py. Ak chcete začať s ukážkou, kliknite pravým tlačidlom myši na funkcie a vyberte Pridať funkciu a pridajte ukážkovú funkciu.

  

  Ak chcete funkciu otestovať lokálne, stlačte kláves F5 a začnite ladenie. Môžete tiež vybrať položku funkcie a vybrať položky Spustiť a ladiť.

• Zobrazenie pripojení a knižníc pre lokálne funkcie: Môžete zobraziť všetky pripojenia, ktoré sa nachádzajú v local.settings.json a knižnice v súbore requirements.txt v lokálnom prostredí.

  • Synchronizovať pripojenia z local.settings, aby sa zobrazil aktuálny zoznam pripojení v lokálnom prostredí.
  • synchronizovať requirements.txt, aby sa zobrazil aktuálny zoznam knižníc v lokálnom prostredí.

Publikovanie funkcie údajov používateľa

Po teste zmien publikujte funkciu údajov používateľa do služby Fabric. Publikovanie zmien môže trvať niekoľko minút.

Lokálne ladenie bodmi prerušenia

Vyberte položku F5 na ladenie funkcií služby Fabric. Bod prerušenia môžete pridať kdekoľvek v kóde. V režime ladenia sa body prerušenia zachyťujú podľa očakávania a otestujú kód, ako by ste testovali nasadenú funkciu.

Ďalšie kroky

• Ďalšie informácie o modeli programovania údajových funkcií používateľov
• Tutorial: Vyvolanie údajových funkcií používateľov z aplikácie jazyka Python