测试、发布与使用函数

本文为您介绍如何对函数进行测试。

前提条件

测试函数前,请确保您已创建并保存函数。详情请参见管理函数

使用限制

仅空间所有者及添加了空间管理员、开发、运维角色的RAM用户才可用测试函数功能。详情请参见添加空间成员并管理成员角色权限

步骤一:测试函数

  1. 进入数据服务页面。

    1. 登录DataWorks控制台,切换至目标地域后,单击左侧导航栏的数据开发与治理 > 数据服务,在下拉框中选择对应工作空间后单击进入数据服务

    2. 服务开发页面的函数列表中,双击开发中的函数名称。

  2. 在函数的编辑页面,单击上方的测试

    image

  3. 函数测试对话框中,输入参数,单击确认

    您可以在底部的运行结果查看运行状态。如果测试失败,请仔细查看错误提示,进行相应的修改并重新测试。

步骤二:发布函数

当函数的测试成功后,即可对该函数进行发布。

  1. 服务开发页面的函数列表中,双击测试成功的函数名称。

  2. 单击上方的提交按钮。

  3. 在函数编辑页面的右侧导航栏中,单击版本,找到状态为可发布的版本,单击操作列的发布

    说明

    发布成功后,您可以在函数编辑页面的右侧导航栏中,单击版本,找到发布记录,查看版本详情或进行回滚操作。

步骤三:使用函数

应用场景

  • 如果将函数设置为API的前置过滤器,当API被调用时,函数可以对API的请求参数进行预先处理。

  • 如果将函数设置为API的后置过滤器,当API被调用时,函数可以对API的返回结果进行二次加工和改造。

使用限制

  • 当使用函数作为API过滤器时,前置过滤器和后置过滤器的函数类型需要保持一致。即:均选择Aviator函数类型或Python函数类型。暂不支持对同一API的前置和后置过滤器选择不同的函数类型。

  • Python函数正在改造中,暂不支持新建、克隆和发布新的Python函数。

使用函数作为API的过滤器

  1. 服务开发页面,展开目标API所在的业务流程 > API

  2. 双击相应的API名称,打开该API的编辑页面。

  3. 单击页面右侧的过滤器

    根据需要勾选使用前置过滤器使用后置过滤器函数类型默认为Aviator函数,单击前置过滤器或后置过滤器右侧的下拉框选择目标函数(可添加多个函数,执行时会按照函数的添加顺序对API参数进行处理)。

    说明
    • 过滤器由一个或多个函数组成,允许您对API的请求参数进行预处理或对查询结果进行二次加工。

    • 若在下拉列表中无法获取目标函数名称,请检查目标函数是否已发布,或尝试新建函数并发布。详情请参见发布函数

  4. 单击API返回结果预览,查看使用过滤器后的结果是否符合预期。