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

映射数据流中的用户定义的函数

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

提示

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

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

用户定义的函数是一个自定义表达式,可以对其进行定义,以便能够在多个映射数据流之间重用逻辑。 用户定义的函数存在于一个称为数据流库的集合中,以便能够轻松地对常用自定义函数集进行分组。

每当发现自己在跨多个映射数据流的表达式中构建相同的逻辑时,就可以将其转换为用户定义的函数。

入门

若要开始使用用户定义的函数,必须先创建一个数据流库。 请导航到管理页,然后在“创作”部分下找到数据流库。

显示 ADF 管理窗格和数据流库的屏幕截图。

数据流库

在这里,可以单击“+ 新建”按钮创建新的数据流库。 填写名称和说明,然后即可创建用户定义的函数。 显示数据流库创建窗格的屏幕截图。

新建用户定义的函数

若要创建用户定义的函数,请在要在其中创建函数的数据流库中单击“+ 新建”按钮。 显示 UDF 新函数按钮的屏幕截图。

填写用户定义的函数的名称。

注意

不能使用现有映射数据流表达式的名称。 有关当前映射数据流表达式的列表,请参阅映射数据流中的数据转换表达式 | Microsoft Docs

显示 UDF 新函数创建窗格的屏幕截图。

用户定义的函数可以有零个或多个参数。 参数使你能够在调用函数时传入值,并可以在表达式逻辑中引用这些参数。 参数自动从 i1、i2 等命名,可以从下拉列表中选择参数的数据类型。

用户定义的函数的主体是指定函数逻辑的位置。 编辑器提供完整的表达式生成器 | Microsoft Docs 体验,并允许引用创建的参数和任何映射数据流中的数据转换表达式 | Microsoft Docs

注意

用户定义的函数不能引用另一个用户定义的函数。

在表达式生成器中使用用户定义的函数

用户定义的函数将出现在数据流库函数下的映射数据流表达式生成器中。 在此处,可以使用自定义创建的函数并传入定义的适当参数(如果有)。

显示映射数据流表达式生成器中的数据流库的屏幕截图。