Freigeben über

Dienstdetails und Einschränkungen von Fabric User Data Functions

In diesem Artikel werden die Dienstdetails und aktuellen Einschränkungen von Fabric User Data Functions beschrieben.

Kapazitätsberichte

Die Nutzung von Fabric User Data Functions wird in der Anwendung „Fabric Capacity Metrics“ gemeldet. Die Kapazitätsberichte berücksichtigen die Erstellung, Veröffentlichung, Ausführung und Speicherung von Fabric User Data Functions. Weitere Informationen zu den in der Fabric-Kapazitätsmetriken-App gemeldeten Zählern finden Sie unter Fabric-Vorgänge.

Netzwerksicherheitsanforderungen

Damit Fabric-Benutzerdatenfunktionen ordnungsgemäß funktionieren, muss Ihr Netzwerk Anforderungen und Dateiuploads auf Fabric-Endpunkte zulassen. Wenn diese Anforderung nicht vorhanden ist, können die folgenden Anforderungen zu einem CORS-Fehler (Cross-Origin Resource Sharing) führen: Veröffentlichungsfunktionen und Hochladen von benutzerdefinierten Bibliotheken.

Einschränkungen

Im Folgenden sind die aktuellen Einschränkungen für Fabric-Benutzerdatenfunktionen aufgeführt:

  • Funktionen können nur vom Besitzer bearbeitet werden: Derzeit kann nur der Besitzer des Elements "Benutzerdatenfunktionen" den Funktionscode ändern und veröffentlichen. Anweisungen zum Übertragen des Besitzes von Fabric-Elementen finden Sie unter Übernehmen des Besitzes von Fabric-Elementen.

  • Funktionen veröffentlichen den Cooldownzeitraum: Nach dem Veröffentlichen Ihrer Funktionen müssen Sie mindestens 2 Minuten warten, bevor Sie sie erneut veröffentlichen. Dieser Cooldownzeitraum gilt beim Veröffentlichen aus dem Browserportal "Funktionen", der Visual Studio Code-Erweiterung "User Data Functions", der GIT-Importaktion oder mithilfe von Bereitstellungspipelines.

  • "Verbindungen verwalten" unterstützt nur Fabric-Datenquellen: Das Feature "Verbindungen verwalten" unterstützt derzeit nur die Verbindung mit Fabric-nativen Datenquellen. Weitere Informationen finden Sie unter "Herstellen einer Verbindung mit Datenquellen".

  • "Verbindungen verwalten" kann keine Verbindung mit Ressourcen herstellen, die Sonderzeichen in ihren Namen enthalten: Fabric-Ressourcen, z. B. Datenbanken, die Sonderzeichen in ihren Namen enthalten, z. B. geschweifte Klammern oder Nicht-ASCII-Zeichen, sind nicht mit der Benutzeroberfläche "Verbindungen verwalten" in Benutzerdatenfunktionen kompatibel. Weitere Informationen finden Sie unter "Herstellen einer Verbindung mit Datenquellen".

  • Regionale Einschränkungen für Benutzerdatenfunktionen: Benutzerdatenfunktionen sind in einer Teilmenge von Fabric-Regionen nicht verfügbar. Eine aktualisierte Liste der Regionen, in denen Fabric-Benutzerdatenfunktionen verfügbar sind, finden Sie unter Fabric-Regionsverfügbarkeit. Wenn sich Ihr Basismandant in einer nicht unterstützten Region befindet, können Sie eine Kapazität in einer unterstützten Region erstellen, um User Data Functions zu verwenden. Weitere Informationen finden Sie unter Verwalten der Fabric-Kapazität.

  • Regionale Einschränkungen für die Testfunktion im Entwicklungsmodus: Die Testfunktionalität im Entwicklungsmodus ist in den folgenden Fabric-Regionen nicht verfügbar: Brasilien Süd, Israel Central und Mexiko Central. Sie können Ihre Funktionen weiterhin testen, indem Sie sie veröffentlichen und ausführen, oder indem Sie die VS Code-Erweiterung verwenden, um sie lokal zu testen.

  • Reservierte Python-Schlüsselwörter in Fabric-Benutzerdatenfunktionen: Zusätzlich zu reservierten Schlüsselwörtern aus der Python-Sprache verwendet Fabric User Data Functions auch die folgenden Schlüsselwörter: req, , contextund reqInvocationId. Reservierte Schlüsselwörter können nicht als Parameternamen oder Funktionsnamen verwendet werden.

  • Parameter mit Standardwerten oder optionalen Werten werden nicht unterstützt: Derzeit sind alle Funktionsparameter beim Aufrufen erforderlich. Die Bereitstellung von Standardwerten in der Funktionsargumentdefinition wird derzeit nicht unterstützt. Die folgende Funktion löst z. B. einen Syntaxfehler aus:

        # The default value for the argument called 'name' is not supported and treated like a syntax error.
    @udf.function()
    def goodbye_fabric(name: str = "N/A") -> str:
        return f"Goodbye, {name}."

  • Dienstprinzipalunterstützung: Der Zugriff auf Fabric-Elemente oder Datenquellen mit einem Dienstprinzipal wird derzeit nicht unterstützt. Beispielsweise können Sie Fabric-Benutzerdatenfunktionen nicht als verwaltete Identität oder Arbeitsbereichsidentität verwenden.

Diensteinschränkungen

In der folgenden Liste werden die Diensteinschränkungen für User Data Functions-Elemente beschrieben.

Grenze Wert BESCHREIBUNG
Nutzdatenlänge der Anforderung 4 MB Die maximale Größe aller Anforderungsparameter zusammen.
Timeout für die Anforderungsausführung 240 Sekunden Die maximale Zeit, die eine Funktion ausgeführt werden kann.
Beschränkung der Antwortgröße 30 MB Die maximale Größe des Rückgabewerts einer Funktion.
Protokollaufbewahrung 30 Tage Die Anzahl der Tage, die historische Aufrufprotokolle standardmäßig aufbewahrt werden.
Maximale Größe der privaten Bibliothek 28,6 MB Die maximale Größe einer .whl-Datei, die in die Bibliotheksverwaltung als private Bibliothek hochgeladen wird
Testen im Portaltimeout 15 Minuten Der Zeitraum, für den die Testsitzung aktiv ist, bis eine neue Anforderung verarbeitet wird. Die Sitzung wird um 15 Minuten verlängert, wenn eine neue Anforderung innerhalb des Timeoutzeitraums empfangen wird.
Python-Version (Run-Funktion) 3.11 Die Python-Version, die für veröffentlichte Funktionen im Modus "Nur Ausführen" verwendet wird.
Python-Version (Testfunktion) 3.12 Die Python-Version, die für die Testfunktion im Entwicklungsmodus verwendet wird.

Nächste Schritte

  • Last updated on