Tworzenie elementu funkcji danych Fabric

W tym przewodniku utworzymy nowy element funkcji danych użytkownika i napiszemy w nim nowe funkcje. Każdy element funkcji danych użytkownika zawiera kod, który definiuje jedną lub wiele funkcji, które można uruchomić indywidualnie.

W szczególności dowiesz się, jak wykonywać następujące działania:

• Utwórz element funkcji danych użytkownika.
• Napisz nową funkcję.
• Zarządzanie funkcjami.
• Uruchom funkcję.

Wymagania wstępne

• Pojemność usługi Microsoft Fabric w jednym z obsługiwanych regionów. Jeśli nie masz pojemności usługi Fabric, możesz utworzyć bezpłatną wersję próbną pojemności.
• Obszar roboczy Fabric powiązany z tą pojemnością

Utwórz nowy element funkcji danych użytkownika w systemie Fabric

1. Wybierz obszar roboczy i kliknij + Nowy element.
2. Wybierz Typ elementu jako Wszystkie elementy. Wyszukaj i wybierz Funkcje danych użytkownika.

Tworzenie nowego elementu funkcji danych użytkownika

1. W obszarze roboczym wybierz + Nowa pozycja.

2. W otwartym okienku wyszukaj user data functions, a następnie wybierz kafelek.

   Zrzut ekranu przedstawiający płytkę funkcji danych użytkownika w nowym okienku elementu.

3. Podaj Nazwę dla elementu funkcji danych użytkownika.

4. Wybierz Nowa funkcja, aby utworzyć szablon funkcji Python hello_fabric. W Eksploratorze usługi Functions są wyświetlane wszystkie opublikowane i gotowe do wywołania funkcje.

   

5. Po opublikowaniu funkcji hello_fabric można ją uruchomić z listy funkcji w Eksploratorze usługi Functions.

   

Dodawanie nowej funkcji z przykładu

Jest to przykład, jak dodać nową funkcję z menu Insert sample. W tym przypadku dodamy funkcję o nazwie Manipulowanie danych przy użyciu biblioteki pandas, która używa biblioteki pandas jako wymogu. Wykonaj kroki, aby dodać tę przykładową funkcję:

1. Upewnij się, że jesteś w trybie programowania. Wybierz Zarządzanie bibliotekami, aby dodać biblioteki potrzebne dla Twojej funkcji.

   

   Uwaga

   Biblioteka fabric_user_data_functions jest domyślnie dodawana i nie można jej usunąć. Ta biblioteka jest wymagana dla funkcji danych użytkownika. Należy zaktualizować wersję tej biblioteki pod kątem przyszłych wersji tego zestawu SDK.

2. Wybierz bibliotekę pandas i wersję. Po dodaniu biblioteki zostanie ona automatycznie zapisana w elemencie funkcji danych użytkownika.

   

3. Wybierz Wstaw próbkę i wybierz Manipuluj danymi za pomocą biblioteki pandas. Ta akcja spowoduje wstawienie przykładowego kodu w dolnej części kodu po innych funkcjach.

   

4. Gdy przykład zostanie wstawiony do edytora, przetestujesz go przy użyciu funkcji Testuj w trybie programowania.

5. Gdy wszystko będzie gotowe, możesz wybrać pozycję Publikuj , aby zapisać zmiany i zaktualizować funkcje. Publikowanie może potrwać kilka minut.

   

6. Po zakończeniu publikowania nowa funkcja zostanie wyświetlona na liście eksploratora funkcji. Ta funkcja jest teraz gotowa do uruchomienia z portalu lub wywołania z innej aplikacji albo elementu Fabric, np. potoku.

   

Uruchom swoją funkcję

1. Aby uruchomić funkcję, najpierw musisz przełączyć się do trybu Uruchom tylko , klikając przełącznik trybu.

   

2. Wybierz ikonę Uruchom, wyświetlaną po najechaniu kursorem na funkcję w eksploratorze funkcji.

   

3. Przekaż wymagane parametry w formularzu przedstawionym w Eksploratorze funkcji. W tym przypadku uruchomimy funkcję manipulate_data, która wymaga parametru w postaci ciągu JSON.

   [
    {
     "Name": "John",
     "Age": 22,
     "Gender": "male"
    }
   ]
   

4. Wybierz Uruchom, aby uruchomić funkcję.

   Zrzut ekranu przedstawiający dane wyjściowe po pomyślnym wykonaniu funkcji.

5. Możesz wyświetlić dzienniki na żywo i dane wyjściowe funkcji, aby sprawdzić, czy została pomyślnie uruchomiona. Alternatywnie zobaczysz komunikat o błędzie i dzienniki z wywołania funkcji.

Napisz nową funkcję

Każda wykonywalna funkcja zaczyna się od dekoratora @udf.function() przed jej definicją. Przeczytaj więcej o naszym modelu programowania w Pythonie. Aby napisać nową funkcję, użyj dekoratora @udf.function() na początku, aby zadeklarować ją jako funkcję do uruchomienia. Oto przykładowa funkcja:

# This sample allows you to pass a credit card number as an integer and mask it, leaving the last 4 digits. 

@udf.function()
def maskCreditCard(cardNumber: int)-> str:
    # Convert the card number to a string
    cardNumberStr = str(cardNumber)
    
    # Check if the card number is valid
    if not cardNumberStr.isdigit() or not (13 <= len(cardNumberStr) <= 19):
        raise ValueError("Invalid credit card number")
    
    # Mask all but the last four digits
    maskedNumber = '*' * (len(cardNumberStr) - 4) + cardNumberStr[-4:]
    
    return str(maskedNumber)

Gdy funkcja będzie gotowa, opublikuj funkcję, aby ją uruchomić.

Kluczowe pojęcia dotyczące modelu programowania

Funkcje danych użytkownika używają modelu programowania funkcji danych użytkownika w Pythonie do tworzenia, uruchamiania, debugowania i modyfikowania poszczególnych funkcji. Jest to wewnętrzna biblioteka, która zapewnia niezbędne funkcjonalności do wywoływania funkcji w Fabric i wykorzystania wszystkich integracji.

Po utworzeniu pierwszej funkcji pierwsze wiersze kodu będą zawierać instrukcje importu z bibliotekami niezbędnymi do uruchomienia szablonu.

import datetime
import fabric.functions as fn
import logging

udf = fn.UserDataFunctions()

Uwaga

Instrukcja import zawierająca bibliotekę fabric.functions i wiersz zawierający tę instrukcję udf = fn.UserDataFunctions() są niezbędne do prawidłowego uruchamiania funkcji. Funkcje nie będą działać prawidłowo, jeśli te linie są nieobecne.

• Aby móc tworzyć, uruchamiać i zarządzać funkcjami, potrzebujesz fabric.functions zestawu SDK oraz kilku innych ważnych bibliotek, takich jak logging, które umożliwiają pisanie niestandardowych dzienników.
• udf=fn.UserDataFunctions() to konstrukcja do definiowania funkcji w elemencie funkcji danych użytkownika.

Zarządzanie funkcjami danych

Zmienianie nazwy funkcji

1. W obszarze Tryb programowania wybierz edytor kodu i zaktualizuj nazwę funkcji. Na przykład zmień nazwę hello_fabric na hello_fabric1:

   @udf.function()
   def hello_fabric1(name: str) -> str:
      logging.info('Python UDF trigger function processed a request.')
   
      return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"
   

2. Po zmianie wybierz Publikuj, aby zapisać te zmiany.

3. Po opublikowaniu zmian można wyświetlić nową nazwę funkcji w Eksploratorze funkcji.

Usuwanie funkcji

Aby usunąć funkcję, wybierz kod funkcji w edytorze kodu i usuń całą sekcję kodu. Opublikuj zmiany, aby całkowicie usunąć je z elementu funkcji danych użytkownika.

Aby na przykład usunąć funkcję hello_fabric, usuń następujący blok kodu:

@udf.function()
def hello_fabric(name: str) -> str:
    logging.info('Python UDF trigger function processed a request.')

    return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"

Po usunięciu kodu możesz wybrać Publikuj, aby zapisać zmiany. Po zakończeniu publikowania zostanie wyświetlona zaktualizowana lista dostępnych funkcji w Eksploratorze funkcji.

Następne kroki

• Utwórz element funkcji użytkownika Fabric w programie Visual Studio Code
• Dowiedz się więcej o modelu programowania funkcji danych użytkownika