Vytvoření položky funkcí User Data Fabric v editoru Visual Studio Code

Funkce uživatelských dat ve Fabricu je bezserverové řešení, které umožňuje rychle a snadno vyvíjet aplikace nad zdroji dat nativními pro Fabric. Výhodami jsou zvýšená flexibilita a nákladová efektivita bezserverového výpočetního modelu v Fabricu. Funkce uživatelských dat se volají jako HTTP požadavky na koncový bod poskytovaný službou a pracují s vašimi zdroji dat, které jsou nativní pro Fabric.

V tomto rychlém startu se dozvíte, jak vytvořit položku funkcí uživatelských dat v editoru Visual Studio (VS) Code.

Požadavky

• Pracovní prostor Fabric
• Visual Studio Code
• Python
• Azure Functions Core Tools v4
• Rozšíření Microsoft Fabric
• rozšíření funkcí uživatelských dat

Vyberte pracovní prostor

1. Otevřete VS Code a přihlaste se k Fabric.

2. Ve Fabric otevřete svůj pracovní prostor nebo vytvořte nový pracovní prostor.

3. Vyberte + Nová položka, abyste otevřeli podokno Nová položka.

4. V podokně Nová položka v části Vývoj dat vyberte typ položky Funkce uživatelských dat.

5. Zadejte název položky pro nové funkce uživatelských dat a vyberte Vytvořit. Vytvoří se nová položka funkcí uživatelských dat.

6. Na pásu vyberte Python jako jazyk běhového prostředí.

7. Vytvořte virtuální prostředí pro tuto položku funkcí uživatelských dat.

8. Vyberte verzi modulu runtime Pythonu. Funkce uživatelských dat vyžadují Python verze 3.11.

9. Nastavte virtuální prostředí pro složku výběrem Ano.

10. Otevřete function_app.py a přidejte více než jednu funkci.

    

Napište svou první funkci

Napište položku funkcí uživatelských dat s dekorátorem @udf.function(), který definuje začátek funkce. Můžete předat vstup pro funkci, jako jsou primitivní datové typy, jako je str, int, float atd. Ve funkci můžete napsat vlastní obchodní logiku.

Tady je příklad funkce 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 funkcí uživatelských dat ve VS Code

Položku funkcí uživatelských dat můžete zobrazit ve Fabric Exploreru v VS Code v rámci aktuálně otevřeného pracovního prostoru.

Všechny funkce v pracovním prostoru Fabric lze otevřít v Průzkumníku ve VS Code a začít je upravovat. Zvolte funkci, kterou chcete otevřít, a pak vyberte Otevřít v Průzkumníku. Můžete zobrazit připojení, knihovny a všechny funkce napsané v položce funkcí uživatelských dat.

Správa připojení a knihoven

• Připojení: Všechna datová připojení přidaná pro vaši funkci uživatelských dat se dají zobrazit ve Fabric exploreru. Klikněte pravým tlačítkem myši a vyberte Spravovat připojení v prostředí Fabric pro položky funkcí uživatelských dat.

• Knihovny: Všechny knihovny přidané pro položku funkcí uživatelských dat lze zobrazit ve Fabric exploreru. Klikněte pravým tlačítkem myši a vyberte Spravovat knihovny v Fabric pro přidání nových knihoven pro položky funkcí uživatelských dat.

• functions: Můžete si tady zobrazit všechny publikované funkce. Vyberte funkci a proveďte tyto akce:

  • Spusťte a otestujte test funkce ve VS Code, aniž byste museli používat testovací nástroje rozhraní API.
  • Zkopírujte veřejnou adresu URL, pokud je tato funkce veřejně přístupná, vyvolejte ji z externí aplikace.

Místní složka pro správu funkcí uživatelských dat

Položka funkcí uživatelských dat otevřená v průzkumníku VS Code je viditelná v zobrazení Místní složka. Místní složka umožňuje testovat a zobrazit místní změny provedené v položce funkce data uživatele.

• Funkce: Můžete zobrazit všechny funkce, které jsou ve vašem místním function_app.py souboru. Pokud chcete začít s ukázkou, klikněte pravým tlačítkem na Functions a vyberte Přidat funkci pro přidání ukázkové funkce.

  

  Pokud chcete funkci otestovat lokálně, spusťte ladění stisknutím klávesy F5. Můžete také vybrat funkční položku a vybrat Spustit a ladit.

• Zobrazení připojení a knihoven pro místní funkci: Můžete zobrazit všechna připojení, která jsou v local.settings.json souboru, a knihovny v souboru v requirements.txt místním prostředí.

  • Synchronizujte připojení z local.settings pro zobrazení aktuálního seznamu připojení ve vašem místním prostředí.
  • Synchronizujte requirements.txt a zobrazte aktuální seznam knihoven v místním prostředí.

Publikování funkce Uživatelská data

Po otestování změn publikujte funkci uživatelských dat do Fabric. Publikování změn může trvat několik minut.

Screenshot snímek obrazovky ukazující, jak publikovat změny anebo přidávat nové funkce v položce funkce uživatelských dat pro místní vývoj.

Místní ladění s body přerušení

Vyberte F5 pro ladění funkcí Fabric. Zarážku můžete přidat kamkoli do kódu. V režimu ladění se zarážky aktivují podle očekávání a testujete svůj kód stejným způsobem, jako byste testovali nasazenou funkci.

Další kroky

• Informace o programovacím modelu uživatelských datových funkcí
• Kurz: Vyvolání funkcí uživatelských datových z aplikace v Pythonu