Freigeben über


Metafunktionen beim Zuordnen von Datenflüssen

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. In Microsoft Fabric können Sie alle erforderlichen Aufgaben ausführen, 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-Pipelines als auch in Azure Synapse Analytics-Pipelines verfügbar. Dieser Artikel gilt für Zuordnungsdatenflüsse. Wenn Sie mit Transformationen noch nicht fertig sind, lesen Sie den einführungsartikel Transformieren von Daten mithilfe von Zuordnungsdatenflüssen.

Dieser Artikel enthält Details zu Metafunktionen, die von Azure Data Factory und Azure Synapse Analytics bei der Zuordnung von Datenflüssen unterstützt werden.

Liste der Metafunktionen

Metafunktionen funktionieren in erster Linie auf Metadaten in Ihrem Datenfluss.

Metafunktion Aufgabe
byItem Sucht ein Unterelement innerhalb einer Struktur oder eines Arrays einer Struktur. Wenn mehrere Übereinstimmungen vorhanden sind, wird die erste Übereinstimmung zurückgegeben. Wenn keine Übereinstimmungen vorhanden sind, wird ein NULL Wert zurückgegeben. Für den zurückgegebenen Wert muss eine Typkonvertierung anhand einer der Typkonvertierungsaktionen (wie ? date und ? string) erfolgen. Adressspaltennamen, die zur Entwurfszeit nur namentlich bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
byOrigin Wählt einen Spaltenwert nach Name im Ursprungsstream aus. Das zweite Argument ist der Name des Ursprungsstreams. Wenn mehrere Übereinstimmungen vorhanden sind, wird die erste Übereinstimmung zurückgegeben. Wenn keine Übereinstimmungen vorhanden sind, wird ein NULL Wert zurückgegeben. Der zurückgegebene Wert muss von einer der Typkonvertierungsfunktionen (z. B. TO_DATE und TO_STRING) konvertiert werden. Adressspaltennamen, die zur Entwurfszeit nur namentlich bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
byOrigins Wählt ein Array von Spalten nach Name im Stream aus. Das zweite Argument ist der Stream, aus dem es stammt. Wenn mehrere Übereinstimmungen vorhanden sind, wird die erste Übereinstimmung zurückgegeben. Wenn keine Übereinstimmungen vorhanden sind, wird ein NULL Wert zurückgegeben. Der zurückgegebene Wert muss von einer der Typkonvertierungsfunktionen (wie zum Beispiel TO_DATE und TO_STRING) konvertiert werden. Adressspaltennamen, die zur Entwurfszeit nur namentlich bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
byName Wählt einen Spaltenwert nach Name im Stream aus. Sie können einen optionalen Streamnamen als zweites Argument übergeben. Wenn mehrere Übereinstimmungen vorhanden sind, wird die erste Übereinstimmung zurückgegeben. Wenn keine Übereinstimmungen vorhanden sind, wird ein NULL Wert zurückgegeben. Der zurückgegebene Wert muss von einer der Typkonvertierungsfunktionen (wie TO_DATE und TO_STRING) konvertiert werden. Adressspaltennamen, die zur Entwurfszeit nur namentlich bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
byNames Wählt ein Array von Spalten nach Name im Stream aus. Sie können einen optionalen Streamnamen als zweites Argument übergeben. Wenn mehrere Übereinstimmungen vorhanden sind, wird die erste Übereinstimmung zurückgegeben. Wenn keine Übereinstimmungen für eine Spalte vorhanden sind, ist die gesamte Ausgabe ein NULL Wert. Der zurückgegebene Wert erfordert eine Typkonvertierungsfunktion, wie beispielsweise toDate und toString. Adressspaltennamen, die zur Entwurfszeit nur namentlich bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
byPath Sucht einen hierarchischen Pfad anhand des Namens im Stream. Sie können einen optionalen Streamnamen als zweites Argument übergeben. Wenn kein solcher Pfad gefunden wird, wird ein NULL Wert zurückgegeben. Behandeln Sie Spaltennamen/-pfade, die zur Entwurfszeit nur anhand ihrer Namen oder Punktnotationspfade bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
byPosition Wählt einen Spaltenwert anhand seiner relativen Position (1 basierend) im Datenstrom aus. Wenn die Position außerhalb der Grenzen liegt, wird ein NULL Wert zurückgegeben. Der zurückgegebene Wert muss von einer der Typkonvertierungsfunktionen (wie TO_DATE und TO_STRING) konvertiert werden. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
hasPath Überprüft, ob ein bestimmter hierarchischer Pfad nach dem Namen im Stream vorhanden ist. Sie können einen optionalen Streamnamen als zweites Argument übergeben. Behandeln Sie Spaltennamen/-pfade, die zur Entwurfszeit nur anhand ihrer Namen oder Punktnotationspfade bekannt sind. Berechnete Eingaben werden nicht unterstützt, Aber Sie können Parameterersetzungen verwenden.
originColumns Ruft alle Ausgabespalten für einen Ursprungsdatenstrom ab, in dem Spalten erstellt wurden. Muss in eine andere Funktion eingeschlossen werden.
hex Gibt eine Hexaxzeichenfolgendarstellung eines Binärwerts zurück.
unhex Diese Funktion konvertiert die Zeichenfolgendarstellung eines Hexadezimalwerts in einen Binärwert. Sie können es mit sha2 und md5 zum Konvertieren von Zeichenfolge in binäre Darstellung verwenden.