RDS for Db2 的外部存储过程

您可以创建外部例程，并将其作为外部存储过程注册到您的 RDS for Db2 数据库。目前，RDS for Db2 只支持对外部存储过程使用基于 Java 的例程。

基于 Java 的外部存储过程

基于 Java 的外部存储过程是作为外部存储过程注册到 RDS for Db2 数据库的外部 Java 例程。

基于 Java 的外部存储过程的限制

在开发外部例程之前，请考虑以下限制和局限性。

要创建外部例程，请务必使用 Db2 提供的 Java 开发工具包（JDK）。有关更多信息，请参阅 Db2 数据库产品的 Java 软件支持。

您的 Java 程序只能在 /tmp 目录中创建文件，而 Amazon RDS 不支持对这些文件启用可执行文件或设置用户 ID（SUID）权限。您的 Java 程序也无法使用套接字系统调用或以下系统调用：

有关 Db2 的外部例程的其它限制，请参阅 IBM Db2 文档中的外部例程的限制。

配置基于 Java 的外部存储过程

要配置外部存储过程，请使用外部例程创建一个 .jar 文件，将其安装在 RDS for Db2 数据库上，然后将它注册为外部存储过程。

步骤 1：启用外部存储过程

要启用外部存储过程，请在与数据库实例关联的自定义参数组中，将参数 db2_alternate_authz_behaviour 设置为以下值之一：

有关此设置的更多信息，请参阅 IBM Db2 文档中的 GRANT（数据库权限）语句。

您可以使用 Amazon Web Services Management Console、Amazon CLI 或 Amazon RDS API 创建和修改自定义参数组。

步骤 2：使用外部例程安装 .jar 文件

创建 Java 例程后，创建 .jar 文件，然后运行 db2 "call sqlj.install_jar('file:file_path',jar_ID)" 来将它安装到 RDS for Db2 数据库上。

以下示例展示了如何创建 Java 例程并将其安装到 RDS for Db2 数据库上。该示例包括可用于测试该过程的简单例程的示例代码。本示例作出以下假设：

如果您想使用以下示例代码尝试该过程，请复制它并将它保存到名为 MYJAVASP.java 的文件中。

import java.sql.*;
public class MYJAVASP
{
public static void my_JAVASP (String inparam) throws SQLException, Exception
{
try
{
// Obtain the calling context's connection details.
Connection myConn = DriverManager.getConnection("jdbc:default:connection");
String myQuery = "INSERT INTO TEST.TEST_TABLE VALUES (?, CURRENT DATE)";
PreparedStatement myStmt = myConn.prepareStatement(myQuery);
myStmt.setString(1, inparam);
myStmt.executeUpdate();
}
catch (SQLException sql_ex)
{
throw sql_ex;
}
catch (Exception ex)
{
throw ex;
}
}

以下命令编译 Java 例程。

~/sqllib/java/jdk64/bin/javac MYJAVASP.java

以下命令创建 .jar 文件。

~/sqllib/java/jdk64/bin/jar cvf MYJAVASP.jar MYJAVASP.class

以下命令连接到名为 MY_DB2_DATABASE 的数据库并安装 .jar 文件。

db2 "connect to MY_DB2_DATABASE user master_username using master_password" 

db2 "call sqlj.install_jar('file:/tmp/MYJAVASP.jar','MYJAVASP')"
db2 "call sqlj.refresh_classes()"

步骤 3：注册外部存储过程

在 RDS for Db2 数据库上安装 .jar 文件后，通过运行 db2 CREATE PROCEDURE 或 db2 REPLACE PROCEDURE 命令将其注册为存储过程。

以下示例说明如何连接到数据库，并将在上一步中创建的 Java 例程注册为存储过程。

db2 "connect to MY_DB2_DATABASE user master_username using master_password"

create procedure TESTSP.MYJAVASP (in input char(6))
specific myjavasp
dynamic result sets 0
deterministic
language java
parameter style java
no dbinfo
fenced
threadsafe
modifies sql data
program type sub
external name 'MYJAVASP!my_JAVASP';

步骤 4：验证外部存储过程

使用以下步骤来测试在上一步中注册的示例外部存储过程。