ext_plugin_config

ext_plugin_config 用于声明集群需要加载的外表 C++ 插件及其动态库位置。

功能描述

配置值为 JSON 数组，每个元素为一个对象，包含必填的 name 字段和可选的 path 字段。name 表示插件名称（如 paimon），path 指定插件动态库 .so 文件的绝对路径；未指定 path 时，系统按 lib_ob_<name>.so 的命名约定在 LD_LIBRARY_PATH 中解析（系统会先将 _ob_additional_lib_path 并入搜索路径）。每台 OBServer 都必须能访问到对应的 .so 文件。

该配置采用懒加载机制，进程生命周期内仅读取一次。首次进行外表识别时，系统解析 JSON 并通过 dlopen 加载全部条目。运行期间修改配置仅更新持久化值，已加载的插件集合不会变化，必须重启 OBServer 才能生效。

属性说明

使用说明

1. 默认配置已声明加载 paimon 插件，将 lib_ob_paimon.so 及其依赖库放到每台 OBServer 的 LD_LIBRARY_PATH 下即可。若 .so 文件不在默认搜索路径中，使用 path 字段指定绝对路径。
2. 修改配置后必须重启全部 OBServer，各节点的配置与 .so 布局需保持一致，否则会出现部分节点报 plugin not loaded 的情况。

配置示例

-- 查看当前值
SHOW PARAMETERS LIKE 'ext_plugin_config';

-- 默认配置：按 LD_LIBRARY_PATH 查找 lib_ob_paimon.so
ALTER SYSTEM SET ext_plugin_config = '[{"name":"paimon"}]';

-- 显式指定动态库的绝对路径
ALTER SYSTEM SET ext_plugin_config = '[{"name":"paimon","path":"/home/admin/oceanbase/lib/lib_ob_paimon.so"}]';

-- 同时声明多个插件
ALTER SYSTEM SET ext_plugin_config = '[{"name":"paimon"},{"name":"odps","path":"/abs/lib_ob_odps.so"}]';

-- 关闭全部外表插件
ALTER SYSTEM SET ext_plugin_config = '[]';