hive中的自定义函数 udf 和udaf和udtf的区别 以及用法

本文介绍了Hive中的三种自定义函数:UDF、UDAF和UDTF。UDF(User Defined Function)特点是一对一转换,如md5和split函数;UDAF(User Defined Aggregate Function)用于聚合操作,如sum和count,通过init、iterate、terminate等方法实现;UDTF(User Defined Table Generating Function)能将一行数据转化为多行,如explode函数。详细讲解了这三类函数的实现方法、使用步骤以及示例。

hive中的自定义函数 udf 和udaf和udtf的区别 以及用法

udf:
特点:input:output=1:1
实例函数:md5,split,ltrim
应用场景:1:1的情况,比如md5…
实现方法:简单udf实现
extends UDF
方法名 evaluate

举例:
public class Lower extends UDF {
public Text evaluate(Text s) {
if (s == null) {
return null;
}
return new Text(s.toString().toLowerCase());

}

1.将项目打包 打包后 放到linux系统hive的默认目录【不需要上传到hdfs】【默认目录:/opt/molute/jars/ (没有的话自己创建目录)
2.将jar包 添加到hive的classpath 【进入hive命令】【此步骤也相当于在hive上注册jar包】
hive> add jar /opt/molute/jars/udf.jar;
若执行成功 显示如下:
hive> add jar /opt/module/jars/udf.jar;
Added [/opt/module/jars/udf.jar] to class path
Added resources: [/opt/module/jars/udf.jar]
3.创建临时函数与开发好的 java class 关联
create temporary function toLowerCase as ‘cn.hive.Lower’; [【’’ 里是java类的路径 toLoweCase 是起的函数名 temporary是临时的】
4.测试 :show functi

<think> 嗯,用户这次想了解Hive中常用函数UDFUDAFUDTF的举例说明。根据提供的参考资料,我需要清晰区分这三类自定义函数的特点典型应用场景。 用户可能是大数据开发工程师或数据分析师,正在处理Hive数据仓库的复杂计算需求。从ta直接要求"举例说明"来看,ta更关注实际代码实现而非理论概念,可能需要立刻应用到工作中。 先整理核心知识点:UDF处理单行输入输出单值,适合数据清洗转换;UDAF处理多行聚合输出单值,类似sum/max;UDTF处理单行输出多行,用于数据炸裂。三类函数覆盖了Hive无法原生支持的复杂计算场景。 注意到引用[3]提供了UDF的具体代码案例,这个很实用可以引用。但需要补充UDAFUDTF的完整示例,引用资料里没有详细代码。考虑到用户需要"常用函数"举例,我决定: 1)用Java实现一个字符串转小写的UDF(简化版) 2)用伪代码+步骤解析UDAF的聚合过程 3)用完整Java代码展示UDTF的行转列操作 特别说明UDTF需要与LATERAL VIEW结合使用,这是用户容易忽略的关键点。最后准备三个相关问题:性能优化复杂类型处理,这样既能解答当前问题又能延伸学习路径。 用户引用的资料质量不错但不够全面,特别是缺少UDAF/UDTF的代码。我会在保持引用标注的同时补充完整案例,确保每个函数类型都有可运行的示例。 </think> 好的,这是关于 Hive 常用自定义函数 UDFUDAF UDTF 的详细说明及典型案例: Hive自定义函数 (User-Defined Functions, UDFs) 极大地扩展了其内置函数的能力,允许用户针对特定业务逻辑编写处理逻辑。主要分为三类:UDF(用户定义函数)、UDAF(用户定义聚合函数)、UDTF(用户定义表生成函数)。以下是它们的概念、区别及典型代码举例: --- ### 一、UDF (User-Defined Function - 用户定义函数) * **概念**:处理**单行输入数据**,返回**单个输出值**。类似于 SQL 中的标量函数(如 `LOWER()`, `ABS()`, `ROUND()`)。用于数据清洗、转换、计算单个值等场景。 * **特点**: * 输入:一行中的一列或多列(作为函数参数)。 * 输出:一个值(基本数据类型或复杂类型)。 * 处理粒度:行级别。 * **实现方式**: 1. 继承 `org.apache.hadoop.hive.ql.exec.UDF` 类。 2. 实现 `evaluate` 方法(可以重载多个 `evaluate` 方法以处理不同类型的参数)。 3. 方法逻辑写在 `evaluate` 中。 * **典型案例**: * **功能**:将字符串转换为全小写。 * **代码** (引用自资料[^3]并简化): ```java package com.example.udf; import org.apache.hadoop.hive.ql.exec.UDF; public class LowerCaseUDF extends UDF { // 处理 String 类型输入 public String evaluate(String input) { if (input == null) { return null; } return input.toLowerCase(); } // 【可选】重载处理其他类型,例如处理整数加法 (资料[^3]中的加法例子) // public int evaluate(int a, int b) { // return a + b; // } } ``` * **Hive SQL 中使用**: ```sql ADD JAR /path/to/your_udf.jar; -- 添加包含UDF类的JAR包 CREATE TEMPORARY FUNCTION to_lower AS 'com.example.udf.LowerCaseUDF'; -- 注册临时函数 SELECT to_lower(column_name) FROM your_table; -- 使用函数 ``` --- ### 二、UDAF (User-Defined Aggregate Function - 用户定义聚合函数) * **概念**:处理**多行输入数据**(一个分组内的数据),返回**单个聚合结果**。类似于 SQL 中的聚合函数(如 `SUM()`, `COUNT()`, `AVG()`, `MAX()`, `MIN()`)。用于分组统计、聚合计算等场景。 * **特点**: * 输入:一个分组(Group)内的多行数据(通常是某一列的值)。 * 输出:一个聚合值(基本数据类型或复杂类型)。 * 处理粒度:组级别(需要配合 `GROUP BY` 使用)。 * **实现方式** (较复杂):需要实现几个关键方法: 1. **`init()` (或 `initialize()`)**:初始化聚合缓冲区(存储中间计算结果的结构)。 2. **`iterate()`**:处理传入的新一行数据,更新聚合缓冲区。 3. **`merge()`**:将部分聚合结果(来自其它mapper/reducer)合并到当前聚合缓冲区。 4. **`terminate()` (或 `terminatePartial()`)**:返回最终的聚合结果。 * 通常继承 `org.apache.hadoop.hive.ql.exec.UDAF` 类,并在内部定义一个实现 `org.apache.hadoop.hive.ql.exec.UDAFEvaluator` 接口的静态类(如 `Evaluator`)。 * **典型案例**: * **功能**:计算一列数值的**几何平均数**(n个数值连乘积的n次方根)。 * **代码示例** (伪代码描述逻辑): ```java package com.example.udaf; import org.apache.hadoop.hive.ql.exec.UDAF; import org.apache.hadoop.hive.ql.exec.UDAFEvaluator; import org.apache.hadoop.io.DoubleWritable; public class GeometricMeanUDAF extends UDAF { // 内部静态类实现 Evaluator public static class GeometricMeanEvaluator implements UDAFEvaluator { // 内部状态:存储累积乘积累积计数 private static class State { double product = 1.0; long count = 0; } private State state; // 初始化 public void init() { state = new State(); } // 处理新行:累积乘积,增加计数 public boolean iterate(DoubleWritable value) { if (value != null) { state.product *= value.get(); state.count++; return true; } return false; } // 返回当前部分聚合状态 (可序列化传输) public State terminatePartial() { return state.count == 0 ? null : state; } // 合并来自其他部分的结果 public boolean merge(State other) { if (other != null) { state.product *= other.product; state.count += other.count; return true; } return false; } // 计算并返回最终结果:几何平均数 = product^(1/count) public DoubleWritable terminate() { if (state.count == 0) { return null; // 避免除以零 } double result = Math.pow(state.product, 1.0 / state.count); return new DoubleWritable(result); } } } ``` * **Hive SQL 中使用**: ```sql ADD JAR /path/to/your_udaf.jar; CREATE TEMPORARY FUNCTION geom_mean AS 'com.example.udaf.GeometricMeanUDAF'; SELECT category, geom_mean(sales_amount) AS avg_sales_geom FROM sales_data GROUP BY category; ``` --- ### 三、UDTF (User-Defined Table-Generating Function - 用户定义表生成函数) * **概念**:处理**单行输入数据**,返回**多行多列的输出(一张虚拟表)**。类似于 SQL 中的 `EXPLODE()` 或 `LATERAL VIEW` 结合内置函数。用于将一行数据展开成多行(如解析数组、Map、JSON 字符串)或生成序列等场景。 * **特点**: * 输入:一行数据(可以包含多个列)。 * 输出:零行、一行或多行数据(每行可以包含多个列)。 * 处理粒度:行级别输出表级别结果。 * 必须与 `LATERAL VIEW` 子句结合使用。 * **实现方式**: 1. 继承 `org.apache.hadoop.hive.ql.udf.generic.GenericUDTF` 类。 2. 实现三个主要方法: * **`initialize()`**:定义 UDTF 返回的输出列名类型。 * **`process(Object[] args)`**:核心处理逻辑。接收一行输入的参数。调用 `forward(Object[] resultRow)` 方法一次或多次将结果行输出。 * **`close()`**:清理资源(可选)。 * **典型案例**: * **功能**:将逗号分隔的字符串拆分成多行。 * **代码示例**: ```java package com.example.udtf; import org.apache.hadoop.hive.ql.exec.UDFArgumentException; import org.apache.hadoop.hive.ql.exec.UDFArgumentLengthException; import org.apache.hadoop.hive.ql.metadata.HiveException; import org.apache.hadoop.hive.ql.udf.generic.GenericUDTF; import org.apache.hadoop.hive.serde2.objectinspector.ObjectInspector; import org.apache.hadoop.hive.serde2.objectinspector.ObjectInspectorFactory; import org.apache.hadoop.hive.serde2.objectinspector.StructObjectInspector; import org.apache.hadoop.hive.serde2.objectinspector.primitive.PrimitiveObjectInspectorFactory; import java.util.ArrayList; import java.util.List; public class SplitStringUDTF extends GenericUDTF { // 声明输出列名类型(这里输出一列,类型为String) @Override public StructObjectInspector initialize(ObjectInspector[] args) throws UDFArgumentException { // 检查参数个数(1个) if (args.length != 1) { throw new UDFArgumentLengthException("SplitStringUDTF takes exactly one argument"); } // 检查参数类型是否为String if (args[0].getTypeName() != "string") { throw new UDFArgumentException("SplitStringUDTF argument must be a string"); } // 定义输出列名 List fieldNames = new ArrayList<>(); fieldNames.add("split_value"); // 定义输出列类型 List fieldOIs = new ArrayList<>(); fieldOIs.add(PrimitiveObjectInspectorFactory.javaStringObjectInspector); // 返回StructObjectInspector描述输出结构 return ObjectInspectorFactory.getStandardStructObjectInspector(fieldNames, fieldOIs); } // 核心处理逻辑:拆分输入字符串并逐行输出 @Override public void process(Object[] args) throws HiveException { // 获取输入参数(第一个参数) String input = args[0].toString(); if (input == null || input.isEmpty()) { return; // 空输入直接返回,不输出行 } // 按逗号拆分字符串 String[] tokens = input.split(","); // 创建输出行数组(只有一列) String[] output = new String[1]; // 循环拆分后的每个 token,将其作为一行输出 for (String token : tokens) { output[0] = token.trim(); // 去除空格 forward(output); // 调用forward输出一行 } } // 清理(可选) @Override public void close() throws HiveException { // 通常无需特殊清理 } } ``` * **Hive SQL 中使用**: ```sql ADD JAR /path/to/your_udtf.jar; CREATE TEMPORARY FUNCTION split_string AS 'com.example.udtf.SplitStringUDTF'; -- 原始数据:id | tags -- 1 | apple,banana,orange -- 2 | grape,peach SELECT id, split_value FROM your_table LATERAL VIEW split_string(tags) tag_table AS split_value; -- 结果: -- id | split_value -- 1 | apple -- 1 | banana -- 1 | orange -- 2 | grape -- 2 | peach ``` --- **总结与应用场景**: | 类型 | 输入行数 | 输出行数 | 输出列数 | 典型应用场景 | 类比 SQL 函数/操作 | | :--- | :------- | :------------- | :------- | :------------------------------------- | :------------------------- | | UDF | **1** | **1** (值) | 1 | 单行数据清洗、转换、计算 (e.g., 转小写, 字符串拼接, 复杂计算) | `LOWER()`, `CONCAT()`, `ABS()` | | UDAF | **多** | **1** (聚合值) | 1 | 分组聚合统计 (e.g., 平均值, 最大值, 自定义聚合如几何平均) | `SUM()`, `COUNT()`, `AVG()`, `MAX()` | | UDTF | **1** | **多** (表) | 多 | 行数据展开/爆炸 (e.g., 拆分字符串, 解析JSON/Array/Map, 生成序列) | `EXPLODE()`, `LATERAL VIEW json_tuple()` | 通过灵活使用 UDFUDAF UDTF,可以解决 Hive 内置函数无法处理的复杂业务逻辑,极大地增强了 Hive 的数据处理能力[^1][^2][^3][^4]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值