Utwórz element funkcji danych użytkownika Fabric w programie Visual Studio Code

Funkcje danych użytkownika sieci szkieletowej to rozwiązanie bezserwerowe, które umożliwia szybkie i łatwe tworzenie aplikacji na podstawie natywnych dla sieci szkieletowej źródeł danych. Zaletami są zwiększona elastyczność i opłacalność przetwarzania bezserwerowego w Fabric. Funkcje danych użytkownika są wywoływane jako żądania HTTP do punktu końcowego dostarczonego przez usługę i działają w źródłach danych natywnych dla sieci szkieletowej.

Z tego przewodnika Szybki start dowiesz się, jak utworzyć element funkcji danych użytkownika w programie Visual Studio (VS) Code.

Wymagania wstępne

• Obszar roboczy Fabric
• Visual Studio Code
• Python
• Azure Functions Core Tools w wersji 4
• Rozszerzenie usługi Microsoft Fabric
• Rozszerzenie funkcji danych użytkownika

Wybieranie obszaru roboczego

1. Otwórz program VS Code i zaloguj się do Fabric.

2. W Fabric otwórz obszar roboczy lub utwórz nowy obszar roboczy.

3. Wybierz pozycję + Nowy element , aby otworzyć okienko Nowy element.

4. W okienku Nowy element w obszarze Opracowywanie danych wybierz typ elementu Funkcje danych użytkownika .

5. Podaj nazwę nowego elementu funkcji danych użytkownika i wybierz pozycję Utwórz. Zostanie utworzony nowy element funkcji danych użytkownika.

6. Na wstążce wybierz pozycję Python jako język środowiska uruchomieniowego.

7. Utwórz środowisko wirtualne dla tego elementu funkcji danych użytkownika.

8. Wybierz wersję środowiska uruchomieniowego języka Python. Funkcje danych użytkownika wymagają języka Python w wersji 3.11.

9. Ustaw środowisko wirtualne dla folderu, wybierając pozycję Tak.

10. Otwórz function_app.py, aby dodać więcej niż jedną funkcję.

    

Napisz swoją pierwszą funkcję

Napisz element funkcji danych użytkownika za pomocą dekoratora @udf.function() , aby zdefiniować początek funkcji. Można przekazać wejście do funkcji, takie jak prymitywne typy danych, na przykład str, int, float itp. We wnętrzu funkcji można napisać niestandardową logikę biznesową.

Oto przykład hello_fabric funkcji.

@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()}!" 

Zarządzanie funkcjami danych użytkownika w programie VS Code

Element funkcji danych użytkownika można wyświetlić w Eksploratorze Fabric w programie VS Code w aktualnie otwartym obszarze roboczym.

Wszystkie funkcje w obszarze roboczym Fabric można otworzyć w Eksploratorze w programie VS Code, aby rozpocząć edycję. Wybierz funkcję, którą chcesz otworzyć, a następnie wybierz pozycję Otwórz w Eksploratorze. Możesz zobaczyć połączenia, biblioteki i wszystkie funkcje zapisane w elemencie funkcji danych użytkownika.

Zarządzanie połączeniami i bibliotekami

• Połączenia: Wszystkie połączenia danych dodane dla funkcji danych użytkownika można wyświetlić w Fabric Explorer. Kliknij prawym przyciskiem myszy i wybierz pozycję Zarządzaj połączeniami w Fabric dla funkcji danych użytkownika.

• Biblioteki: wszystkie biblioteki dodane do elementu funkcji danych użytkownika można obejrzeć w Fabric explorer. Kliknij prawym przyciskiem myszy i wybierz pozycję Zarządzaj bibliotekami w Fabric, aby dodać nowe biblioteki dla elementów funkcji danych użytkownika.

• Funkcje: wszystkie opublikowane funkcje można wyświetlić tutaj. Wybierz funkcję i wykonaj następujące akcje:

  • Uruchom i przetestuj, aby przetestować funkcję w VS Code bez konieczności używania narzędzi do testowania interfejsu API.
  • Skopiuj publiczny adres URL , jeśli ta funkcja jest publicznie dostępna dla wywołania z aplikacji zewnętrznej.

Folder lokalny do zarządzania funkcjami danych użytkownika

Element funkcji danych użytkownika otwarty w Eksploratorze programu VS Code jest widoczny w widoku Folder lokalny. Folder lokalny umożliwia testowanie i wyświetlanie lokalnych zmian wprowadzonych w elemencie funkcji danych użytkownika.

• Funkcje: możesz wyświetlić wszystkie funkcje, które znajdują się w pliku lokalnym function_app.py . Aby rozpocząć od przykładu, kliknij prawym przyciskiem myszy pozycję Funkcje i wybierz polecenie Dodaj funkcję , aby dodać przykładową funkcję.

  

  Aby przetestować funkcję lokalnie, naciśnij F5 , aby rozpocząć debugowanie. Możesz również wybrać element funkcji, a następnie wybrać pozycję Uruchom i debuguj.

• Wyświetlanie połączeń i bibliotek dla funkcji lokalnej: możesz wyświetlić wszystkie połączenia, które znajdują się w pliku local.settings.json i biblioteki w requirements.txt środowisku lokalnym.

  • Synchronizuj połączenia z pliku local.settings , aby wyświetlić bieżącą listę połączeń w środowisku lokalnym.
  • Zsynchronizuj requirements.txt , aby wyświetlić bieżącą listę bibliotek w środowisku lokalnym.

Publikowanie funkcji danych użytkownika

Po przetestowaniu zmian opublikuj funkcję danych użytkownika w usłudze Fabric. Opublikowanie zmian może potrwać kilka minut.

Debugowanie lokalne z punktami przerwania

Wybierz F5 aby debugować funkcje Fabric. Punkt przerwania można dodać w dowolnym miejscu w kodzie. W trybie debugowania punkty przerwania są osiągane zgodnie z oczekiwaniami i testują kod, tak jak w przypadku testowania wdrożonej funkcji.

Następne kroki

• Dowiedz się więcej o modelu programowania funkcji danych użytkownika
• Samouczek: Wywoływanie funkcji dotyczących danych użytkownika z aplikacji Python