适用于:
Azure 数据工厂
Azure Synapse Analytics
数据流在 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 一起使用,以实现从字符串转换为二进制表示形式。 |