达梦数据库 JAVA 外部函数使用指南

3、注意点

五、实验步骤

1、开启参数

[root@rhel709:/root]# cat /dmdata/DAMENG2/dm.ini |grep ENABLE_EXTERNAL_CALL
ENABLE_EXTERNAL_CALL = 1 #Whether permit external call

直接修改文件可能不生效，建议使用 SP_SET_PARA_VALUE 设置。

SQL> SP_SET_PARA_VALUE(2,'ENABLE_EXTERNAL_CALL',1);
DMSQL 过程已成功完成
已用时间：9.553(毫秒). 执行号:1002.

2、重启数据库服务

[dmdba@rhel709 bin]$ ./DmServiceDM restart

3、生成并安装 service.key

[dmdba@rhel709 dmagent]$ ./start.sh INSTALL_SERVICE_KEY 999999
tip: if using the deployment feature, it is recommended to start dmagent with the '-d' parameter.
Agent-V7.6.1.34685-2025.03.26-DEV Key file: "/dm/dmdbms/tool/dmagent/service.key" generated.

4、agent.ini 配置

[dmdba@rhel709 dmagent]$ cat agent.ini |grep -E 'ap_enable|ap_port'
ap_enable = true #whether enable ap plugin
ap_port = 6363 #ap listen tcp/ip port, range[1~65535]
[dmdba@rhel709 dmagent]$ pwd
/dm/dmdbms/tool/dmagent

agent.ini 配置的 6363 端口需和 dm.ini 中的 EXTERNAL_JFUN_PORT 参数一致。

[dmdba@rhel709 dmagent]$ cat /dmdata/DAMENG2/dm.ini |grep EXTERNAL_JFUN_PORT
EXTERNAL_JFUN_PORT = 6363 #DmAgent port for external java fun.

5、启动 dmagent

[dmdba@rhel709 dmagent]$ ./start.sh -d agent.ini
Starting dmagent.....
dmagent(pid: 16039) started successfully.

6、源码

[dmdba@rhel709 DmJar]$ cat test.java
package com.test.package1;
public class test {
    public static int testAdd(int a, int b) {
        return a + b;
    }
    public static String testStr(String str) {
        return str + " hello";
    }
}

7、编译

[dmdba@rhel709 DmJar]$ javac -d . test.java

8、打 Jar 包

[dmdba@rhel709 DmJar]$ jar cvf test.jar com/test/package1/test.class
已添加清单
正在添加：com/test/package1/test.class(输入 = 526) (输出 = 323)(压缩了 38%)

9、拷贝 jar 包

cp /home/dmdba/DmJar/test.jar /dm/dmdbms/tool/dmagent/resources/ap/

一定要放到这个目录下，不然在执行时会提示如下报错：

SQL> select MY_chr('abc');
[-7094]:外部函数共享库加载失败，错误详情 [invalid jar path, jar should under resources/ap directory].
已用时间：2.153(毫秒). 执行号:0.

10、创建外部函数

这里建议大家设置相对路径，这样可以避免在集群模式下，多节点目录不一致导致找不到 JAR 包的问题。

CREATE OR REPLACE FUNCTION MY_INT(a int, b int) RETURN int EXTERNAL 'resources/ap/test.jar' "com.test.package1.test.testAdd" USING java;
CREATE OR REPLACE FUNCTION MY_chr(s varchar) RETURN varchar EXTERNAL 'resources/ap/test.jar' "com.test.package1.test.testStr" USING java;

11、验证

SQL> select MY_INT(1,2);
行号 MY_INT(1,2)
---------- -----------
1 3
已用时间：0.942(毫秒). 执行号:4505.

SQL> select MY_chr('abc');
行号 MY_CHR('abc')
---------- -------------
1 abc hello
已用时间：1.080(毫秒). 执行号:4506.