基于湖库一体架构,统一管理结构化、半结构化与非结构化等多模态数据,一个系统承载事务处理、实时分析与 AI 工作负载。
ob_java_connector_path
更新时间:2026-09-21 16:07:43
说明
该配置项从 V4.3.5 BP1 版本开始引入。
功能描述
ob_java_connector_path 用于设置 JNI(Java Native Interface)为访问和执行外部表(如 HDFS 外表)所需的 Connector Jar 包的根路径。该路径将与 ob_java_home 配置项指定的路径拼接,共同构成 JVM 的类加载路径。
功能适用性
该配置项仅适用于 OceanBase 数据库 MySQL 模式。
权限要求
- 查询配置项
sys租户和所有用户租户均可以使用SHOW PARAMETERS语句或视图GV$OB_PARAMETERS查询该配置项。 - 修改配置项 仅
sys租户可以修改该配置项,用户租户不能修改该配置项。
属性说明
| 属性 | 描述 |
|---|---|
| 参数类型 | String |
| 默认值 | "" (空字符串) |
| 是否可修改 | 是,支持通过 ALTER SYSTEM SET 语句修改。 |
| 是否重启 OBServer 节点生效 | 否,设置后立即生效。 |
使用说明
- 该配置项是启用 OceanBase 数据库 Java 环境以支持 HDFS 外表等 JNI 功能的一部分。通常需要与
ob_enable_java_env、ob_java_home和ob_java_opts配置项配合使用。 - 初始化耗时:首次初始化 Java 环境可能需要较长时间,可能导致首次查询相关外部表时超时。建议适当调整查询超时时间,后续查询将不会再次初始化。
- 部署一致性:在多机部署环境下,需要确保所有 OBServer 节点上配置的路径指向相同且存在的目录,以保证功能正常。
- 路径要求:配置的路径应指向存放 Connector Jar 包的目录。实际交付的包目录下若包含
current、hadoop、版本目录(如vX.X.X,实际版本号随 OceanBase 版本而定)等条目,建议将ob_java_connector_path设置为current目录的路径。 - 环境依赖:使用此功能前,需要在服务器上正确安装 Java 环境(如 OpenJDK 8)并配置好必要的环境变量(如
LD_LIBRARY_PATH指向libhdfs.so所在的目录)。
配置示例
设置 Java Connector 的路径为 /home/admin/jni_packages/current。
obclient> ALTER SYSTEM SET ob_java_connector_path = '/home/admin/jni_packages/current';
相关文档
- 启用 Java 环境配置项:ob_enable_java_env
- 设置 Java 安装路径配置项:ob_java_home
- 设置 JVM 启动参数配置项:ob_java_opts