使用MaxCompute Studio

以下以开发一个字符小写转换功能的UDF为例，为您介绍使用MaxCompute Studio开发并调用Java UDF的操作步骤如下。

1. 准备工作。

   使用MaxCompute Studio开发调试UDF时，您需要先安装MaxCompute Studio并连接MaxCompute项目，做好UDF开发前准备工作。操作详情请参见：

   1. 安装MaxCompute Studio

   2. 创建MaxCompute项目连接

   3. 创建MaxCompute Java Module

2. 编写UDF代码。

   1. 在 Project 区域，右键单击Module的源码目录（即 src > main > java ），选择 new > MaxCompute Java 。

   2. 在 Create new MaxCompute java class 对话框，单击 UDF 并填写 Name 后，按Enter键。

      

      Name 为创建的MaxCompute Java Class名称。如果还没有创建Package，在此处填写 packagename.classname ，会自动生成Package。本示例创建的Java Class名称为 Lower 。

   3. 在代码编写区域开始开发UDF代码。 UDF代码示例如下。

      package com.aliyun.odps.udf.example;
      import com.aliyun.odps.udf.UDF;
      public final class Lower extends UDF {
          public String evaluate(String s) {
              if (s == null) { 
                 return null; 
                 return s.toLowerCase();
      }

      说明

      如果需要本地调试Java UDF，请参见 开发和调试UDF 。

3. 上传并注册UDF。

   在UDF Java文件上单击右键，选择 Deploy to server... ，在 Package a jar, submit resource and register function 对话框中配置如下参数后，单击 OK 。

   • MaxCompute project ：UDF所在的MaxCompute项目名称。由于UDF本身是在连接的MaxCompute项目下编写的，此处保持默认值即可。

   • Resource file ：UDF依赖的资源文件路径。此处保持默认值即可。

   • Resource name ：UDF依赖的资源。此处保持默认值即可。

   • Function name ：注册的函数名称，即后续SQL中调用的UDF名称。例如 Lower_test 。

4. 调试UDF。

   在左侧导航栏单击 Project Explore ，在目标MaxCompute项目上单击右键，选择 Open Console 并在Console区域输入调用UDF的SQL语句，按Enter键运行即可。 SQL语句示例如下。

   select lower_test('ABC');

   返回结果如下。

   +-----+
   | _c0 |
   +-----+
   | abc |
   +-----+

使用DataWorks

1. 准备工作。

   使用DataWorks开发调试UDF时，您需要先开通DataWorks并绑定MaxCompute项目，做好UDF开发前准备工作。操作详情请参见 使用DataWorks连接 。

2. 编写UDF代码。

   您可以在任意Java开发工具中开发UDF代码并打包为一个JAR包。您可以使用以下UDF代码示例。

   package com.aliyun.odps.udf.example;
   import com.aliyun.odps.udf.UDF;
   public final class Lower extends UDF {
       public String evaluate(String s) {
           if (s == null) { 
              return null; 
              return s.toLowerCase();
   }

3. 上传并注册UDF。

   您可以将已打包好的代码包通过DataWorks上传并完成UDF注册，操作详情请参见：

   1. 创建并使用MaxCompute资源

   2. 创建并使用MaxCompute函数

4. 调试UDF。

   注册完成UDF后，您可以创建一个ODPS SQL节点，在节点中编写并创建SQL命令来调试UDF。创建ODPS SQL节点的操作请参见 创建ODPS SQL节点 ，调试命令示例如下。

   select lower_test('ABC');

使用odpscmd

1. 准备工作。

   使用odpscmd开发调试UDF时，您需要先下载安装odpscmd工具，并配置config文件连接MaxCompute项目，做好UDF开发前准备工作。操作详情请参见 使用客户端（odpscmd）连接 。

2. 编写UDF代码。

   您可以在任意Java开发工具中开发UDF代码并打包为一个JAR包。您可以使用以下UDF代码示例。

   package com.aliyun.odps.udf.example;
   import com.aliyun.odps.udf.UDF;
   public final class Lower extends UDF {
       public String evaluate(String s) {
           if (s == null) { 
              return null; 
              return s.toLowerCase();
   }

3. 上传并注册UDF。

   您可以将已打包好的代码包通过odpscmd上传并完成UDF注册，操作详情请参见：

   1. ADD JAR

   2. CREATE FUNCTION

4. 调试UDF。

   注册完成UDF后，您可以编写并创建SQL命令来调试UDF。调试命令示例如下。

   select lower_test('ABC');