Benutzerdefinierte Funktionen im Zuordnungsdatenfluss

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

Datenflüsse sind sowohl in Azure Data Factory als auch in Azure Synapse-Pipelines verfügbar. Dieser Artikel gilt für Zuordnungsdatenflüsse. Wenn Sie noch nicht mit Transformationen arbeiten, lesen Sie den Einführungsartikel Transformieren von Daten mit einem Zuordnungsdatenfluss.

Eine benutzerdefinierte Funktion ist ein benutzerdefinierter Ausdruck, den Sie definieren können, um Logik über mehrere Zuordnungsdatenflüsse hinweg wiederverwenden zu können. Benutzerdefinierte Funktionen befinden sich in einer Sammlung, die als Datenflussbibliothek bezeichnet wird und das einfache Gruppieren allgemeiner Sätze benutzerdefinierter Funktionen ermöglicht.

Immer dann, wenn Sie die gleiche Logik in einem Ausdruck in mehreren Zuordnungsdatenflüssen erstellen, ist dies eine gute Möglichkeit, dies in eine benutzerdefinierte Funktion umzuwandeln.

Erste Schritte

Um mit benutzerdefinierten Funktionen zu beginnen, müssen Sie zuerst eine Datenflussbibliothek erstellen. Navigieren Sie zur Verwaltungsseite, und suchen Sie dann im Abschnitt "Autor" nach Datenflussbibliotheken.

Datenflussbibliothek

Hier können Sie auf die Schaltfläche "+Neu" klicken, um eine neue Datenflussbibliothek zu erstellen. Geben Sie den Namen und die Beschreibung ein; dann können Sie Ihre benutzerdefinierte Funktion erstellen.

Neue benutzerdefinierte Funktionen

Wenn Sie eine benutzerdefinierte Funktion erstellen möchten, klicken Sie in der Datenflussbibliothek, in der Sie die Funktion erstellen möchten, auf die Schaltfläche "+Neu".

Geben Sie den Namen Ihrer benutzerdefinierten Funktion ein.

Hinweis

Sie können den Namen eines vorhandenen Zuordnungsdatenflussausdrucks nicht verwenden. Eine Liste der aktuellen Zuordnungsdatenflussausdrücke finden Sie unter Datentransformationsausdrücke im Zuordnungsdatenfluss | Microsoft-Dokumentation

Benutzerdefinierte Funktionen können null oder mehr Argumente aufweisen. Mithilfe von Argumenten können Sie Werte übergeben, wenn Ihre Funktion aufgerufen wird und auf diese Argumente in der Ausdruckslogik verweist. Argumente werden automatisch i1, i2 usw. benannt, und Sie können den Datentyp des Arguments aus der Dropdownliste auswählen.

Die Logik der Funktion wird im Textkörper der benutzerdefinierten Funktion angegeben. Der Editor bietet die Oberfläche des gesamten Ausdrucks-Generators | Microsoft-Dokumentation und ermöglicht es Ihnen, auf ihre erstellten Argumente und alle Datentransformationsausdrücke im Zuordnungsdatenfluss | Microsoft-Dokumentation zu verweisen.

Hinweis

Eine benutzerdefinierte Funktion kann nicht auf eine andere benutzerdefinierte Funktion verweisen.

Verwenden einer benutzerdefinierten Funktion im Ausdrucks-Generator

Benutzerdefinierte Funktionen werden im Zuordnungsdatenfluss-Ausdrucks-Generator unter den Funktionen der Datenflussbibliothek angezeigt. Von hier aus können Sie Ihre benutzerdefinierten erstellten Funktionen verwenden und ggf. entsprechende Argumente, die Sie definiert haben, übergeben.