1、LOAD MODULE 是干什么的？
一句话总结：
LOAD MODULE用来把某个模块加载进会话，让 Flink 能在后续 SQL 解析/执行时使用该模块提供的能力（例如 Hive 模块提供的 Hive 系列函数、兼容能力等）。
你可以把它理解为“给 SQL 引擎装插件”。
2、Java 里怎么跑？executeSql 返回 OK
在 Java（TableEnvironment/StreamTableEnvironment）里直接执行：
tEnv.executeSql("LOAD MODULE hive WITH ('hive-version' = '3.1.3')");- 成功：返回
OK - 失败：抛异常（常见是模块发现失败、参数不对、依赖缺失等）
加载完用SHOW MODULES看一下是否生效：
tEnv.executeSql("SHOW MODULES").print();你会看到默认的core+ 新加载的hive：
+-------------+ | module name | +-------------+ | core | | hive | +-------------+3、语法与关键点：module_name 大小写敏感、靠“发现”机制找到模块
语法：
LOADMODULE module_name[WITH('key1'='val1','key2'='val2',...)]这里最关键有两点：
3.1 module_name 是“发现用的类型名”
module_name必须与 module factory 中定义的模块类型一致- 大小写敏感
- 它会用于“模块发现（module discovery）”，也就是 Flink 根据这个名字去找到对应模块实现并实例化
这意味着：你写错一个字母大小写，都可能导致“找不到模块”。
3.2 WITH 参数会传给 discovery service 来实例化模块
WITH (...)是一个 key-value map- 会作为参数传给 discovery service，用于实例化该模块
- 并且明确：除了
type这个 key 不能放，其它 key-value 可以作为配置传入
示例里：
LOADMODULE hiveWITH('hive-version'='3.1.3')就是在告诉 hive 模块：你要按 3.1.3 这个 Hive 版本来做兼容加载/初始化。
4、LOAD、USE、SHOW：模块管理“三连击”最佳实践
在真实项目中，模块通常要配合另外两类语句一起用，形成闭环：
4.1 LOAD：加载模块（让它出现在“已加载模块列表”里）
LOADMODULE hiveWITH('hive-version'='3.1.3');4.2 SHOW FULL MODULES：确认“是否加载 + 是否启用（used）+ 顺序”
SHOWFULLMODULES;你会看到模块是否 used=true/false（启用状态）以及解析顺序信息。
4.3 USE MODULES：决定“启用哪些模块 + 解析顺序”
USEMODULES hive,core;很多人只 LOAD，不 USE；结果函数解析还是走 core，或者执行
USE MODULES hive后导致 core 被禁用，引发“某些函数突然不可用”。
所以建议：LOAD 之后用 SHOW FULL MODULES 看状态，再用 USE MODULES 固化顺序。
5、常见坑与排查思路
坑 1：LOAD 成功了，但函数还是解析不到
原因常见是：模块加载了但没按预期启用/排序。
排查：
SHOWFULLMODULES;如果 hive 是 used=false，或者解析顺序不对，就用：
USEMODULES hive,core;坑 2：module_name 写错（大小写敏感）
表现：直接异常，提示找不到模块/无法发现模块。
处理：确认 module_name 与 factory 定义一致，例如hive就写hive。
坑 3：WITH 参数不正确或缺失关键配置
比如 hive 模块通常需要hive-version这种关键参数。
处理：按模块要求补齐参数（你给的示例就是正确姿势）。
6、总结
LOAD MODULE：用于加载内置或自定义模块- Java 中通过
executeSql()执行，成功返回OK module_name大小写敏感，并用于模块发现WITH (...)配置会传给 discovery service 用于实例化模块（排除 key=type）- 最佳实践：LOAD → SHOW FULL MODULES → USE MODULES 固化启用与顺序
