Метафункции в картировании потоков данных

ПРИМЕНИМО К: Фабрика данных Azure Azure Synapse Analytics

Совет

фабрика Data в Microsoft Fabric — это следующее поколение Фабрика данных Azure с более простой архитектурой, встроенным ИИ и новыми функциями. Если вы не знакомы с интеграцией данных, начните с Fabric фабрики данных. Существующие рабочие нагрузки ADF могут обновляться до Fabric для доступа к новым возможностям в области обработки и анализа данных, аналитики в режиме реального времени и отчетов.

Потоки данных доступны как в конвейерах Фабрика данных Azure, так и в Azure Synapse Analytics конвейерах. Эта статья относится к потокам данных для сопоставления. Если вы не знакомы с преобразованиями, ознакомьтесь с вводной статьей "Преобразование данных с помощью потоков данных сопоставления".

В этой статье содержатся сведения о метафункциях, поддерживаемых Фабрика данных Azure и Azure Synapse Analytics в потоках данных сопоставления.

Список метафункций

Метафункционы в основном работают над метаданными в потоке данных.

Метафункция Задача
byItem Находит подэлемент в структуре или массиве структур. Если найдено несколько совпадений, то возвращается первое совпадение. Если совпадений нет, возвращается значение NULL. Возвращаемое значение должно быть преобразовано одним из действий преобразования типов (например ? date , и ? string). Имена столбцов адресов, известные во время разработки только по их именам. Вычисляемые входные данные не поддерживаются, но можно использовать подстановки параметров.
byOrigin Выбирает значение столбца по имени в исходном потоке. Вторым аргументом является имя исходного потока. Если найдено несколько совпадений, то возвращается первое совпадение. Если совпадений нет, возвращается значение NULL. Возвращаемое значение должно быть преобразовано одним из функций преобразования типов (например TO_DATE , и TO_STRING). Имена столбцов адресов, известные во время разработки только по их именам. Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
byOrigins Выбирает массив столбцов по имени в потоке. Второй аргумент указывает исходный поток. Если найдено несколько совпадений, то возвращается первое совпадение. Если совпадений нет, возвращается значение NULL. Возвращаемое значение должно быть преобразовано одним из функций преобразования типов (например TO_DATE , и TO_STRING). Имена столбцов адресов, известные во время разработки только по их именам. Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
byName Выбирает значение столбца по имени в потоке. В качестве второго аргумента вы можете передать необязательное имя потока. Если найдено несколько совпадений, то возвращается первое совпадение. Если совпадений нет, возвращается значение NULL. Возвращаемое значение должно быть преобразовано одним из функций преобразования типов (например TO_DATE , и TO_STRING). Имена столбцов адресов, известные во время разработки только по их именам. Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
byNames Выбирает массив столбцов по имени в потоке. В качестве второго аргумента вы можете передать необязательное имя потока. Если найдено несколько совпадений, то возвращается первое совпадение. Если для столбца нет совпадений, все выходные данные являются значением NULL . Возвращаемое значение требует функции преобразования типов (например toDate , и toString). Имена столбцов адресов, известные во время разработки только по их именам. Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
byPath Находит иерархический путь по имени в потоке. В качестве второго аргумента вы можете передать необязательное имя потока. Если такой путь не найден, возвращает значение NULL. Указывайте имена столбцов или пути, известные во время разработки, только по их именам или по путям в точечной нотации. Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
byPosition Выбирает значение столбца по его относительной позиции (начиная с 1) в потоке. Если позиция выходит за границы допустимого диапазона, возвращает значение NULL. Возвращаемое значение должно быть преобразовано одним из функций преобразования типов (например TO_DATE , и TO_STRING). Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
hasPath Проверяет, существует ли определенный иерархический путь, по имени в потоке. В качестве второго аргумента вы можете передать необязательное имя потока. Указывайте имена столбцов или пути, известные во время разработки, только по их именам или по путям в точечной нотации. Вычисляемые входные данные не поддерживаются, но можно использовать замены параметров.
originColumns Возвращает все выходные столбцы для исходного потока, в котором они были созданы. Необходимо обернуть в другую функцию.
hex Возвращает шестнадцатеричное строковое представление двоичного значения.
unhex Преобразовывает шестнадцатеричное строковое представление в двоичное значение. Его можно использовать вместе с sha2 и md5 для преобразования из строки в двоичное представление.