Czym są funkcje danych użytkownika Fabric?

Funkcje danych użytkownika pozwalają tworzyć wielokrotnego użytku funkcje Python, które można wywoływać z różnych stron Fabric i z zewnętrznych aplikacji. Napisz logikę biznesową raz i wywołaj ją z potoków, notatników, reguł aktywatora, translitycznych przepływów zadań Power BI lub dowolnego zewnętrznego systemu przez punkty końcowe 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.

Animowany GIF przedstawiający interfejs funkcji danych użytkownika 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 korzystać z funkcji danych użytkownika Fabric?

Funkcje danych użytkownika Fabric udostępniają platformę bezserwerową do hostowania własnej logiki i wywoływania jej z różnych typów elementów i źródeł danych Fabric. Korzystaj z tej usługi do pisania logiki biznesowej, algorytmów wewnętrznych i funkcji wielokrotnego użytku, które integrują się z twoimi rozwiązaniami Fabric.

Poniżej przedstawiono kluczowe korzyści:

  • Wielokrotne użycie: Napisz swoją logikę biznesową raz jako funkcję danych użytkownika i wywołaj ją z wielu elementów Fabric – potoków, notatników, reguł aktywatora i translitycznych przepływów zadań 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ą środowisko obliczeniowe bez serwera z wbudowaną autentykacją, więc nie musisz konfigurować i utrzymywać oddzielnych usług API ani 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

  • Zapisz raz, uruchom gdziekolwiek: Stwórz funkcje działające identycznie, niezależnie od tego, czy są wywoływane z potoków, notatników, reguł aktywatora, Power BI, czy 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: Połącz się ze źródłami danych Fabric (bazy danych SQL, magazyny, domy nad jeziorem, bazy danych lustrzane) z wbudowaną autentyzacją 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 integrują się bezproblemowo z obciążeniami Fabric i zewnętrznymi systemami, 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 – Wykonują funkcje jako działania potokowe do transformacji, walidacji lub logiki orkiestracji danych
  • 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ć kontekst raportu – taki jak aktualny filtr i kontekst wyboru – w ładunku żądania, umożliwiając wykonywanie akcji i scenariusze zapisu z wewnątrz 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 SQL w Fabric
  • Magazyny — operacje odczytu i zapisu dla danych ustrukturyzowanych
  • Lakehouses — odczyt i zapis plików Lakehouse; Dostęp tylko do odczytu do punktów końcowych analizy SQL
  • Dublowane bazy danych — dostęp tylko do odczytu do dublowanych danych bazy danych
  • Biblioteka zmiennych – Dostęp do scentralizowanych ustawień konfiguracji jako zmiennych w twoich funkcjach.
  • Cosmos DB in Fabric - Podłącz się do Cosmos DB w kontenerach Fabric dla operacji danych NoSQL.
  • Zdarzenia biznesowe – Wykrywanie zmian w danych operacyjnych i publikowanie zdarzeń biznesowych dla aplikacji w dalszej fazie rozwoju.

Oprócz połączeń zarządzanych, funkcje danych użytkownika wspierają połączenia uniwersalne, które można wykorzystać do łączenia się z elementami Fabric lub zasobami Azure, używając tożsamości właściciela elementu. Połączenia generowane generują token Microsoft Entra ID z tożsamością właściciela dla określonego typu odbiorców, zapewniając elastyczny sposób uwierzytelniania za pomocą usług takich jak Azure Cosmos DB czy Azure Key Vault bez konieczności konfigurowania pojedynczych połączeń zarządzanych. Aby uzyskać więcej informacji, zobacz Połączenia ogólne dla elementów Fabric lub zasobów platformy Azure.

Zapis z translitycznych przepływów zadań Power BI jest natywnie wspierany podczas wywoływania funkcji danych użytkownika. Funkcje użytkowników danych mogą wykonywać operacje dodawania, aktualizacji i usuwania w bazach SQL w Fabric, magazynach i plikach Lakehouse, co czyni je idealnym punktem integracji w scenariuszach zapisu sterowanego przepływem 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 udostępnia własny, unikalny punkt końcowy REST do integracji z systemami spoza Fabric:

  • 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 Microsoft Entra ID, zapewniając bezpieczny dostęp z zewnętrznych systemów. Dowiedz się, jak wywoływać funkcje danych użytkownika z aplikacji Python.

Wprowadzenie

Gotowy, by stworzyć swoje pierwsze funkcje do przechowywania danych użytkowników? Wybierz preferowane środowisko programistyczne: