映射数据流中的元函数

适用于:Azure 数据工厂 Azure Synapse Analytics

数据流在 Azure 数据工厂管道和 Azure Synapse Analytics 管道中都可用。 本文适用于映射数据流。 如果你不熟悉转换,请参阅介绍性文章: 使用映射数据流转换数据

本文提供有关 Azure 数据工厂和 Azure Synapse Analytics 在映射数据流中支持的元函数的详细信息。

元函数列表

元函数主要适用于数据流中的元数据。

元函数 任务
byItem 查找结构或结构数组中的子项。 如果有多个匹配项,则返回第一个匹配项。 如果没有匹配项,则返回一个 NULL 值。 返回的值必须由类型转换作之一(如 ? date? string)进行类型转换。 仅按其名称在设计时已知的列名地址。 不支持计算输入,但可以使用参数替换
byOrigin 在源流中按名称选择列值。 第二个参数是源流名称。 如果有多个匹配项,则返回第一个匹配项。 如果没有匹配项,则返回一个 NULL 值。 返回的值必须由一个类型转换函数(如 TO_DATETO_STRING)进行类型转换。 仅按其名称在设计时已知的列名地址。 不支持计算输入,但可以使用参数替换。
byOrigins 在流中按名称选择列的数组。 第二个参数是其源流。 如果有多个匹配项,则返回第一个匹配项。 如果没有匹配项,则返回一个 NULL 值。 返回的值必须由一个类型转换函数(如 TO_DATETO_STRING)进行类型转换。 仅按其名称在设计时已知的列名地址。 不支持计算输入,但可以使用参数替换。
byName 在流中按名称选择列值。 可以将可选流名称作为第二个参数传递。 如果有多个匹配项,则返回第一个匹配项。 如果没有匹配项,则返回一个 NULL 值。 返回的值必须由一个类型转换函数(如 TO_DATETO_STRING)进行类型转换。 仅按其名称在设计时已知的列名地址。 不支持计算输入,但可以使用参数替换。
byNames 在流中按名称选择列的数组。 可以将可选流名称作为第二个参数传递。 如果有多个匹配项,则返回第一个匹配项。 如果列没有匹配项,则整个输出是一个 NULL 值。 返回的值需要类型转换函数(如 toDatetoString)。 仅按其名称在设计时已知的列名地址。 不支持计算输入,但可以使用参数替换。
byPath 在流中按名称查找分层路径。 可以将可选流名称作为第二个参数传递。 如果未找到此类路径,则返回一个 NULL 值。 在设计时,仅通过其名称或点表示法路径来访问已知的列名称或路径。 不支持计算输入,但可以使用参数替换。
byPosition 按在流中的相对位置(基于 1)选择列值。 如果位置超出边界,则返回一个 NULL 值。 返回的值必须由一个类型转换函数(如 TO_DATETO_STRING)进行类型转换。 不支持计算输入,但可以使用参数替换。
hasPath 按名称检查流中是否存在某个分层路径。 可以将可选流名称作为第二个参数传递。 在设计时,仅通过其名称或点表示法路径来访问已知的列名称或路径。 不支持计算输入,但可以使用参数替换。
originColumns 获取在其中创建列的源流的所有输出列。 必须包含在另一个函数中。
hex 返回二进制值的十六进制字符串表示形式。
unhex 对字符串表示形式的二进制值进行反向十六进制转换。 您可以将 sha2md5 一起使用,以实现从字符串转换为二进制表示形式。