如何在 Hive 中注册和管理 UDF？
# Hive 注册 & 管理 UDF 最全实战指南（企业级标准）
我给你整理**最清晰、最常用、不踩坑**的全套流程：**临时UDF、永久UDF、删除UDF、查看UDF、重载UDF、权限问题**，全部一次性讲透。
---
# 一、UDF 三种类型（先分清）
1. ** Temporary UDF（临时函数）**
只在当前会话有效，关闭 hive 客户端就消失
→ 测试用
2. ** Permanent Function（永久函数）**
注册到 Hive 元数据，所有人、所有会话都能用
→ **生产环境标准用法**
3. ** Permanent Function with Jar on HDFS**
企业最标准、最稳定、必须用
→ **JAR 放在 HDFS，所有人都能访问**
---
# 二、最常用：注册 **临时 UDF**（测试用）
## 1. 上传 jar（本地路径）
```sql
add jar /home/hive/udf/myudf.jar;
```
## 2. 创建临时函数
```sql
create temporary function mask_phone as 'com.xxx.MaskPhone';
```
## 3. 直接使用
```sql
select mask_phone('13812345678');
```
---
# 三、企业标准：注册 **永久 UDF**（必须会）
## 步骤 1：把 JAR 传到 HDFS（关键）
```bash
hdfs dfs -put myudf.jar /user/hive/udf/
```
## 步骤 2：注册永久函数
```sql
CREATE FUNCTION mask_phone AS 'com.xxx.MaskPhone'
USING JAR 'hdfs:///user/hive/udf/myudf.jar';
```
✅ **优点：**
- 永久生效
- 所有客户端可用
- 重启 Hive 也在
- 跨会话、跨用户
---
# 四、注册到指定数据库（生产常用）
```sql
CREATE FUNCTION db_name.mask_phone AS 'com.xxx.MaskPhone'
USING JAR 'hdfs:///user/hive/udf/myudf.jar';
```
使用时：
```sql
select db_name.mask_phone(phone);
```
---
# 五、查看所有 UDF（必用）
## 1. 查看所有函数
```sql
show functions;
```
## 2. 查看某个 UDF 信息
```sql
desc function extended mask_phone;
```
会显示：
- 类路径
- JAR 路径
- 函数类型
---
# 六、删除 UDF
## 1. 删除永久函数
```sql
DROP FUNCTION IF EXISTS mask_phone;
```
## 2. 删除指定库的 UDF
```sql
DROP FUNCTION IF EXISTS db_name.mask_phone;
```
## 3. 删除临时函数
```sql
DROP TEMPORARY FUNCTION IF EXISTS mask_phone;
```
---
# 七、更新 / 重载 UDF（代码改了怎么更新？）
## 方法 1：删除重建
```sql
DROP FUNCTION mask_phone;
CREATE FUNCTION mask_phone AS 'com.xxx.MaskPhone'
USING JAR 'hdfs:///user/hive/udf/myudf.jar';
```
## 方法 2：覆盖 HDFS 上的 JAR，重启 Hive Server2
```bash
hdfs dfs -put -f myudf.jar /user/hive/udf/
```
然后重启 hive-server2 生效。
---
# 八、UDF 权限问题（90% 的人踩过坑）
## 报错：
- Permission denied
- Class Not Found
- Unable to read jar
## 解决：
```bash
hdfs dfs -chmod 755 /user/hive/udf/myudf.jar
hdfs dfs -chown hive:hive /user/hive/udf/myudf.jar
```
---
# 九、企业级 UDF 注册模板（直接复制）
## 1. 上传到 HDFS
```bash
hdfs dfs -mkdir -p /user/hive/udf
hdfs dfs -put myudf.jar /user/hive/udf/
hdfs dfs -chmod 755 /user/hive/udf/myudf.jar
```
## 2. 注册永久函数
```sql
CREATE FUNCTION default.mask_phone AS 'com.company.udf.MaskPhone'
USING JAR 'hdfs:///user/hive/udf/myudf.jar';
```
## 3. 测试
```sql
SELECT mask_phone('13900001111');
```
---
# 十、最常用命令汇总（背会）
```sql
-- 注册临时
add jar /path/xxx.jar;
create temporary function 函数名 as '全类名';
-- 注册永久
create function 函数名 as '全类名' using jar 'hdfs://path/xxx.jar';
-- 查看
show functions;
desc function extended 函数名;
-- 删除
drop function 函数名;
```
