你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

映射数据流中的元函数

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

提示

试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用

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

以下文章详细介绍了映射数据流中 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 一起用于从字符串转换为二进制表示法