Co to są funkcje danych użytkownika Fabric?

Funkcje danych użytkownika umożliwiają tworzenie funkcji Python wielokrotnego użytku, które mogą być wywoływane w Microsoft Fabric i z aplikacji zewnętrznych. Napisz logikę biznesową raz i wywołaj ją z potoków, notesów, reguł aktywatora, przepływów zadań translytical w Power BI lub dowolnego systemu zewnętrznego za pośrednictwem punktów końcowych REST.

Funkcje danych użytkownika zapewniają bezserwerowe środowisko obliczeniowe, w którym można hostować i uruchamiać niestandardowy kod Python bezpośrednio w Fabric. Niezależnie od tego, czy musisz standandaryzować kategorie produktów, zastosować złożone reguły biznesowe, czy zintegrować je z zewnętrznymi interfejsami API, możesz napisać funkcje, które są natychmiast dostępne na całej platformie danych. Usługa obsługuje środowisko uruchomieniowe języka Python 3.11.9, biblioteki publiczne z PyPI i połączenia danych Fabric.

Chcesz rozpocząć pracę? Postępuj zgodnie z tym przewodnikiem, aby utworzyć nowy element funkcji danych użytkownika lub użyć rozszerzenia VS Code.

Dlaczego warto używać funkcji użytkownika Fabric?

Funkcje User Data Fabric udostępniają bezserwerową platformę do hostowania niestandardowej logiki i wywoływania jej z różnych typów elementów Fabric i źródeł danych. Za pomocą tej usługi można pisać logikę biznesową, wewnętrzne algorytmy i funkcje wielokrotnego użytku, które integrują się z rozwiązaniami sieci szkieletowej.

Poniżej przedstawiono kluczowe korzyści:

• Reusability: Napisz logikę biznesową raz jako funkcję danych użytkownika i wywołaj ją z wielu elementów Fabric — potoki, notesy, reguły aktywatora i przepływy zadań translytical w Power BI. Gdy reguły biznesowe zmieniają się, zaktualizuj funkcję raz, a nie modyfikując kod w wielu miejscach.
• Hosting bezserwerowy: wdrażanie funkcji języka Python bez zarządzania infrastrukturą. Funkcje danych użytkownika zapewniają bezserwerowe środowisko obliczeniowe z wbudowanym uwierzytelnianiem, eliminując konieczność konfigurowania i obsługi oddzielnych usług interfejsu API lub kontenerów.
• Łączność zewnętrzna: każda funkcja automatycznie uwidacznia własny unikatowy punkt końcowy REST, umożliwiając integrację z aplikacjami zewnętrznymi, usługami internetowymi i niestandardowymi klientami. Wywoływanie funkcji z dowolnego systemu obsługującego żądania HTTP.

Kluczowe możliwości

• Pisanie raz, uruchamianie w dowolnym miejscu: tworzenie funkcji, które działają identycznie, czy są wywoływane z potoków, notatników, reguł Activator, Power BI lub zewnętrznych wywołań REST
• Rozbudowany ekosystem języka Python: użyj dowolnego pakietu z PyPI, aby utworzyć zaawansowaną logikę — bibliotekę pandas do manipulowania danymi, żądania wywołań interfejsu API lub wyspecjalizowane biblioteki dla domeny
• Bezpieczny dostęp do danych: łączenie ze źródłami danych Fabric (bazy danych SQL, magazyny, Lakehouses, mirrorowane bazy danych) z wbudowanym uwierzytelnianiem i zabezpieczeniami
• Opracowywanie i publikowanie przepływu pracy: Testuj funkcje przed ich opublikowaniem, aby upewnić się, że zmiany są zweryfikowane przed udostępnieniem do wywołania.

Możliwości integracji

Funkcje danych użytkownika bezproblemowo integrują się z obciążeniami usługi Microsoft Fabric i systemami zewnętrznymi, umożliwiając tworzenie kompleksowych rozwiązań danych.

Wywołaj z elementów Fabric

Wywołaj funkcje z dowolnego obciążenia platformy Fabric, aby scentralizować logikę biznesową i zachować spójność.

• Potoki danych — wykonywanie funkcji jako aktywności w potoku na potrzeby przekształceń danych, walidacji lub logiki orkiestracji
• Notatniki — wywoływanie funkcji z notatników PySpark lub Python na potrzeby procesów nauki o danych i analizy eksploracyjnej
• Reguły aktywatora — funkcje wyzwalania w odpowiedzi na zdarzenia w czasie rzeczywistym i dane przesyłane strumieniowo
• Power BI translytical task flows — wywoływanie funkcji bezpośrednio z raportów Power BI na potrzeby interaktywnego doświadczenia z danymi. Funkcje danych użytkownika mogą otrzymywać w ładunku żądania kontekst raportu, taki jak bieżący kontekst filtru i wyboru, co umożliwia wykonywanie akcji i scenariuszy aktualizacji danych bezpośrednio z raportu. Po zakończeniu zapisu widoczność danych w raporcie zależy od trybu przechowywania raportu i semantyki odświeżania: zaktualizowane wartości są wyświetlane natychmiast dla raportów trybu Direct Lake lub DirectQuery albo po automatycznym odświeżeniu wyzwalanym przez przepływ zadań dla raportów trybu importu.

Łączenie ze źródłami danych Fabric

Twoja funkcje mogą bezpiecznie uzyskiwać dostęp do danych z całej platformy Fabric.

• Bazy danych SQL — operacje odczytu i zapisu w bazach danych SQL Fabric
• Magazyny — operacje odczytu i zapisu dla danych ustrukturyzowanych
• Lakehouses — odczyt i zapis plików Lakehouse; dostęp do punktów końcowych SQL tylko do odczytu
• Dublowane bazy danych — dostęp tylko do odczytu do dublowanych danych bazy danych

Funkcja zapisywania zwrotnego z przepływów zadań translitycznych Power BI jest natywnie obsługiwana podczas wywoływania funkcji danych użytkownika. Funkcje danych użytkownika mogą wykonywać operacje dodawania, aktualizowania i usuwania względem plików Fabric SQL Database, Fabric Data Warehouse i Lakehouse, co czyni je idealnym punktem integracji w scenariuszach zapisu opartego na przepływie zadań.

Dowiedz się więcej na temat łączenia się ze źródłami danych Fabric.

Wywoływanie z aplikacji zewnętrznych

Każda funkcja danych użytkownika automatycznie uwidacznia własny unikatowy punkt końcowy REST na potrzeby integracji z systemami spoza sieci szkieletowej:

• Aplikacje internetowe — wywoływanie funkcji z aplikacji internetowych, aplikacji mobilnych lub aplikacji jednostronicowych
• Usługi zewnętrzne — integracja z systemami zewnętrznymi, mikrousługami lub starszymi aplikacjami — na przykład publikowanie komunikatów lub aktualizacji w celu Microsoft Teams lub wywoływanie zewnętrznych interfejsów API REST w ramach akcji opartych na przepływie zadań
• Przepływy pracy API — łączenie funkcji z innymi API do tworzenia zaawansowanych scenariuszy integracyjnych
• Klienci niestandardowi — wywoływanie z dowolnego języka programowania lub platformy obsługującego żądania HTTP

Punkty końcowe REST dla funkcji danych użytkownika obsługują uwierzytelnianie identyfikatora Entra firmy Microsoft, zapewniając bezpieczny dostęp z systemów zewnętrznych. Dowiedz się, jak wywoływać funkcje danych użytkownika z poziomu aplikacji w języku Python.

Wprowadzenie

Chcesz utworzyć pierwszą funkcję danych użytkownika? Wybierz preferowane środowisko programistyczne:

• Tworzenie funkcji w portalu Fabric — przewodnik szybki start z programowaniem i testowaniem w przeglądarce
• Programowanie przy użyciu programu Visual Studio Code — pełne środowisko IDE z lokalnym debugowaniem i integracją z usługą Git

Treści powiązane

• Model programowania funkcji danych użytkownika — szczegółowe informacje na temat zestawu SDK języka Python, dekoratorów i zaawansowanych funkcji
• Wywoływanie funkcji z aplikacji w języku Python — dowiedz się, jak wywoływać funkcje za pośrednictwem punktów końcowych REST z systemów zewnętrznych