达梦数据库-学习-45-JAVA外部函数

目录

一、环境信息

二、说点什么

三、C外部函数链接

四、介绍

1、语法树

2、参数

3、注意点

五、实验步骤

1、开启参数

2、重启数据库服务

3、生成并安装 service.key

4、agent.ini配置

5、启动 dmagent

6、源码

7、编译

8、打Jar包

9、拷贝jar包

10、创建外部函数

11、验证

一、环境信息

二、说点什么

最近工作中有客户经常用到JAVA外部函数，用C外部函数的少之又少，再写一篇记录一下，学无止境。

三、C外部函数链接

C外部函数链接可以参考一下之前的博客。

四、介绍

1、语法树

CREATE [OR REPLACE] FUNCTION [IF NOT EXISTS] [<模式名>.]<函数名>[(<外部函数参数列表>)] RETURN <返回值类型> EXTERNAL '<jar 包路径>' [AND] <引用的 JAVA 函数名>[(<JAVA 函数参数列表>)] USING JAVA; <外部函数参数列表>：：=<外部函数参数声明> {,<外部函数参数声明>} <外部函数参数声明>：：=<外部函数参数名> [<外部函数参数模式>]<外部函数参数类型> <JAVA 函数参数列表>：：=<JAVA 函数参数声明> {,<JAVA 函数参数声明>} <JAVA 函数参数声明>：：=<JAVA 函数参数类型> 

2、参数

3、注意点

五、实验步骤

1、开启参数

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

上面这种改文件的，重启不生效，有些奇怪。

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.