Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mithilfe von Benutzerdatenfunktionen können Sie wiederverwendbare Python Funktionen erstellen, die über Microsoft Fabric und externe Anwendungen hinweg aufgerufen werden können. Schreiben Sie Ihre Geschäftslogik einmal, und rufen Sie sie über Pipelines, Notizbücher, Aktivierregeln, Power BI translytische Aufgabenflüsse oder ein externes System über REST-Endpunkte auf.
Benutzerdatenfunktionen bieten eine serverlose Computeumgebung, in der Sie benutzerdefinierte Python Code direkt in Fabric hosten und ausführen können. Unabhängig davon, ob Sie Produktkategorien standardisieren, komplexe Geschäftsregeln anwenden oder in externe APIs integrieren müssen, können Sie Funktionen schreiben, die sofort auf der gesamten Datenplattform verfügbar sind. Der Dienst unterstützt Python 3.11.9 Runtime, öffentliche Bibliotheken von PyPI und Fabric-Datenverbindungen.
Sind Sie bereit für die ersten Schritte? Folgen Sie diesem Leitfaden, um ein neues User Data Functions-Element zu erstellen oder die VS-Code-Erweiterung zu verwenden.
Gründe für die Verwendung von Fabric-Benutzerdatenfunktionen
Fabric-Benutzerdatenfunktionen bieten eine serverlose Plattform, um Ihre benutzerdefinierte Logik zu hosten und aus verschiedenen Typen von Fabric-Elementen und -Datenquellen aufzurufen. Sie können diesen Dienst verwenden, um Geschäftslogik, interne Algorithmen und wiederverwendbare Funktionen zu schreiben, die in Ihre Fabric-Lösungen integriert werden.
Im Folgenden sind die wichtigsten Vorteile aufgeführt:
- Reusability: Schreiben Sie Ihre Geschäftslogik einmal als benutzerspezifische Datenfunktion und rufen Sie sie aus mehreren Fabric-Elementen auf – Pipelines, Notizbücher, Aktivierungsregeln und Power BI translytische Aufgabenflüsse. Wenn Geschäftsregeln geändert werden, aktualisieren Sie die Funktion einmal, anstatt Code an mehreren Stellen zu ändern.
- Serverloses Hosting: Bereitstellen von Python-Funktionen ohne Verwaltung der Infrastruktur. Benutzerdatenfunktionen bieten eine serverlose Computeumgebung mit integrierter Authentifizierung, ohne dass separate API-Dienste oder -Container eingerichtet und verwaltet werden müssen.
- Externe Konnektivität: Jede Funktion macht automatisch einen eigenen eindeutigen REST-Endpunkt verfügbar und ermöglicht die Integration mit externen Anwendungen, Webdiensten und benutzerdefinierten Clients. Rufen Sie Ihre Funktionen von jedem System auf, das HTTP-Anforderungen unterstützt.
Wichtige Funktionen
- Einmal schreiben, überall ausführen: Erstellen Sie Funktionen, die identisch funktionieren, unabhängig davon, ob sie aus Pipelines, Notizbüchern, Aktivierregeln, Power BI- oder externen REST-Aufrufen aufgerufen werden.
- Rich Python-Ökosystem: Verwenden Sie jedes Paket von PyPI, um komplexe Logik zu erstellen – Pandas für Die Datenmanipulation, Anforderungen für API-Aufrufe oder spezielle Bibliotheken für Ihre Domäne
- Sicherer Datenzugriff: Herstellen einer Verbindung mit Fabric-Datenquellen (SQL-Datenbanken, Warehouses, Lakehouses, Gespiegelte Datenbanken) mit integrierter Authentifizierung und Sicherheit
- Entwickeln und Veröffentlichen von Workflows: Testen Sie Funktionen vor der Veröffentlichung, und stellen Sie sicher, dass Änderungen überprüft werden, bevor sie für Aufrufe verfügbar sind.
Integrationsfunktionen
Benutzerdatenfunktionen lassen sich nahtlos in Microsoft Fabric-Workloads und externe Systeme integrieren, sodass Sie umfassende Datenlösungen erstellen können.
Aufrufen von Fabric-Elementen
Rufen Sie Ihre Funktionen von jeder Fabric-Workload auf, um Geschäftslogik zu zentralisieren und Konsistenz zu gewährleisten:
- Data Pipelines – Ausführen von Funktionen als Pipelineaktivitäten für Datentransformationen, Validierungen oder Orchestrierungslogik
- Notizbücher – Aufrufen von Funktionen aus PySpark- oder Python-Notizbüchern für Data Science-Workflows und explorative Analysen
- Aktivatorregeln – Auslösen von Funktionen als Reaktion auf Echtzeitereignisse und Streamingdaten
- Power BI translytical task flows – Rufen Sie Funktionen direkt aus Power BI Berichten für interaktive Datenerfahrungen auf. Benutzerdatenfunktionen können Berichtskontext, z. B. den aktuellen Filter- und Auswahlkontext, in der Anforderungsnutzlast empfangen und die Ausführung von Aktionen und Szenarien zum Rückschreiben innerhalb eines Berichts aktivieren. Nach Abschluss eines Rückschreibvorgangs hängt die Datensicht im Bericht vom Speichermodus des Berichts und der Aktualisierungssemantik ab: Aktualisierte Werte werden sofort für Direct Lake- oder DirectQuery-Berichte angezeigt, oder nach einer automatischen Aktualisierung, die vom Aufgabenfluss für Importmodusberichte ausgelöst wird.
Herstellen einer Verbindung mit Fabric-Datenquellen
Ihre Funktionen können sicher auf Daten über die Fabric-Plattform zugreifen:
- SQL-Datenbanken – Lese- und Schreibvorgänge in Fabric SQL-Datenbanken
- Lagerhäuser – Lese- und Schreibvorgänge für strukturierte Daten
- Lakehouses - Lesen und Schreiben von Lakehouse-Dateien; Schreibgeschützter Zugriff auf SQL-Endpunkte
- Gespiegelte Datenbanken – Schreibgeschützter Zugriff auf gespiegelte Datenbankdaten
Das Zurückschreiben von Power BI Translytical Task Flows wird beim Aufrufen von Benutzerdatenfunktionen nativ unterstützt. Benutzerdatenfunktionen können Vorgänge zum Hinzufügen, Aktualisieren und Löschen für die Fabric SQL-Datenbank, das Fabric Data Warehouse und Lakehouse-Dateien ausführen, sodass sie der ideale Integrationspunkt für task-flow-gesteuerte Write-Back-Szenarien sind.
Erfahren Sie mehr über das Herstellen einer Verbindung mit Fabric-Datenquellen.
Aufruf von externen Anwendungen
Jede Benutzerdatenfunktion macht automatisch einen eigenen eindeutigen REST-Endpunkt für die Integration mit Systemen außerhalb von Fabric verfügbar:
- Webanwendungen – Aufrufen von Funktionen aus Web-Apps, mobilen Apps oder Einzelseitenanwendungen
- External Services – Integration in externe Systeme, Microservices oder Legacyanwendungen – z. B. Veröffentlichen von Nachrichten oder Aktualisierungen an Microsoft Teams oder Aufrufen externer REST-APIs als Teil von Aufgabenflussgesteuerten Aktionen
- API-Workflows – Verketten von Funktionen mit anderen APIs zum Erstellen komplexer Integrationsszenarien
- Benutzerdefinierte Clients – Aufrufen von einer beliebigen Programmiersprache oder Plattform, die HTTP-Anforderungen unterstützt
REST-Endpunkte für Benutzerdatenfunktionen unterstützen die Microsoft Entra ID-Authentifizierung und stellen sicheren Zugriff von externen Systemen sicher. Erfahren Sie, wie Sie Benutzerdatenfunktionen aus einer Python-Anwendung aufrufen.
Get started
Sind Sie bereit, Ihre erste Benutzerdatenfunktion zu erstellen? Wählen Sie Ihre bevorzugte Entwicklungsumgebung aus:
- Erstellen von Funktionen im Fabric-Portal – Schnellstarthandbuch mit browserbasierter Entwicklung und Tests
- Entwickeln mit Visual Studio Code – Vollständige IDE-Erfahrung mit lokalem Debuggen und Git-Integration
Verwandte Inhalte
- Programmiermodell für Benutzerdatenfunktionen – Deep dive into the Python SDK, decorators, and advanced features
- Aufrufen von Funktionen aus einer Python-Anwendung – Lernen Sie, ihre Funktionen über REST-Endpunkte von externen Systemen aufzurufen