要部署包含 Java™ 例程类文件的 JAR 文件,您必须将 JAR 文件安装至 DB2® 数据库服务器。要从 IBM® Data Server Client 完成此操作,请使用会在 DB2 数据库服务器上安装、替换或除去 JAR 文件的系统定义例程。
要在 DB2 实例中安装、替换或除去 JAR 文件,请使用随 DB2 提供的存储过程:
- 安装
-
sqlj.install_jar( jar-url, jar-id )
注: sqlj.install_jar 调用者的授权标识具有的特权必须至少包括下列其中一项:
- 对隐式或显式指定的模式的 CREATEIN 特权
- DBADM 权限
- 替换
-
sqlj.replace_jar( jar-url, jar-id )
- 除去
-
sqlj.remove_jar( jar-id )
- jar-url:包含要安装或替换的 JAR 文件的 URL。唯一支持的 URL 方案是“file:”。
- jar-id:唯一的字符串标识,长度可达 128 字节。它在数据库中指定与 jar-url 文件相关联的 JAR 标识。
注: 从应用程序调用时,存储过程 sqlj.install_jar 和 sqlj.remove_jar 具有其他参数。它是一个整数值,规定在指定的 JAR 文件中使用部署描述符。目前,不支持部署参数,且会拒绝任何指定非零值的调用。
下列是一系列指示如何使用前面的 JAR 文件管理存储过程的示例。
要在数据库实例中将位于路径
/home/bob/bobsjar.jar 的 JAR 注册为 MYJAR,请执行下列操作:
CALL sqlj.install_jar( 'file:/home/bob/bobsjar.jar', 'MYJAR' )
使用
bobsjar.jar 文件的后续 SQL 命令会使用名称
MYJAR 来引用该文件。
要使用不同的 JAR(包含某些已更新的类)来替换 MYJAR,请执行下列操作:
CALL sqlj.replace_jar( 'file:/home/bob/bobsnewjar.jar', 'MYJAR' )
要从数据库目录中除去 MYJAR,请执行下列操作:
CALL sqlj.remove_jar( 'MYJAR' )
注: 在 Windows 操作系统上,DB2 会将 JAR 文件存储至 DB2INSTPROF 实例特定注册表设置所指定的路径。要使 JAR 文件成为实例的特有 JAR 文件,您必须为该实例的 DB2INSTPROF 指定唯一值。