达梦-外部函数-JAVA版

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

简介

java外部函数是指使用java语言编写并在数据库外编译生成的jar包用户可通过DMSQL程序调用的函数。java外部函数执行是通过代理服务进行即需要先启动dmagent服务，同时需要修改ENABLE_EXTERNAL_CALL参数是否启动外部函数功能。

一、启动代理服务

数据库在调用外部函数前需要启动代理服务

cd /home/dmdba/dmdbms/tool/dmagent
./start.sh -d agent.ini
# 启动成功
[root@sim-dm dmagent]# ./start.sh -d agent.ini 
Starting dmagent.....
dmagent(pid: 5928) started successfully.
[root@sim-dm dmagent]# 

二、开启外部函数

代理服务启动后还不能调用外部函数，需要将数据库参数ENABLE_EXTERNAL_CALL设置为1

[dmdba@sim-dm ~]$ disql sysdba/'"PWD"'@localhost:5136
服务器[localhost:5136]:处于普通打开状态
登录使用时间 : 9.003(ms)
disql V8
SQL> 
SQL> CALL SP_SET_PARA_VALUE(2,'ENABLE_EXTERNAL_CALL',1);
DMSQL 过程已成功完成
已用时间: 10.023(毫秒). 执行号:2400.
SQL> 

三、编写外部函数

eclipse创建一个project项目创建成功后创建一个package命名为com.dm.optnum在包中创建一个类strToUpper导出类为jar包并上传到数据库安装目录下的bin目录。

package com.dm.optnum;

public class strToUpper {
	public static String UPPER(String str) {
		String temStr = "";
		temStr = str.toUpperCase();
		return temStr;
	}
}

四、创建外部函数

登录数据库创建外部函数，注意外部jar路径和类名称

CREATE OR REPLACE FUNCTION CUST_UPPER(str varchar) 
RETURN varchar
EXTERNAL '/home/dmdba/dmdbms/bin/toUpper.jar' "com.dm.optnum.strToUpper.strToUpper" USING java;

五、使用外部函数

外部函数创建成功，可使用disql登录数据库或者使用

[dmdba@sim-dm ~]$ disql sysdba/'"PWD"'@localhost:5136
服务器[localhost:5136]:处于普通打开状态
登录使用时间 : 7.629(ms)
disql V8
SQL> 
SQL> select CUST_UPPER('richaes') from dual;

行号     CUST_UPPER('richaes')
---------- ---------------------
1          RICHAES

已用时间: 8.914(毫秒). 执行号:2500.
SQL> 

总结

以上就是今天要讲的内容，本文仅仅简单介绍了DM8如何调用外部java函数的使用，更多内容请登录https://eco.dameng.com